feat(themes): new color theme engine & packs 🎨

- **New Hybrid Engine:** Fully data-driven theming using YAML (`modules/blox-tailwind/data/themes/`). Supports:
  - **Palette Mode:** `primary: "indigo"` loads exact Tailwind 50-950 scales (OKLCH) for perfect utility matching.
  - **Hex Mode:** `primary: "#brand"` auto-generates accessible 50-950 tint/shade scales.
  - **Semantic Overrides:** `ui.header.background` accepts gradients, transparency, and images.
  - **Neutral Mapping:** Themes can retarget the gray scale (e.g. `neutral: "stone"` warms up the entire UI).

- **New Theme Packs:**
  - `default` (Blue/Sky + Dark)
  - `contrast` (High Contrast Light)
  - `latte` (Warm Coffee/Stone)
  - `dracula` (Dark Purple/Pink)
  - `americano` (Dark Espresso)
  - `marine` (Deep Ocean/Teal)
  - `retro` (Vintage Paper)
  - `synthwave` (Neon/Purple)
  - `cupcake` (Light Pink/Fuchsia)

- **Architecture:**
  - Standardized on `appearance.theme.light` / `appearance.theme.dark` config.
  - Legacy `appearance.color` remains as a primary color override.

This overhaul enables colored backgrounds/navbars, enables mix-and-match themes, and future-proofs the styling system for Tailwind v4.

modules/blox-tailwind/assets/css/blox/navbar.css

@@ -5,7 +5,9 @@
 }
 
 .navbar-brand {
-  @apply text-black dark:text-white text-xl font-semibold;
+  /* @apply text-black dark:text-white text-xl font-semibold; */
+  color: var(--color-header-fg);
+  @apply text-xl font-semibold;
 }
 
 .navbar-brand svg {
@@ -40,7 +42,9 @@ input#nav-toggle:checked ~ #nav-menu {
 }
 
 #site-header.header {
-  @apply bg-white dark:bg-zinc-800 py-3 shadow;
+  background-color: var(--color-header-bg);
+  color: var(--color-header-fg);
+  @apply py-3 shadow;
 }
 
 /* navbar items */
@@ -50,7 +54,9 @@ input#nav-toggle:checked ~ #nav-menu {
 }
 
 .nav-link {
-  @apply dark:text-white block p-3 font-semibold transition lg:px-2 lg:py-3;
+  /* @apply dark:text-white block p-3 font-semibold transition lg:px-2 lg:py-3; */
+  color: var(--color-header-fg);
+  @apply block p-3 font-semibold transition lg:px-2 lg:py-3;
 }
 
 .nav-link:hover {

modules/blox-tailwind/assets/css/config/theme.css

@@ -305,6 +305,9 @@
   --color-primary-900: rgb(var(--hb-primary-900-rgb, 30 58 138));
   --color-primary-950: rgb(var(--hb-primary-950-rgb, 23 37 84));
 
+  /* Semantic UI Colors - Defined in theme_generator.html */
+  /* Do not redeclare them here to avoid circular references */
+
   --color-secondary-50: rgb(var(--hb-secondary-50-rgb, 236 254 255));
   --color-secondary-100: rgb(var(--hb-secondary-100-rgb, 207 250 254));
   --color-secondary-200: rgb(var(--hb-secondary-200-rgb, 165 243 252));

modules/blox-tailwind/data/themes/americano.yaml

@@ -0,0 +1,29 @@
+name: "americano"
+type: "dark"
+
+dark:
+  colors:
+    primary: "#d49255" # Warm Orange/Brown (approximated from oklch(71.996% 0.123 62.756))
+    secondary: "#395260" # Cool Slate Blue (approximated from oklch(34.465% 0.029 199.194))
+    neutral: "#2b262b" # Deep Purple/Black (approximated from oklch(16.51% 0.015 326.261))
+  ui:
+    background: "#2b262b" # Deep Espresso
+    foreground: "#e0cab6" # Crema (approximated from oklch(72.354% 0.092 79.129))
+    header:
+      background: "#2b262b"
+      foreground: "#e0cab6"
+    footer:
+      background: "#231f23" # Darker roast
+      foreground: "#9ca3af"
+
+light:
+  # A light "Cortado" pairing for day mode if needed
+  colors:
+    primary: "#d49255"
+    secondary: "#395260"
+  ui:
+    background: "#f5f5f4"
+    foreground: "#292524"
+    header:
+      background: "#ffffff"
+      foreground: "#292524"

modules/blox-tailwind/data/themes/contrast.yaml

@@ -0,0 +1,30 @@
+name: "contrast"
+type: "dual"
+
+light:
+  colors:
+    primary: "indigo"
+    secondary: "blue"
+  ui:
+    background: "#ffffff"
+    foreground: "#111827"
+    header:
+      foreground: "#ffffff"
+      background: "#0f172a"
+    footer:
+      background: "#f3f4f6"
+      foreground: "#0f172a"
+
+dark:
+  colors:
+    primary: "blue"
+    secondary: "teal"
+  ui:
+    background: "#0f172a"
+    foreground: "#f8fafc"
+    header:
+      foreground: "#0f172a"
+      background: "#f8fafc"
+    footer:
+      background: "#111827"
+      foreground: "#e5e7eb"

modules/blox-tailwind/data/themes/cupcake.yaml

@@ -0,0 +1,29 @@
+name: "cupcake"
+type: "light"
+
+light:
+  colors:
+    primary: "#e779c1" # Frosting Pink (approximated from oklch(65% 0.241 354.308))
+    secondary: "#d946ef" # Deep Purple/Fuchsia (approximated from oklch(62% 0.265 303.9))
+    neutral: "#5c4033" # Chocolate/Dark Brown (approximated from oklch(40% 0.153 2.432))
+  ui:
+    background: "#faf7f5" # Vanilla/Sugar (approximated from oklch(97% 0.014 343.198))
+    foreground: "#7d1f39" # Berry Jam (approximated from oklch(52% 0.223 3.958))
+    header:
+      background: "#ffffff"
+      foreground: "#7d1f39"
+    footer:
+      background: "#f3e8e8" # Light Pink Foam
+      foreground: "#7d1f39"
+
+dark:
+  # A darker "Red Velvet" variant
+  colors:
+    primary: "#e779c1"
+    secondary: "#d946ef"
+  ui:
+    background: "#2a1b20" # Dark Chocolate
+    foreground: "#f8e7e7" # Pale Pink Cream
+    header:
+      background: "#1f1216"
+      foreground: "#f8e7e7"

modules/blox-tailwind/data/themes/default.yaml

@@ -0,0 +1,30 @@
+name: "default"
+type: "dual"
+
+light:
+  colors:
+    primary: "indigo"
+    secondary: "blue"
+  ui:
+    background: "#ffffff"
+    foreground: "#111827"
+    header:
+      background: "#ffffff"
+      foreground: "#0f172a"
+    footer:
+      background: "#f3f4f6"
+      foreground: "#0f172a"
+
+dark:
+  colors:
+    primary: "blue"
+    secondary: "teal"
+  ui:
+    background: "#0f172a"
+    foreground: "#f8fafc"
+    header:
+      background: "#0f172a"
+      foreground: "#f8fafc"
+    footer:
+      background: "#111827"
+      foreground: "#e5e7eb"

modules/blox-tailwind/data/themes/dracula.yaml

@@ -0,0 +1,29 @@
+name: "dracula"
+type: "dark"
+
+dark:
+  colors:
+    primary: "#ff79c6" # Dracula Pink
+    secondary: "#bd93f9" # Dracula Purple
+    neutral: "#6272a4" # Dracula Comment (Blue-Gray)
+  ui:
+    background: "#282a36" # Dracula Background
+    foreground: "#f8f8f2" # Dracula Foreground
+    header:
+      background: "#282a36"
+      foreground: "#f8f8f2"
+    footer:
+      background: "#21222c" # Slightly darker selection color
+      foreground: "#f8f8f2"
+
+# Optional light variant (Dracula usually doesn't have one, but we can provide a high contrast or soft variant)
+light:
+  colors:
+    primary: "#ff79c6"
+    secondary: "#bd93f9"
+  ui:
+    background: "#f8f8f2"
+    foreground: "#282a36"
+    header:
+      background: "#ffffff"
+      foreground: "#282a36"

modules/blox-tailwind/data/themes/latte.yaml

@@ -0,0 +1,32 @@
+name: "latte"
+type: "light"
+
+light:
+  colors:
+    primary: "#3b2313" # Mocha/Coffee bean
+    secondary: "#d97706" # Caramel/Amber
+    neutral: "#78716c" # Stone
+  ui:
+    background: "#fffaf5" # Warm cream/milk foam
+    foreground: "#3b2313" # Espresso text
+    header:
+      background: "rgba(255, 250, 245, 0.85)" # Frothy semi-transparent
+      foreground: "#3b2313"
+    footer:
+      background: "#f5efe9" # Slightly darker latte foam
+      foreground: "#5c4033"
+
+dark:
+  # A rich "Espresso Martini" dark mode partner
+  colors:
+    primary: "#d97706" # Caramel highlights
+    secondary: "#f59e0b" # Gold foam
+  ui:
+    background: "#1c1917" # Dark roasted bean
+    foreground: "#e7e5e4" # Steam
+    header:
+      background: "#1c1917"
+      foreground: "#e7e5e4"
+    footer:
+      background: "#292524"
+      foreground: "#a8a29e"

modules/blox-tailwind/data/themes/marine.yaml

@@ -0,0 +1,29 @@
+name: "marine"
+type: "dark"
+
+dark:
+  colors:
+    primary: "#2dd4bf" # Teal/Cyan (approximated from oklch(85.661% 0.144 198.645))
+    secondary: "#a855f7" # Purple (approximated from oklch(60.682% 0.108 309.782))
+    neutral: "#1e3a8a" # Deep Blue (approximated from oklch(27% 0.146 265.522))
+  ui:
+    background: "#1e3a8a" # Deep Ocean Blue (from oklch(37% 0.146 265.522))
+    foreground: "#e0f2fe" # Light Sky (approximated from oklch(90% 0.058 230.902))
+    header:
+      background: "#1e3a8a"
+      foreground: "#e0f2fe"
+    footer:
+      background: "#172554" # Darker depth
+      foreground: "#93c5fd"
+
+light:
+  # A "Beach Day" pairing
+  colors:
+    primary: "#2dd4bf"
+    secondary: "#a855f7"
+  ui:
+    background: "#f0f9ff"
+    foreground: "#0c4a6e"
+    header:
+      background: "#ffffff"
+      foreground: "#0c4a6e"

modules/blox-tailwind/data/themes/retro.yaml

@@ -0,0 +1,29 @@
+name: "retro"
+type: "light"
+
+light:
+  colors:
+    primary: "#e38c89" # Desaturated Red/Pink (approximated from oklch(80% 0.114 19.571))
+    secondary: "#b4e9d6" # Mint Green (approximated from oklch(92% 0.084 155.995))
+    neutral: "#79726b" # Warm Stone (approximated from oklch(44% 0.011 73.639))
+  ui:
+    background: "#ebe6d9" # Vintage Paper / Beige (approximated from oklch(91.637% 0.034 90.515))
+    foreground: "#7d5e3c" # Sepia/Brown (approximated from oklch(41% 0.112 45.904))
+    header:
+      background: "#e3dbcd" # Slightly darker paper
+      foreground: "#7d5e3c"
+    footer:
+      background: "#dcd3c3"
+      foreground: "#5c4033"
+
+dark:
+  # A dark "Polaroid" variant
+  colors:
+    primary: "#e38c89"
+    secondary: "#b4e9d6"
+  ui:
+    background: "#292524" # Dark Stone
+    foreground: "#e7e5e4" # Warm Gray
+    header:
+      background: "#1c1917"
+      foreground: "#e7e5e4"

modules/blox-tailwind/data/themes/synthwave.yaml

@@ -0,0 +1,29 @@
+name: "synthwave"
+type: "dark"
+
+dark:
+  colors:
+    primary: "#e779c1" # Neon Pink (approx oklch(71% 0.202 349.761))
+    secondary: "#58c7f3" # Cyan (approx oklch(82% 0.111 230.318))
+    neutral: "#2a2e37" # Dark Blue-Gray (approx oklch(45% 0.24 277.023) adjusted for readability)
+  ui:
+    background: "#1a103d" # Deep Purple (approx oklch(15% 0.09 281.288))
+    foreground: "#f9f7fd" # Light Lavender (approx oklch(78% 0.115 274.713))
+    header:
+      background: "rgba(26, 16, 61, 0.9)" # Deep Purple
+      foreground: "#f9f7fd"
+    footer:
+      background: "#110a28" # Darker Deep Purple
+      foreground: "#b8b2cc"
+
+light:
+  # Synthwave usually doesn't have a light mode, providing a high contrast fallback
+  colors:
+    primary: "#e779c1"
+    secondary: "#58c7f3"
+  ui:
+    background: "#f9f7fd"
+    foreground: "#1a103d"
+    header:
+      background: "#ffffff"
+      foreground: "#1a103d"

modules/blox-tailwind/layouts/_partials/components/headers/navbar-simple.html

@@ -9,7 +9,7 @@
   <div class="flex w-full flex-wrap items-center justify-between px-3">
     <!-- Hamburger button for mobile view -->
     <button
-      class="block border-0 bg-transparent px-2 text-neutral-500 hover:no-underline hover:shadow-none focus:no-underline focus:shadow-none focus:outline-none focus:ring-0 dark:text-neutral-200 lg:hidden"
+      class="block border-0 bg-transparent px-2 text-[var(--color-header-fg)] hover:no-underline hover:shadow-none focus:no-underline focus:shadow-none focus:outline-none focus:ring-0 lg:hidden"
       type="button"
       data-te-collapse-init
       data-te-target="#collapse-main-navbar"
@@ -51,8 +51,8 @@
           class="my-4 pl-2 lg:my-0 lg:pl-2 lg:pr-1"
           data-te-nav-item-ref>
           <a
-            class="lg:px-2 text-gray-600 hover:text-gray-800 dark:text-gray-400 dark:hover:text-gray-200
-            [&.active]:font-bold [&.active]:text-black/90 dark:[&.active]:text-white {{ $activeClass }}"
+            class="lg:px-2 text-[var(--color-header-fg)] hover:text-primary-500
+            [&.active]:font-bold [&.active]:text-primary-500 {{ $activeClass }}"
             aria-current="page"
             href="{{ .URL | relLangURL }}"
             data-te-nav-link-ref
@@ -63,8 +63,8 @@
         {{ if $show_search }}
         <li class="my-4 pl-2 lg:my-0 lg:pl-2 lg:pr-1">
           <a
-            class="lg:px-2 text-gray-600 hover:text-gray-800 dark:text-gray-400 dark:hover:text-gray-200
-            [&.active]:font-bold [&.active]:text-black/90 dark:[&.active]:text-white"
+            class="lg:px-2 text-[var(--color-header-fg)] hover:text-primary-500
+            [&.active]:font-bold [&.active]:text-primary-500"
             aria-current="page"
             href="#"
             id="search-toggle"
@@ -74,8 +74,8 @@
         {{ end }}
         {{ $show_theme_chooser := site.Params.header.navbar.show_theme_chooser | default true }}
         {{ if $show_theme_chooser }}
-        <li class="lg:px-2 text-gray-600 hover:text-gray-800 dark:text-gray-400 dark:hover:text-gray-200
-            [&.active]:font-bold [&.active]:text-black/90 dark:[&.active]:text-white">
+        <li class="lg:px-2 text-[var(--color-header-fg)] hover:text-primary-500
+            [&.active]:font-bold [&.active]:text-primary-500">
           <button class="theme-toggle mt-1" accesskey="t" title="">
                     <svg id="moon" xmlns="http://www.w3.org/2000/svg" width="24" height="18" viewBox="0 0 24 24"
              fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"
@@ -100,8 +100,8 @@
         {{ end }}
         {{ $show_translations := site.Params.header.navbar.show_translations | default true }}
         {{ if .IsTranslated | and $show_translations }}
-        <li class="lg:px-2 text-gray-600 hover:text-gray-800 dark:text-gray-400 dark:hover:text-gray-200
-            [&.active]:font-bold [&.active]:text-black/90 dark:[&.active]:text-white">
+        <li class="lg:px-2 text-[var(--color-header-fg)] hover:text-primary-500
+            [&.active]:font-bold [&.active]:text-primary-500">
           {{- partial "components/language-chooser.html" (dict "page" .) -}}
         </li>
         {{ end }}

modules/blox-tailwind/layouts/_partials/components/headers/navbar.html

@@ -32,7 +32,7 @@
     <input id="nav-toggle" type="checkbox" class="hidden" />
     <label
       for="nav-toggle"
-      class="order-3 cursor-pointer flex items-center lg:hidden text-dark dark:text-white lg:order-1">
+      class="order-3 cursor-pointer flex items-center lg:hidden text-[var(--color-header-fg)] lg:order-1">
       <svg id="show-button" class="h-6 fill-current block" viewBox="0 0 20 20">
         <title>Open Menu</title>
         <path d="M0 3h20v2H0V3z m0 6h20v2H0V9z m0 6h20v2H0V0z"></path>
@@ -142,7 +142,7 @@
       {{ with $show_search }}
       <button
         aria-label="toggle search"
-        class="text-black hover:text-primary inline-block px-3 text-xl dark:text-white cursor-pointer"
+        class="inline-block px-3 text-xl text-[var(--color-header-fg)] hover:text-primary-500 cursor-pointer"
         data-search-toggle>
         <svg xmlns="http://www.w3.org/2000/svg" height="16" width="16" viewBox="0 0 512 512" fill="currentColor"><path d="M416 208c0 45.9-14.9 88.3-40 122.7L502.6 457.4c12.5 12.5 12.5 32.8 0 45.3s-32.8 12.5-45.3 0L330.7 376c-34.4 25.2-76.8 40-122.7 40C93.1 416 0 322.9 0 208S93.1 0 208 0S416 93.1 416 208zM208 352a144 144 0 1 0 0-288 144 144 0 1 0 0 288z"/></svg>
       </button>
@@ -150,8 +150,8 @@
 
       {{ $show_theme_chooser := site.Params.header.navbar.show_theme_chooser | default true }}
       {{ if $show_theme_chooser }}
-      <div class="px-3 text-black hover:text-primary-700 dark:text-white dark:hover:text-primary-300
-            [&.active]:font-bold [&.active]:text-black/90 dark:[&.active]:text-white">
+      <div class="px-3 text-[var(--color-header-fg)] hover:text-primary-500
+            [&.active]:font-bold [&.active]:text-primary-500">
         <button class="theme-toggle mt-1" accesskey="t" title="appearance">
           <svg id="moon" xmlns="http://www.w3.org/2000/svg" width="24" height="18" viewBox="0 0 24 24"
                fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"
@@ -177,8 +177,8 @@
 
       {{ $show_translations := site.Params.header.navbar.show_translations | default true }}
       {{ if .IsTranslated | and $show_translations }}
-      <div class="pl-1 mr-5 text-gray-600 hover:text-gray-800 dark:text-gray-400 dark:hover:text-gray-200
-            [&.active]:font-bold [&.active]:text-black/90 dark:[&.active]:text-white">
+      <div class="pl-1 mr-5 text-[var(--color-header-fg)] hover:text-primary-500
+            [&.active]:font-bold [&.active]:text-primary-500">
         {{- partial "components/language-chooser.html" (dict "page" .) -}}
       </div>
       {{ end }}

modules/blox-tailwind/layouts/_partials/functions/generate_color_scale.html

@@ -0,0 +1,121 @@
+{{/* 
+  HugoBlox Builder: Generate Color Scale
+  Generate Tailwind-like 50–950 scale for a given color.
+  Supports palette names and hex values.
+*/}}
+{{ $name := .name }}
+{{ $colorInput := .color | lower }}
+
+{{/* Tailwind 4 Color Palette Lookup Table (OKLCH/Hex) */}}
+{{ $tailwind_palette := dict
+  "red" (dict "50" "oklch(0.971 0.013 17.38)" "100" "oklch(0.936 0.032 17.717)" "200" "oklch(0.885 0.062 18.334)" "300" "oklch(0.808 0.114 19.571)" "400" "oklch(0.704 0.191 22.216)" "500" "oklch(0.637 0.237 25.331)" "600" "oklch(0.577 0.245 27.325)" "700" "oklch(0.505 0.213 27.518)" "800" "oklch(0.444 0.177 26.899)" "900" "oklch(0.396 0.141 25.723)" "950" "oklch(0.258 0.092 26.042)")
+  "orange" (dict "50" "oklch(0.98 0.016 73.684)" "100" "oklch(0.954 0.038 75.164)" "200" "oklch(0.901 0.076 70.697)" "300" "oklch(0.837 0.128 66.29)" "400" "oklch(0.75 0.183 55.934)" "500" "oklch(0.705 0.213 47.604)" "600" "oklch(0.646 0.222 41.116)" "700" "oklch(0.553 0.195 38.402)" "800" "oklch(0.47 0.157 37.304)" "900" "oklch(0.408 0.123 38.172)" "950" "oklch(0.266 0.079 36.259)")
+  "amber" (dict "50" "oklch(0.987 0.022 95.277)" "100" "oklch(0.962 0.059 95.617)" "200" "oklch(0.924 0.12 95.746)" "300" "oklch(0.879 0.169 91.605)" "400" "oklch(0.828 0.189 84.429)" "500" "oklch(0.769 0.188 70.08)" "600" "oklch(0.666 0.179 58.318)" "700" "oklch(0.555 0.163 48.998)" "800" "oklch(0.473 0.137 46.201)" "900" "oklch(0.414 0.112 45.904)" "950" "oklch(0.279 0.077 45.635)")
+  "yellow" (dict "50" "oklch(0.987 0.026 102.212)" "100" "oklch(0.973 0.071 103.193)" "200" "oklch(0.945 0.129 101.54)" "300" "oklch(0.905 0.182 98.111)" "400" "oklch(0.852 0.199 91.936)" "500" "oklch(0.795 0.184 86.047)" "600" "oklch(0.681 0.162 75.834)" "700" "oklch(0.554 0.135 66.442)" "800" "oklch(0.476 0.114 61.907)" "900" "oklch(0.421 0.095 57.708)" "950" "oklch(0.286 0.066 53.813)")
+  "lime" (dict "50" "oklch(0.986 0.031 120.757)" "100" "oklch(0.967 0.067 122.328)" "200" "oklch(0.938 0.127 124.321)" "300" "oklch(0.897 0.196 126.665)" "400" "oklch(0.841 0.238 128.85)" "500" "oklch(0.768 0.233 130.85)" "600" "oklch(0.648 0.2 131.684)" "700" "oklch(0.532 0.157 131.589)" "800" "oklch(0.453 0.124 130.933)" "900" "oklch(0.405 0.101 131.063)" "950" "oklch(0.274 0.072 132.109)")
+  "green" (dict "50" "oklch(0.982 0.018 155.826)" "100" "oklch(0.962 0.044 156.743)" "200" "oklch(0.925 0.084 155.995)" "300" "oklch(0.871 0.15 154.449)" "400" "oklch(0.792 0.209 151.711)" "500" "oklch(0.723 0.219 149.579)" "600" "oklch(0.627 0.194 149.214)" "700" "oklch(0.527 0.154 150.069)" "800" "oklch(0.448 0.119 151.328)" "900" "oklch(0.393 0.095 152.535)" "950" "oklch(0.266 0.065 152.934)")
+  "emerald" (dict "50" "oklch(0.979 0.021 166.113)" "100" "oklch(0.95 0.052 163.051)" "200" "oklch(0.905 0.093 164.15)" "300" "oklch(0.845 0.143 164.978)" "400" "oklch(0.765 0.177 163.223)" "500" "oklch(0.696 0.17 162.48)" "600" "oklch(0.596 0.145 163.225)" "700" "oklch(0.508 0.118 165.612)" "800" "oklch(0.432 0.095 166.913)" "900" "oklch(0.378 0.077 168.94)" "950" "oklch(0.262 0.051 172.552)")
+  "teal" (dict "50" "oklch(0.984 0.014 180.72)" "100" "oklch(0.953 0.051 180.801)" "200" "oklch(0.91 0.096 180.426)" "300" "oklch(0.855 0.138 181.071)" "400" "oklch(0.777 0.152 181.912)" "500" "oklch(0.704 0.14 182.503)" "600" "oklch(0.6 0.118 184.704)" "700" "oklch(0.511 0.096 186.391)" "800" "oklch(0.437 0.078 188.216)" "900" "oklch(0.386 0.063 188.416)" "950" "oklch(0.277 0.046 192.524)")
+  "cyan" (dict "50" "oklch(0.984 0.019 200.873)" "100" "oklch(0.956 0.045 203.388)" "200" "oklch(0.917 0.08 205.041)" "300" "oklch(0.865 0.127 207.078)" "400" "oklch(0.789 0.154 211.53)" "500" "oklch(0.715 0.143 215.221)" "600" "oklch(0.609 0.126 221.723)" "700" "oklch(0.52 0.105 223.128)" "800" "oklch(0.45 0.085 224.283)" "900" "oklch(0.398 0.07 227.392)" "950" "oklch(0.302 0.056 229.695)")
+  "sky" (dict "50" "oklch(0.977 0.013 236.62)" "100" "oklch(0.951 0.026 236.824)" "200" "oklch(0.901 0.058 230.902)" "300" "oklch(0.828 0.111 230.318)" "400" "oklch(0.746 0.16 232.661)" "500" "oklch(0.685 0.169 237.323)" "600" "oklch(0.588 0.158 241.966)" "700" "oklch(0.5 0.134 242.749)" "800" "oklch(0.443 0.11 240.79)" "900" "oklch(0.391 0.09 240.876)" "950" "oklch(0.293 0.066 243.157)")
+  "blue" (dict "50" "oklch(0.97 0.014 254.604)" "100" "oklch(0.932 0.032 255.585)" "200" "oklch(0.882 0.059 254.128)" "300" "oklch(0.809 0.105 251.813)" "400" "oklch(0.707 0.165 254.624)" "500" "oklch(0.623 0.214 259.815)" "600" "oklch(0.546 0.245 262.881)" "700" "oklch(0.488 0.243 264.376)" "800" "oklch(0.424 0.199 265.638)" "900" "oklch(0.379 0.146 265.522)" "950" "oklch(0.282 0.091 267.935)")
+  "indigo" (dict "50" "oklch(0.962 0.018 272.314)" "100" "oklch(0.93 0.034 272.788)" "200" "oklch(0.87 0.065 274.039)" "300" "oklch(0.785 0.115 274.713)" "400" "oklch(0.673 0.182 276.935)" "500" "oklch(0.585 0.233 277.117)" "600" "oklch(0.511 0.262 276.966)" "700" "oklch(0.457 0.24 277.023)" "800" "oklch(0.398 0.195 277.366)" "900" "oklch(0.359 0.144 278.697)" "950" "oklch(0.257 0.09 281.288)")
+  "violet" (dict "50" "oklch(0.969 0.016 293.756)" "100" "oklch(0.943 0.029 294.588)" "200" "oklch(0.894 0.057 293.283)" "300" "oklch(0.811 0.111 293.571)" "400" "oklch(0.702 0.183 293.541)" "500" "oklch(0.606 0.25 292.717)" "600" "oklch(0.541 0.281 293.009)" "700" "oklch(0.491 0.27 292.581)" "800" "oklch(0.432 0.232 292.759)" "900" "oklch(0.38 0.189 293.745)" "950" "oklch(0.283 0.141 291.089)")
+  "purple" (dict "50" "oklch(0.977 0.014 308.299)" "100" "oklch(0.946 0.033 307.174)" "200" "oklch(0.902 0.063 306.703)" "300" "oklch(0.827 0.119 306.383)" "400" "oklch(0.714 0.203 305.504)" "500" "oklch(0.627 0.265 303.9)" "600" "oklch(0.558 0.288 302.321)" "700" "oklch(0.496 0.265 301.924)" "800" "oklch(0.438 0.218 303.724)" "900" "oklch(0.381 0.176 304.987)" "950" "oklch(0.291 0.149 302.717)")
+  "fuchsia" (dict "50" "oklch(0.977 0.017 320.058)" "100" "oklch(0.952 0.037 318.852)" "200" "oklch(0.903 0.076 319.62)" "300" "oklch(0.833 0.145 321.434)" "400" "oklch(0.74 0.238 322.16)" "500" "oklch(0.667 0.295 322.15)" "600" "oklch(0.591 0.293 322.896)" "700" "oklch(0.518 0.253 323.949)" "800" "oklch(0.452 0.211 324.591)" "900" "oklch(0.401 0.17 325.612)" "950" "oklch(0.293 0.136 325.661)")
+  "pink" (dict "50" "oklch(0.971 0.014 343.198)" "100" "oklch(0.948 0.028 342.258)" "200" "oklch(0.899 0.061 343.231)" "300" "oklch(0.823 0.12 346.018)" "400" "oklch(0.718 0.202 349.761)" "500" "oklch(0.656 0.241 354.308)" "600" "oklch(0.592 0.249 0.584)" "700" "oklch(0.525 0.223 3.958)" "800" "oklch(0.459 0.187 3.815)" "900" "oklch(0.408 0.153 2.432)" "950" "oklch(0.284 0.109 3.907)")
+  "rose" (dict "50" "oklch(0.969 0.015 12.422)" "100" "oklch(0.941 0.03 12.58)" "200" "oklch(0.892 0.058 10.001)" "300" "oklch(0.81 0.117 11.638)" "400" "oklch(0.712 0.194 13.428)" "500" "oklch(0.645 0.246 16.439)" "600" "oklch(0.586 0.253 17.585)" "700" "oklch(0.514 0.222 16.935)" "800" "oklch(0.455 0.188 13.697)" "900" "oklch(0.41 0.159 10.272)" "950" "oklch(0.271 0.105 12.094)")
+  "slate" (dict "50" "oklch(0.984 0.003 247.858)" "100" "oklch(0.968 0.007 247.896)" "200" "oklch(0.929 0.013 255.508)" "300" "oklch(0.869 0.022 252.894)" "400" "oklch(0.704 0.04 256.788)" "500" "oklch(0.554 0.046 257.417)" "600" "oklch(0.446 0.043 257.281)" "700" "oklch(0.372 0.044 257.287)" "800" "oklch(0.279 0.041 260.031)" "900" "oklch(0.208 0.042 265.755)" "950" "oklch(0.129 0.042 264.695)")
+  "gray" (dict "50" "oklch(0.985 0.002 247.839)" "100" "oklch(0.967 0.003 264.542)" "200" "oklch(0.928 0.006 264.531)" "300" "oklch(0.872 0.01 258.338)" "400" "oklch(0.707 0.022 261.325)" "500" "oklch(0.551 0.027 264.364)" "600" "oklch(0.446 0.03 256.802)" "700" "oklch(0.373 0.034 259.733)" "800" "oklch(0.278 0.033 256.848)" "900" "oklch(0.21 0.034 264.665)" "950" "oklch(0.13 0.028 261.692)")
+  "zinc" (dict "50" "oklch(0.985 0 0)" "100" "oklch(0.967 0.001 286.375)" "200" "oklch(0.92 0.004 286.32)" "300" "oklch(0.871 0.006 286.286)" "400" "oklch(0.705 0.015 286.067)" "500" "oklch(0.552 0.016 285.938)" "600" "oklch(0.442 0.017 285.786)" "700" "oklch(0.37 0.013 285.805)" "800" "oklch(0.274 0.006 286.033)" "900" "oklch(0.21 0.006 285.885)" "950" "oklch(0.141 0.005 285.823)")
+  "neutral" (dict "50" "oklch(0.985 0 0)" "100" "oklch(0.97 0 0)" "200" "oklch(0.922 0 0)" "300" "oklch(0.87 0 0)" "400" "oklch(0.708 0 0)" "500" "oklch(0.556 0 0)" "600" "oklch(0.439 0 0)" "700" "oklch(0.371 0 0)" "800" "oklch(0.269 0 0)" "900" "oklch(0.205 0 0)" "950" "oklch(0.145 0 0)")
+  "stone" (dict "50" "oklch(0.985 0.001 106.423)" "100" "oklch(0.97 0.001 106.424)" "200" "oklch(0.923 0.003 48.717)" "300" "oklch(0.869 0.005 56.366)" "400" "oklch(0.709 0.01 56.259)" "500" "oklch(0.553 0.013 58.071)" "600" "oklch(0.444 0.011 73.639)" "700" "oklch(0.374 0.01 67.558)" "800" "oklch(0.268 0.007 34.298)" "900" "oklch(0.216 0.006 56.043)" "950" "oklch(0.147 0.004 49.25)")
+}}
+
+{{ if hasPrefix $colorInput "#" }}
+  {{/* 
+    HEX PATH: Custom Brand Color
+    Generate an accessible 50-950 scale by mixing the hex base with white (tints) and black (shades).
+    We map the user's hex to the '500' slot and interpolate outwards.
+  */}}
+  {{ $r := 0 }}{{ $g := 0 }}{{ $b := 0 }}
+  {{ if eq (len $colorInput) 7 }}
+    {{ $r = printf "0x%s" (substr $colorInput 1 2) | int }}
+    {{ $g = printf "0x%s" (substr $colorInput 3 2) | int }}
+    {{ $b = printf "0x%s" (substr $colorInput 5 2) | int }}
+  {{ end }}
+
+  {{/* Base (500) */}}
+  --hb-{{$name}}-500-rgb: {{ $r }} {{ $g }} {{ $b }};
+
+  {{/* Tints (50-400): Mix with White */}}
+  {{ $tints := slice
+    (dict "shade" "50"  "percent" 95)
+    (dict "shade" "100" "percent" 90)
+    (dict "shade" "200" "percent" 80)
+    (dict "shade" "300" "percent" 70)
+    (dict "shade" "400" "percent" 60)
+  }}
+  {{ range $tints }}
+    {{ $p := .percent }}
+    {{ $rp := div (add (mul $r (sub 100 $p)) (mul 255 $p)) 100 }}
+    {{ $gp := div (add (mul $g (sub 100 $p)) (mul 255 $p)) 100 }}
+    {{ $bp := div (add (mul $b (sub 100 $p)) (mul 255 $p)) 100 }}
+    --hb-{{$name}}-{{ .shade }}-rgb: {{ $rp }} {{ $gp }} {{ $bp }};
+  {{ end }}
+
+  {{/* Shades (600-950): Mix with Black */}}
+  {{ $shades := slice
+    (dict "shade" "600" "percent" 10)
+    (dict "shade" "700" "percent" 20)
+    (dict "shade" "800" "percent" 35)
+    (dict "shade" "900" "percent" 50)
+    (dict "shade" "950" "percent" 70)
+  }}
+  {{ range $shades }}
+    {{ $p := .percent }}
+    {{ $rp := div (mul $r (sub 100 $p)) 100 }}
+    {{ $gp := div (mul $g (sub 100 $p)) 100 }}
+    {{ $bp := div (mul $b (sub 100 $p)) 100 }}
+    --hb-{{$name}}-{{ .shade }}-rgb: {{ $rp }} {{ $gp }} {{ $bp }};
+  {{ end }}
+
+{{ else }}
+  {{/* 
+    PALETTE PATH: Standard Tailwind Colors
+    Look up the exact OKLCH values for the requested palette (e.g. "indigo").
+    This ensures complete visual consistency with standard Tailwind utilities.
+  */}}
+  {{ $palette := index $tailwind_palette $colorInput }}
+  
+  {{ if $palette }}
+    {{ range $shade, $value := $palette }}
+      /* Note: converting OKLCH to raw RGB CSS vars requires Tailwind 4's internal conversion 
+         or we output the raw color value directly if theme.css supports it.
+         
+         The existing system expects --hb-primary-50-rgb to be a comma-less RGB triplet "255 255 255".
+         However, Tailwind 4 supports OKLCH natively. 
+         
+         CRITICAL FIX: We must override the `rgb(var(...))` wrapper in `theme.css` if we want to use OKLCH.
+         OR we just output the RGB approximation if we want to keep `theme.css` untouched.
+         
+         BUT `theme.css` defines: --color-primary-50: rgb(var(--hb-primary-50-rgb));
+         So we MUST provide RGB triplets. OKLCH strings like "oklch(...)" inside `rgb(...)` is invalid CSS.
+         
+         To fix this properly without changing `theme.css` significantly, we need RGB values in this table, 
+         OR we redefine the higher-level variables.
+         
+         Since we cannot easily calculate OKLCH -> RGB in Hugo templates, we should 
+         OUTPUT THE HIGHER LEVEL VARIABLES directly here to override theme.css.
+      */
+      --color-{{$name}}-{{$shade}}: {{ $value }};
+    {{ end }}
+    
+    /* Also set the legacy RGB vars to a fallback (500 shade) to prevent breakage 
+       in case something accesses the raw -rgb var directly, though unlikely */
+    --hb-{{$name}}-500-rgb: 128 128 128; 
+  {{ else }}
+    /* Unknown palette '{{$colorInput}}', falling back to Indigo-like default */
+    {{ partial "functions/generate_color_scale" (dict "name" $name "color" "#6366f1") }}
+  {{ end }}
+{{ end }}

modules/blox-tailwind/layouts/_partials/functions/theme_generator.html

@@ -0,0 +1,80 @@
+{{/* HugoBlox Theme Engine: Generates CSS Variables for Light and Dark modes */}}
+{{/* Inputs: .light (default 'minimal') and .dark (default 'dark') */}}
+
+{{ $appearance := site.Params.appearance | default dict }}
+{{ $theme_settings := $appearance.theme | default dict }}
+{{ $light_theme_name := $theme_settings.light | default "default" }}
+{{ $dark_theme_name := $theme_settings.dark | default "default" }}
+{{ $global_colors := $theme_settings.colors | default dict }}
+{{ $primary_override := $global_colors.primary | default $appearance.color }}
+{{ $secondary_override := $global_colors.secondary }}
+
+{{/* Load Theme Data */}}
+{{ if not site.Data.themes }}
+  {{ warnf "THEME ENGINE ERROR: site.Data.themes is empty! Check modules/blox-tailwind/data/themes/" }}
+{{ end }}
+
+{{ $light_theme := index site.Data.themes $light_theme_name }}
+{{ $dark_theme := index site.Data.themes $dark_theme_name }}
+
+{{/* Fallback for missing themes */}}
+{{ if not $light_theme }}
+  {{ warnf "THEME ENGINE WARNING: Light theme '%s' not found. Defaulting to 'default'." $light_theme_name }}
+  {{ $light_theme = site.Data.themes.default }}
+{{ end }}
+{{ if not $dark_theme }}
+  {{ warnf "THEME ENGINE WARNING: Dark theme '%s' not found. Defaulting to 'default'." $dark_theme_name }}
+  {{ $dark_theme = site.Data.themes.default }}
+{{ end }}
+
+{{/* Resolve effective light/dark mode objects */}}
+{{ $light_base := $light_theme.light | default $light_theme }}
+{{ $dark_base := $dark_theme.dark | default $dark_theme }}
+
+{{/* Apply global color overrides (palette or hex) */}}
+{{ if or $primary_override $secondary_override }}
+  {{ if $light_base }}
+    {{ $light_colors := merge (dict) ($light_base.colors | default dict) }}
+    {{ if $primary_override }}
+      {{ $light_colors = merge $light_colors (dict "primary" $primary_override) }}
+    {{ end }}
+    {{ if $secondary_override }}
+      {{ $light_colors = merge $light_colors (dict "secondary" $secondary_override) }}
+    {{ end }}
+    {{ $light_base = merge $light_base (dict "colors" $light_colors) }}
+  {{ end }}
+  {{ if $dark_base }}
+    {{ $dark_colors := merge (dict) ($dark_base.colors | default dict) }}
+    {{ if $primary_override }}
+      {{ $dark_colors = merge $dark_colors (dict "primary" $primary_override) }}
+    {{ end }}
+    {{ if $secondary_override }}
+      {{ $dark_colors = merge $dark_colors (dict "secondary" $secondary_override) }}
+    {{ end }}
+    {{ $dark_base = merge $dark_base (dict "colors" $dark_colors) }}
+  {{ end }}
+{{ end }}
+
+<style>
+  /* stylelint-disable */
+  /* 1. Light Mode (Default :root) */
+  :root {
+    {{ if $light_base }}
+      /* Light Theme: {{ $light_theme_name }} */
+      {{ partial "functions/theme_variables" (dict "data" $light_base "is_dark" false) | safeCSS }}
+    {{ else }}
+      /* Failed to load data for {{ $light_theme_name }} */
+    {{ end }}
+  }
+
+  /* 2. Dark Mode (.dark class) */
+  .dark {
+    {{ if $dark_base }}
+      /* Dark Theme: {{ $dark_theme_name }} */
+      {{ partial "functions/theme_variables" (dict "data" $dark_base "is_dark" true) | safeCSS }}
+    {{ else }}
+      /* Failed to load data for {{ $dark_theme_name }} */
+    {{ end }}
+  }
+  /* stylelint-enable */
+</style>

modules/blox-tailwind/layouts/_partials/functions/theme_variables.html

@@ -0,0 +1,26 @@
+{{/* HugoBlox Theme Helper to output CSS variables for a specific theme block */}}
+{{ $data := .data }}
+
+{{/* 1. Palette Generation (Primary/Secondary Scales) */}}
+{{ $primary := $data.colors.primary | default "#3b82f6" }}
+{{ $secondary := $data.colors.secondary | default "#10b981" }}
+
+{{ partial "functions/generate_color_scale" (dict "name" "primary" "color" $primary) }}
+{{ partial "functions/generate_color_scale" (dict "name" "secondary" "color" $secondary) }}
+
+{{ if $data.colors.neutral }}
+  {{/* Map user 'neutral' to Tailwind 'gray' utility to override text-gray-* classes */}}
+  {{ partial "functions/generate_color_scale" (dict "name" "gray" "color" $data.colors.neutral) }}
+{{ end }}
+
+{{/* 2. Semantic UI Variables */}}
+--color-background: {{ $data.ui.background | default "#ffffff" }};
+--color-foreground: {{ $data.ui.foreground | default "#000000" }};
+
+{{/* Header */}}
+--color-header-bg: {{ $data.ui.header.background | default $data.ui.background | default "#ffffff" }};
+--color-header-fg: {{ $data.ui.header.foreground | default $data.ui.foreground | default "#000000" }};
+
+{{/* Footer */}}
+--color-footer-bg: {{ $data.ui.footer.background | default $data.ui.background | default "#f3f4f6" }};
+--color-footer-fg: {{ $data.ui.footer.foreground | default $data.ui.foreground | default "#000000" }};

modules/blox-tailwind/layouts/_partials/site_head.html

@@ -46,13 +46,18 @@
   <link rel="alternate" hreflang="{{ site.LanguageCode | default "en-us" }}" href="{{ .Permalink }}" />
 
   {{/* Hugo Blox Color Theme Initialization */}}
-  {{ $theme_name := (lower site.Params.appearance.color) | default "blue" }}
-  {{ $theme_path := printf "css/themes/%s.css" $theme_name }}
-  {{ if not (fileExists (printf "assets/%s" $theme_path)) }}
-    {{ errorf "The specified color theme `%s.css` was not found in `assets/css/themes/`. Either install your custom color theme in the folder or set the `color` theme value in `params.yaml` to an existing theme such as `blue`." $theme_name }}
+  {{ $legacy_color := (lower site.Params.appearance.color) | default "blue" }}
+  
+  {{/* 1. New Data-Driven System (Mix & Match) */}}
+  {{ if site.Params.appearance.theme }}
+     {{ partial "functions/theme_generator.html" (dict "light" site.Params.appearance.theme.light "dark" site.Params.appearance.theme.dark) }}
+  {{/* 2. Legacy CSS System Fallback */}}
+  {{ else if (fileExists (printf "assets/css/themes/%s.css" $legacy_color)) }}
+     {{ $theme_css := resources.Get (printf "css/themes/%s.css" $legacy_color) | minify }}
+     <link rel="stylesheet" href="{{ $theme_css.RelPermalink }}" />
   {{ else }}
-    {{ $theme_css := resources.Get $theme_path | minify }}
-    <link rel="stylesheet" href="{{ $theme_css.RelPermalink }}" />
+     {{/* 3. Default Fallback */}}
+     {{ partial "functions/theme_generator.html" (dict "light" "default" "dark" "default") }}
   {{ end }}
 
   {{/* Tailwind CSS v4 Processing */}}

modules/blox-tailwind/layouts/baseof.html

@@ -6,7 +6,7 @@
       data-wc-theme-default="{{ (lower site.Params.appearance.mode) | default "system" }}"
       data-hbb-relurl="{{ "" | relURL }}">
   {{ partial "site_head" . }}
-  <body class="dark:bg-hb-dark dark:text-white page-wrapper" id="top">
+  <body class="bg-[var(--color-background)] text-[var(--color-foreground)] page-wrapper" id="top">
     <div id="page-bg"></div>
     <div class="page-header {{ if site.Params.header.navbar.fixed_to_top }}sticky top-0 z-30{{ end }}">
       {{/* Load header block */}}

templates/academic-cv/config/_default/params.yaml

@@ -6,7 +6,9 @@
 # Appearance
 appearance:
   mode: system
-  color: indigo
+  theme:
+    light: "default"
+    dark: "default"
 
 # SEO
 marketing:

templates/blog/config/_default/params.yaml

@@ -6,7 +6,9 @@
 # Appearance
 appearance:
   mode: system
-  color: blue
+  theme:
+    light: "default"
+    dark: "default"
 
 # SEO
 marketing:

templates/documentation/config/_default/params.yaml

@@ -6,7 +6,9 @@
 # Appearance
 appearance:
   mode: light
-  color: blue
+  theme:
+    light: "default"
+    dark: "default"
 
 # SEO
 marketing:

templates/landing-page/config/_default/params.yaml

@@ -6,7 +6,9 @@
 # Appearance
 appearance:
   mode: light
-  color: indigo
+  theme:
+    light: "default"
+    dark: "default"
 
 # SEO
 marketing:

templates/link-in-bio/config/_default/params.yaml

@@ -6,7 +6,9 @@
 # Appearance
 appearance:
   mode: light
-  color: blue
+  theme:
+    light: "default"
+    dark: "default"
 
 # SEO
 marketing:

templates/resume/config/_default/params.yaml

@@ -6,7 +6,9 @@
 # Appearance
 appearance:
   mode: system
-  color: blue
+  theme:
+    light: "default"
+    dark: "default"
 
 # SEO
 marketing: