@grove-dev/astro 0.2.18 → 0.2.19

package/dist/index.d.ts

@@ -2,4 +2,5 @@ import type { AstroIntegration } from "astro";
 export * from "@grove-dev/core";
 export * from "./lib/index.js";
 export default function groveAstro(): AstroIntegration;
+export declare const CONSUMER_GLOBAL_CSS_ID = "virtual:grove-consumer-global-css";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAE9C,cAAc,iBAAiB,CAAC;AAMhC,cAAc,gBAAgB,CAAC;AAW/B,MAAM,CAAC,OAAO,UAAU,UAAU,IAAI,gBAAgB,CAuBrD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAE9C,cAAc,iBAAiB,CAAC;AAMhC,cAAc,gBAAgB,CAAC;AAkB/B,MAAM,CAAC,OAAO,UAAU,UAAU,IAAI,gBAAgB,CAuDrD;AAID,eAAO,MAAM,sBAAsB,sCAAiC,CAAC"}

package/dist/index.js

@@ -16,7 +16,15 @@
  *  - Re-exports the generic `lib/` helpers (search, lenses, scores,
  *    repo, format, display, taxonomy-counts) under a single import
  *    path so consumers can `import { ... } from "@grove-dev/astro"`.
+ *
+ * Also auto-loads the consumer's `src/styles/global.css` when it
+ * exists. Without this hook the scaffold's global.css (which the
+ * CLI generates for theme overrides) sits on disk unused, and any
+ * custom theme tokens silently degrade to the package defaults —
+ * which is the classic "I changed the brand color in global.css
+ * and nothing happened" surprise.
  */
+import { existsSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { dirname, resolve } from "node:path";
 export * from "@grove-dev/core";
@@ -33,16 +41,24 @@ const here = dirname(fileURLToPath(import.meta.url));
 const srcRoot = resolve(here, "..", "src");
 const componentsDir = resolve(srcRoot, "components");
 const layoutsDir = resolve(srcRoot, "layouts");
+// Virtual module id used to inject the consumer's `src/styles/global.css`.
+// Resolved by the inline Vite plugin below to the absolute file path
+// when the file exists, or to an empty module when it doesn't.
+const CONSUMER_GLOBAL_CSS_VIRTUAL_ID = "virtual:grove-consumer-global-css";
+const CONSUMER_GLOBAL_CSS_EMPTY_ID = "\0virtual:grove-consumer-global-css:empty";
 export default function groveAstro() {
     return {
         name: "@grove-dev/astro",
         hooks: {
-            "astro:config:setup": ({ updateConfig }) => {
+            "astro:config:setup": ({ config, updateConfig, injectScript }) => {
                 // Alias the components/layouts source directories so
                 // consumer builds can import from
                 //   @grove-dev/astro/components/ItemCard.astro
                 // without us shipping a glob-shaped `exports` map that
                 // Vite/Rollup does not expand reliably.
+                const consumerRoot = fileURLToPath(config.root);
+                const globalCssPath = resolve(consumerRoot, "src/styles/global.css");
+                const globalCssExists = existsSync(globalCssPath);
                 updateConfig({
                     vite: {
                         resolve: {
@@ -51,10 +67,37 @@ export default function groveAstro() {
                                 "@grove-dev/astro/layouts": layoutsDir,
                             },
                         },
+                        plugins: [
+                            {
+                                name: "grove:consumer-global-css-resolver",
+                                resolveId(id) {
+                                    if (id === CONSUMER_GLOBAL_CSS_VIRTUAL_ID) {
+                                        return globalCssExists
+                                            ? globalCssPath
+                                            : CONSUMER_GLOBAL_CSS_EMPTY_ID;
+                                    }
+                                    return null;
+                                },
+                                load(id) {
+                                    if (id === CONSUMER_GLOBAL_CSS_EMPTY_ID) {
+                                        return "";
+                                    }
+                                    return null;
+                                },
+                            },
+                        ],
                     },
                 });
+                // Always inject the virtual module so the build is symmetric
+                // regardless of whether the consumer has a global.css yet.
+                // Vite's CSS pipeline (with @tailwindcss/vite) handles the
+                // resulting import as a stylesheet — no JS bundle weight.
+                injectScript("page-ssr", `import "${CONSUMER_GLOBAL_CSS_VIRTUAL_ID}";`);
             },
         },
     };
 }
+// Re-export the virtual module id so consumers (and tests) can
+// reason about it without copy-pasting the literal string.
+export const CONSUMER_GLOBAL_CSS_ID = CONSUMER_GLOBAL_CSS_VIRTUAL_ID;
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG7C,cAAc,iBAAiB,CAAC;AAEhC,+DAA+D;AAC/D,mEAAmE;AACnE,iEAAiE;AACjE,mCAAmC;AACnC,cAAc,gBAAgB,CAAC;AAE/B,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACrD,+DAA+D;AAC/D,0DAA0D;AAC1D,8DAA8D;AAC9D,sCAAsC;AACtC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3C,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AACrD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;AAE/C,MAAM,CAAC,OAAO,UAAU,UAAU;IAChC,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE;YACL,oBAAoB,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE;gBACzC,qDAAqD;gBACrD,kCAAkC;gBAClC,+CAA+C;gBAC/C,uDAAuD;gBACvD,wCAAwC;gBACxC,YAAY,CAAC;oBACX,IAAI,EAAE;wBACJ,OAAO,EAAE;4BACP,KAAK,EAAE;gCACL,6BAA6B,EAAE,aAAa;gCAC5C,0BAA0B,EAAE,UAAU;6BACvC;yBACF;qBACF;iBACF,CAAC,CAAC;YACL,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG7C,cAAc,iBAAiB,CAAC;AAEhC,+DAA+D;AAC/D,mEAAmE;AACnE,iEAAiE;AACjE,mCAAmC;AACnC,cAAc,gBAAgB,CAAC;AAE/B,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACrD,+DAA+D;AAC/D,0DAA0D;AAC1D,8DAA8D;AAC9D,sCAAsC;AACtC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3C,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AACrD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;AAE/C,2EAA2E;AAC3E,qEAAqE;AACrE,+DAA+D;AAC/D,MAAM,8BAA8B,GAAG,mCAAmC,CAAC;AAC3E,MAAM,4BAA4B,GAChC,2CAA2C,CAAC;AAE9C,MAAM,CAAC,OAAO,UAAU,UAAU;IAChC,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE;YACL,oBAAoB,EAAE,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,EAAE,EAAE;gBAC/D,qDAAqD;gBACrD,kCAAkC;gBAClC,+CAA+C;gBAC/C,uDAAuD;gBACvD,wCAAwC;gBACxC,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAChD,MAAM,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,uBAAuB,CAAC,CAAC;gBACrE,MAAM,eAAe,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;gBAElD,YAAY,CAAC;oBACX,IAAI,EAAE;wBACJ,OAAO,EAAE;4BACP,KAAK,EAAE;gCACL,6BAA6B,EAAE,aAAa;gCAC5C,0BAA0B,EAAE,UAAU;6BACvC;yBACF;wBACD,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,oCAAoC;gCAC1C,SAAS,CAAC,EAAE;oCACV,IAAI,EAAE,KAAK,8BAA8B,EAAE,CAAC;wCAC1C,OAAO,eAAe;4CACpB,CAAC,CAAC,aAAa;4CACf,CAAC,CAAC,4BAA4B,CAAC;oCACnC,CAAC;oCACD,OAAO,IAAI,CAAC;gCACd,CAAC;gCACD,IAAI,CAAC,EAAE;oCACL,IAAI,EAAE,KAAK,4BAA4B,EAAE,CAAC;wCACxC,OAAO,EAAE,CAAC;oCACZ,CAAC;oCACD,OAAO,IAAI,CAAC;gCACd,CAAC;6BACF;yBACF;qBACF;iBACF,CAAC,CAAC;gBAEH,6DAA6D;gBAC7D,2DAA2D;gBAC3D,2DAA2D;gBAC3D,0DAA0D;gBAC1D,YAAY,CACV,UAAU,EACV,WAAW,8BAA8B,IAAI,CAC9C,CAAC;YACJ,CAAC;SACF;KACF,CAAC;AACJ,CAAC;AAED,+DAA+D;AAC/D,2DAA2D;AAC3D,MAAM,CAAC,MAAM,sBAAsB,GAAG,8BAA8B,CAAC"}

package/dist/theme.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=theme.test.d.ts.map

package/dist/theme.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.test.d.ts","sourceRoot":"","sources":["../src/theme.test.ts"],"names":[],"mappings":""}

package/dist/theme.test.js

@@ -0,0 +1,41 @@
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { describe, expect, it } from "vitest";
+const astroTheme = readFileSync(resolve(import.meta.dirname, "styles.css"), "utf8");
+const scaffoldTheme = readFileSync(resolve(import.meta.dirname, "../templates/default/src/styles/global.css"), "utf8");
+describe("Astro theme contract", () => {
+    it("keeps Starlight's light and dark foundation values", () => {
+        expect(astroTheme).toContain("--grove-background: oklch(100% 0 0)");
+        expect(astroTheme).toContain("--grove-foreground: var(--color-ink-950)");
+        expect(astroTheme).toContain("--grove-background: var(--color-ink-950)");
+        expect(astroTheme).toContain("--grove-foreground: var(--color-ink-50)");
+        expect(astroTheme).toContain("--color-ink-50: oklch(98.5% 0 0)");
+        expect(astroTheme).toContain("--color-ink-950: oklch(14.5% 0 0)");
+    });
+    it("exposes runtime semantic colors to Tailwind", () => {
+        for (const token of [
+            "background",
+            "foreground",
+            "primary",
+            "secondary",
+            "muted",
+            "accent",
+            "border",
+            "card",
+            "popover",
+        ]) {
+            expect(astroTheme).toContain(`--color-${token}: var(--grove-${token})`);
+        }
+    });
+    it("uses the same system and mono font stacks as the docs", () => {
+        expect(astroTheme).toContain('--font-sans: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto,');
+        expect(astroTheme).toContain("--font-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas,");
+        expect(astroTheme).toContain("font-family: var(--font-sans)");
+    });
+    it("does not duplicate package-owned foundation tokens in the scaffold", () => {
+        expect(scaffoldTheme).not.toContain("--color-ink-");
+        expect(scaffoldTheme).not.toContain("font-family:");
+        expect(scaffoldTheme).not.toContain("color-scheme:");
+    });
+});
+//# sourceMappingURL=theme.test.js.map

package/dist/theme.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.test.js","sourceRoot":"","sources":["../src/theme.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC;AACpF,MAAM,aAAa,GAAG,YAAY,CAChC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,4CAA4C,CAAC,EAC1E,MAAM,CACP,CAAC;AAEF,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,qCAAqC,CAAC,CAAC;QACpE,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,0CAA0C,CAAC,CAAC;QACzE,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,0CAA0C,CAAC,CAAC;QACzE,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,yCAAyC,CAAC,CAAC;QACxE,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,kCAAkC,CAAC,CAAC;QACjE,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,mCAAmC,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,KAAK,MAAM,KAAK,IAAI;YAClB,YAAY;YACZ,YAAY;YACZ,SAAS;YACT,WAAW;YACX,OAAO;YACP,QAAQ;YACR,QAAQ;YACR,MAAM;YACN,SAAS;SACV,EAAE,CAAC;YACF,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,WAAW,KAAK,iBAAiB,KAAK,GAAG,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAC1B,qEAAqE,CACtE,CAAC;QACF,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAC1B,qEAAqE,CACtE,CAAC;QACF,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,+BAA+B,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACpD,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACpD,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grove-dev/astro",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "type": "module",
   "description": "Astro framework adapter for Grove. Components, layouts, design tokens, and a default template.",
   "license": "MIT",

package/src/components/Hero.astro

@@ -114,9 +114,9 @@ const trustStats: { value: string; label: string }[] = [
     class="pointer-events-none absolute inset-0 opacity-60 dark:opacity-40"
     style="
       background-image:
-        radial-gradient(60% 50% at 15% 20%, rgba(31, 111, 235, 0.12), transparent 60%),
-        radial-gradient(50% 40% at 85% 10%, rgba(110, 231, 183, 0.10), transparent 60%),
-        radial-gradient(40% 40% at 50% 90%, rgba(251, 146, 60, 0.08), transparent 60%);
+        radial-gradient(60% 50% at 15% 20%, color-mix(in oklab, var(--color-ink-300) 34%, transparent), transparent 60%),
+        radial-gradient(50% 40% at 85% 10%, color-mix(in oklab, var(--color-ink-200) 28%, transparent), transparent 60%),
+        radial-gradient(40% 40% at 50% 90%, color-mix(in oklab, var(--color-ink-400) 18%, transparent), transparent 60%);
     "
   ></div>
 

package/src/components/Icon.astro

@@ -185,16 +185,16 @@ const a11y: Record<string, string> = title
     align-items: center;
     justify-content: center;
     border-radius: 0.25rem;
-    background: var(--color-ink-100, #f4f4f5);
-    color: var(--color-ink-700, #3f3f46);
+    background: var(--color-ink-100, oklch(97% 0 0));
+    color: var(--color-ink-700, oklch(37.1% 0 0));
     font-weight: 600;
     line-height: 1;
     text-transform: uppercase;
     user-select: none;
   }
   :global(.dark) .grove-icon-fallback {
-    background: var(--color-ink-800, #27272a);
-    color: var(--color-ink-200, #e4e4e7);
+    background: var(--color-ink-800, oklch(26.9% 0 0));
+    color: var(--color-ink-200, oklch(92.2% 0 0));
   }
 </style>
 

package/src/index.ts

@@ -16,7 +16,15 @@
  *  - Re-exports the generic `lib/` helpers (search, lenses, scores,
  *    repo, format, display, taxonomy-counts) under a single import
  *    path so consumers can `import { ... } from "@grove-dev/astro"`.
+ *
+ * Also auto-loads the consumer's `src/styles/global.css` when it
+ * exists. Without this hook the scaffold's global.css (which the
+ * CLI generates for theme overrides) sits on disk unused, and any
+ * custom theme tokens silently degrade to the package defaults —
+ * which is the classic "I changed the brand color in global.css
+ * and nothing happened" surprise.
  */
+import { existsSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { dirname, resolve } from "node:path";
 import type { AstroIntegration } from "astro";
@@ -38,16 +46,27 @@ const srcRoot = resolve(here, "..", "src");
 const componentsDir = resolve(srcRoot, "components");
 const layoutsDir = resolve(srcRoot, "layouts");
 
+// Virtual module id used to inject the consumer's `src/styles/global.css`.
+// Resolved by the inline Vite plugin below to the absolute file path
+// when the file exists, or to an empty module when it doesn't.
+const CONSUMER_GLOBAL_CSS_VIRTUAL_ID = "virtual:grove-consumer-global-css";
+const CONSUMER_GLOBAL_CSS_EMPTY_ID =
+  "\0virtual:grove-consumer-global-css:empty";
+
 export default function groveAstro(): AstroIntegration {
   return {
     name: "@grove-dev/astro",
     hooks: {
-      "astro:config:setup": ({ updateConfig }) => {
+      "astro:config:setup": ({ config, updateConfig, injectScript }) => {
         // Alias the components/layouts source directories so
         // consumer builds can import from
         //   @grove-dev/astro/components/ItemCard.astro
         // without us shipping a glob-shaped `exports` map that
         // Vite/Rollup does not expand reliably.
+        const consumerRoot = fileURLToPath(config.root);
+        const globalCssPath = resolve(consumerRoot, "src/styles/global.css");
+        const globalCssExists = existsSync(globalCssPath);
+
         updateConfig({
           vite: {
             resolve: {
@@ -56,9 +75,41 @@ export default function groveAstro(): AstroIntegration {
                 "@grove-dev/astro/layouts": layoutsDir,
               },
             },
+            plugins: [
+              {
+                name: "grove:consumer-global-css-resolver",
+                resolveId(id) {
+                  if (id === CONSUMER_GLOBAL_CSS_VIRTUAL_ID) {
+                    return globalCssExists
+                      ? globalCssPath
+                      : CONSUMER_GLOBAL_CSS_EMPTY_ID;
+                  }
+                  return null;
+                },
+                load(id) {
+                  if (id === CONSUMER_GLOBAL_CSS_EMPTY_ID) {
+                    return "";
+                  }
+                  return null;
+                },
+              },
+            ],
           },
         });
+
+        // Always inject the virtual module so the build is symmetric
+        // regardless of whether the consumer has a global.css yet.
+        // Vite's CSS pipeline (with @tailwindcss/vite) handles the
+        // resulting import as a stylesheet — no JS bundle weight.
+        injectScript(
+          "page-ssr",
+          `import "${CONSUMER_GLOBAL_CSS_VIRTUAL_ID}";`,
+        );
       },
     },
   };
 }
+
+// Re-export the virtual module id so consumers (and tests) can
+// reason about it without copy-pasting the literal string.
+export const CONSUMER_GLOBAL_CSS_ID = CONSUMER_GLOBAL_CSS_VIRTUAL_ID;

package/src/layouts/BaseLayout.astro

@@ -186,7 +186,7 @@ const favicon =
       })();
     </script>
   </head>
-  <body class="min-h-screen bg-white text-ink-900 dark:bg-ink-950 dark:text-ink-100">
+  <body class="min-h-screen bg-background text-foreground">
     <slot name="header">
       <Header
         site={site}

package/src/styles.css

@@ -17,61 +17,106 @@
  */
 
 @import "tailwindcss";
+/*
+ * Custom `dark` variant — `dark:` utilities must key off the `.dark`
+ * class on <html> (set by the THEME_INIT script in BaseLayout.astro),
+ * NOT off `prefers-color-scheme`. Tailwind v4.3.0 splits the selector
+ * argument on commas — including commas inside `:where(...)` — so
+ * `(&:where(.dark, .dark *))` is silently parsed as two separate
+ * (and broken) selectors and the variant never registers. Use two
+ * selectors joined by a space instead.
+ */
+@custom-variant dark (&:where(.dark), &:where(.dark *));
 @source "./**/*.{astro,html,js,jsx,ts,tsx}";
 
 @theme {
-  /* ── Neutral ink scale (V1 default) ───────────────────────────── */
-  --color-ink-50: #fafafa;
-  --color-ink-100: #f4f4f5;
-  --color-ink-200: #e4e4e7;
-  --color-ink-300: #d4d4d8;
-  --color-ink-400: #a1a1aa;
-  --color-ink-500: #71717a;
-  --color-ink-600: #52525b;
-  --color-ink-700: #3f3f46;
-  --color-ink-800: #27272a;
-  --color-ink-900: #18181b;
-  --color-ink-950: #09090b;
+  /* ── Starlight-aligned neutral scale ──────────────────────────── */
+  --color-ink-50: oklch(98.5% 0 0);
+  --color-ink-100: oklch(97% 0 0);
+  --color-ink-200: oklch(92.2% 0 0);
+  --color-ink-300: oklch(87% 0 0);
+  --color-ink-400: oklch(70.8% 0 0);
+  --color-ink-500: oklch(55.6% 0 0);
+  --color-ink-600: oklch(43.9% 0 0);
+  --color-ink-700: oklch(37.1% 0 0);
+  --color-ink-800: oklch(26.9% 0 0);
+  --color-ink-900: oklch(20.5% 0 0);
+  --color-ink-950: oklch(14.5% 0 0);
+
+  /* ── Semantic colors ────────────────────────────────────────────
+   * These point at runtime variables instead of fixed palette steps so
+   * Tailwind utilities such as `bg-background` and `text-foreground`
+   * follow the resolved theme without requiring a `dark:` twin. The
+   * values below mirror packages/starlight/styles/{theme,base}.css.
+   */
+  --color-background: var(--grove-background);
+  --color-foreground: var(--grove-foreground);
+  --color-primary: var(--grove-primary);
+  --color-primary-foreground: var(--grove-primary-foreground);
+  --color-secondary: var(--grove-secondary);
+  --color-secondary-foreground: var(--grove-secondary-foreground);
+  --color-muted: var(--grove-muted);
+  --color-muted-foreground: var(--grove-muted-foreground);
+  --color-accent: var(--grove-accent);
+  --color-accent-foreground: var(--grove-accent-foreground);
+  --color-border: var(--grove-border);
+  --color-input: var(--grove-input);
+  --color-ring: var(--grove-ring);
+  --color-card: var(--grove-card);
+  --color-card-foreground: var(--grove-card-foreground);
+  --color-popover: var(--grove-popover);
+  --color-popover-foreground: var(--grove-popover-foreground);
 
   /* ── Accent (interactive states) ─────────────────────────────── */
-  --color-accent: #1f6feb;
-  --color-accent-muted: #388bfd1a;
+  --color-accent-muted: color-mix(in oklab, var(--grove-foreground) 8%, transparent);
 
   /* ── Status palettes (badges only) ───────────────────────────── */
-  --color-emerald-50: #ecfdf5;
-  --color-emerald-300: #6ee7b7;
-  --color-emerald-400: #34d399;
-  --color-emerald-700: #047857;
-  --color-emerald-800: #065f46;
-  --color-emerald-950: #022c22;
-
-  --color-orange-50: #fff7ed;
-  --color-orange-300: #fdba74;
-  --color-orange-400: #fb923c;
-  --color-orange-700: #c2410c;
-  --color-orange-800: #9a3412;
-  --color-orange-950: #431407;
-
-  --color-blue-50: #eff6ff;
-  --color-blue-300: #93c5fd;
-  --color-blue-400: #60a5fa;
-  --color-blue-700: #1d4ed8;
-  --color-blue-800: #1e40af;
-  --color-blue-950: #172554;
-
-  --color-amber-50: #fffbeb;
-  --color-amber-300: #fcd34d;
-  --color-amber-400: #fbbf24;
-  --color-amber-700: #b45309;
-  --color-amber-800: #92400e;
-  --color-amber-950: #451a03;
+  --color-emerald-50: oklch(98.2% 0.018 155.826);
+  --color-emerald-300: oklch(87.1% 0.15 154.449);
+  --color-emerald-400: oklch(79.2% 0.209 151.711);
+  --color-emerald-500: oklch(72.3% 0.219 149.579);
+  --color-emerald-600: oklch(52.7% 0.154 150.069);
+  --color-emerald-700: oklch(52.7% 0.154 150.069);
+  --color-emerald-800: oklch(26.6% 0.065 152.934);
+  --color-emerald-950: oklch(26.6% 0.065 152.934);
+
+  --color-orange-50: oklch(98% 0.016 73.684);
+  --color-orange-300: oklch(90.1% 0.076 70.697);
+  --color-orange-400: oklch(83.7% 0.128 66.29);
+  --color-orange-500: oklch(70.5% 0.213 47.604);
+  --color-orange-700: oklch(70.5% 0.213 47.604);
+  --color-orange-800: oklch(55.3% 0.195 38.402);
+  --color-orange-950: oklch(40.8% 0.123 38.172);
+
+  --color-blue-50: oklch(97% 0.014 254.604);
+  --color-blue-300: oklch(82.8% 0.111 230.318);
+  --color-blue-400: oklch(70.7% 0.165 254.624);
+  --color-blue-700: oklch(48.8% 0.243 264.376);
+  --color-blue-800: oklch(29.3% 0.066 243.157);
+  --color-blue-950: oklch(29.3% 0.066 243.157);
+
+  --color-amber-50: oklch(98% 0.016 73.684);
+  --color-amber-300: oklch(90.1% 0.076 70.697);
+  --color-amber-400: oklch(83.7% 0.128 66.29);
+  --color-amber-500: oklch(83.7% 0.128 66.29);
+  --color-amber-600: oklch(70.5% 0.213 47.604);
+  --color-amber-700: oklch(70.5% 0.213 47.604);
+  --color-amber-800: oklch(55.3% 0.195 38.402);
+  --color-amber-900: oklch(40.8% 0.123 38.172);
+  --color-amber-950: oklch(40.8% 0.123 38.172);
 
   /* ── Font stacks ─────────────────────────────────────────────── */
-  --font-sans: ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto,
-    "Helvetica Neue", Arial, sans-serif;
+  --font-sans: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto,
+    "Helvetica Neue", "Noto Sans", Arial, sans-serif, "Apple Color Emoji",
+    "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
   --font-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas,
     "Liberation Mono", "Courier New", monospace;
 
+  /* ── Starlight typography weight/rhythm ──────────────────────── */
+  --font-weight-semibold: 500;
+  --font-weight-bold: 600;
+  --leading-relaxed: 1.75;
+
   /* ── Font size extensions (2xs) ──────────────────────────────── */
   --text-2xs: 0.6875rem;
   --text-2xs--line-height: 1rem;
@@ -139,7 +184,61 @@
 
 @layer base {
   :root {
-    color-scheme: light dark;
+    color-scheme: light;
+
+    /* Starlight light theme, expressed as Grove's public semantic API. */
+    --grove-background: oklch(100% 0 0);
+    --grove-foreground: var(--color-ink-950);
+    --grove-gray-1: var(--color-ink-900);
+    --grove-gray-2: var(--color-ink-800);
+    --grove-gray-3: var(--color-ink-700);
+    --grove-gray-4: var(--color-ink-500);
+    --grove-gray-5: var(--color-ink-400);
+    --grove-gray-6: var(--color-ink-300);
+    --grove-gray-7: var(--color-ink-100);
+    --grove-primary: var(--grove-foreground);
+    --grove-primary-foreground: var(--grove-gray-7);
+    --grove-secondary: var(--grove-gray-7);
+    --grove-secondary-foreground: var(--grove-foreground);
+    --grove-muted: var(--grove-gray-7);
+    --grove-muted-foreground: var(--grove-gray-4);
+    --grove-accent: var(--grove-gray-7);
+    --grove-accent-foreground: var(--grove-foreground);
+    --grove-border: var(--grove-gray-6);
+    --grove-input: var(--grove-gray-6);
+    --grove-ring: var(--grove-gray-4);
+    --grove-card: var(--grove-background);
+    --grove-card-foreground: var(--grove-foreground);
+    --grove-popover: var(--grove-background);
+    --grove-popover-foreground: var(--grove-foreground);
+  }
+
+  :root.dark {
+    color-scheme: dark;
+    --grove-background: var(--color-ink-950);
+    --grove-foreground: var(--color-ink-50);
+    --grove-gray-1: var(--color-ink-50);
+    --grove-gray-2: var(--color-ink-300);
+    --grove-gray-3: var(--color-ink-400);
+    --grove-gray-4: var(--color-ink-500);
+    --grove-gray-5: var(--color-ink-700);
+    --grove-gray-6: var(--color-ink-800);
+    --grove-gray-7: var(--color-ink-900);
+    --grove-primary: var(--grove-foreground);
+    --grove-primary-foreground: var(--grove-gray-7);
+    --grove-secondary: var(--grove-gray-6);
+    --grove-secondary-foreground: var(--grove-foreground);
+    --grove-muted: var(--grove-gray-6);
+    --grove-muted-foreground: var(--grove-gray-3);
+    --grove-accent: var(--grove-gray-5);
+    --grove-accent-foreground: var(--grove-foreground);
+    --grove-border: var(--grove-gray-6);
+    --grove-input: var(--grove-gray-5);
+    --grove-ring: var(--grove-gray-4);
+    --grove-card: var(--grove-background);
+    --grove-card-foreground: var(--grove-foreground);
+    --grove-popover: var(--grove-gray-7);
+    --grove-popover-foreground: var(--grove-foreground);
   }
 
   html {
@@ -150,16 +249,11 @@
 
   body {
     margin: 0;
-    background: #ffffff;
-    color: var(--color-ink-900);
+    background: var(--grove-background);
+    color: var(--grove-foreground);
     font-family: var(--font-sans);
     font-size: 15px;
-    line-height: 1.55;
-  }
-
-  .dark body {
-    background: var(--color-ink-950);
-    color: var(--color-ink-100);
+    line-height: 1.75;
   }
 
   a {
@@ -169,30 +263,23 @@
 
   /* Subtle selection */
   ::selection {
-    background: var(--color-ink-200);
-    color: var(--color-ink-900);
-  }
-  .dark ::selection {
-    background: var(--color-ink-800);
-    color: var(--color-ink-100);
+    background: var(--grove-muted);
+    color: var(--grove-foreground);
   }
 
   /* Slim, neutral scrollbar */
   * {
     scrollbar-width: thin;
-    scrollbar-color: var(--color-ink-300) transparent;
+    scrollbar-color: var(--grove-border) transparent;
   }
   *::-webkit-scrollbar {
     width: 8px;
     height: 8px;
   }
   *::-webkit-scrollbar-thumb {
-    background: var(--color-ink-200);
+    background: var(--grove-border);
     border-radius: 4px;
   }
-  .dark *::-webkit-scrollbar-thumb {
-    background: var(--color-ink-800);
-  }
 
   input,
   select,
@@ -207,26 +294,47 @@
  * ────────────────────────────────────────────────────────────────── */
 .grove-prose {
   max-width: 72ch;
-  color: var(--color-ink-700);
-  font-size: 0.9375rem;
+  color: var(--color-ink-800);
+  font-size: 15px;
   line-height: 1.75;
 }
 
 .dark .grove-prose {
-  color: var(--color-ink-200);
+  color: var(--color-ink-300);
 }
 
 .grove-prose :where(h1, h2, h3, h4) {
   margin: 1.75em 0 0.65em;
   color: var(--color-ink-900);
-  font-weight: 650;
-  line-height: 1.25;
+  font-weight: 500;
+  letter-spacing: -0.025em;
 }
 
 .dark .grove-prose :where(h1, h2, h3, h4) {
   color: var(--color-ink-100);
 }
 
+.grove-prose h1 {
+  font-size: 1.875rem;
+  font-weight: 600;
+  line-height: 2.25rem;
+}
+
+.grove-prose h2 {
+  font-size: 1.25rem;
+  line-height: 1.75rem;
+}
+
+.grove-prose h3 {
+  font-size: 1.125rem;
+  line-height: 1.75rem;
+}
+
+.grove-prose h4 {
+  font-size: 1rem;
+  line-height: 1.5rem;
+}
+
 .grove-prose :where(p, ul, ol, pre, blockquote) {
   margin: 1em 0;
 }
@@ -236,9 +344,16 @@
 }
 
 .grove-prose a {
-  color: var(--color-accent);
+  color: var(--color-ink-900);
+  font-weight: 500;
   text-decoration: underline;
   text-underline-offset: 0.18em;
+  text-decoration-color: var(--color-ink-500);
+}
+
+.dark .grove-prose a {
+  color: var(--color-ink-50);
+  text-decoration-color: var(--color-ink-400);
 }
 
 .grove-prose :where(code, pre) {

package/src/theme.test.ts

@@ -0,0 +1,52 @@
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { describe, expect, it } from "vitest";
+
+const astroTheme = readFileSync(resolve(import.meta.dirname, "styles.css"), "utf8");
+const scaffoldTheme = readFileSync(
+  resolve(import.meta.dirname, "../templates/default/src/styles/global.css"),
+  "utf8",
+);
+
+describe("Astro theme contract", () => {
+  it("keeps Starlight's light and dark foundation values", () => {
+    expect(astroTheme).toContain("--grove-background: oklch(100% 0 0)");
+    expect(astroTheme).toContain("--grove-foreground: var(--color-ink-950)");
+    expect(astroTheme).toContain("--grove-background: var(--color-ink-950)");
+    expect(astroTheme).toContain("--grove-foreground: var(--color-ink-50)");
+    expect(astroTheme).toContain("--color-ink-50: oklch(98.5% 0 0)");
+    expect(astroTheme).toContain("--color-ink-950: oklch(14.5% 0 0)");
+  });
+
+  it("exposes runtime semantic colors to Tailwind", () => {
+    for (const token of [
+      "background",
+      "foreground",
+      "primary",
+      "secondary",
+      "muted",
+      "accent",
+      "border",
+      "card",
+      "popover",
+    ]) {
+      expect(astroTheme).toContain(`--color-${token}: var(--grove-${token})`);
+    }
+  });
+
+  it("uses the same system and mono font stacks as the docs", () => {
+    expect(astroTheme).toContain(
+      '--font-sans: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto,',
+    );
+    expect(astroTheme).toContain(
+      "--font-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas,",
+    );
+    expect(astroTheme).toContain("font-family: var(--font-sans)");
+  });
+
+  it("does not duplicate package-owned foundation tokens in the scaffold", () => {
+    expect(scaffoldTheme).not.toContain("--color-ink-");
+    expect(scaffoldTheme).not.toContain("font-family:");
+    expect(scaffoldTheme).not.toContain("color-scheme:");
+  });
+});

package/templates/default/package.json

@@ -25,7 +25,7 @@
   },
   "dependencies": {
     "@astrojs/check": "^0.9.9",
-    "@grove-dev/astro": "0.2.16",
+    "@grove-dev/astro": "0.2.18",
     "@grove-dev/cli": "0.2.16",
     "@grove-dev/core": "0.2.16",
     "@tailwindcss/vite": "^4.3.0",

package/templates/default/public/llms-full.txt

@@ -1,6 +1,6 @@
 # example.com — full directory
 
-Generated: 2026-06-17T13:40:59.793Z
+Generated: 2026-06-22T14:50:54.564Z
 Records: 8
 
 ---

package/templates/default/public/sitemap.xml

@@ -2,61 +2,61 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
   <url>
     <loc>https://example.com/</loc>
-    <lastmod>2026-06-17T13:40:59.064Z</lastmod>
+    <lastmod>2026-06-22T14:50:53.941Z</lastmod>
     <changefreq>daily</changefreq>
     <priority>1.0</priority>
   </url>
   <url>
     <loc>https://example.com/projects</loc>
-    <lastmod>2026-06-17T13:40:59.064Z</lastmod>
+    <lastmod>2026-06-22T14:50:53.941Z</lastmod>
     <changefreq>daily</changefreq>
     <priority>0.9</priority>
   </url>
   <url>
     <loc>https://example.com/projects/coolify</loc>
-    <lastmod>2026-06-17T13:40:59.064Z</lastmod>
+    <lastmod>2026-06-22T14:50:53.941Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.7</priority>
   </url>
   <url>
     <loc>https://example.com/projects/gitea</loc>
-    <lastmod>2026-06-17T13:40:59.064Z</lastmod>
+    <lastmod>2026-06-22T14:50:53.941Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.7</priority>
   </url>
   <url>
     <loc>https://example.com/projects/hoppscotch</loc>
-    <lastmod>2026-06-17T13:40:59.064Z</lastmod>
+    <lastmod>2026-06-22T14:50:53.941Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.7</priority>
   </url>
   <url>
     <loc>https://example.com/projects/inventree</loc>
-    <lastmod>2026-06-17T13:40:59.064Z</lastmod>
+    <lastmod>2026-06-22T14:50:53.941Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.7</priority>
   </url>
   <url>
     <loc>https://example.com/projects/label-studio</loc>
-    <lastmod>2026-06-17T13:40:59.064Z</lastmod>
+    <lastmod>2026-06-22T14:50:53.941Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.7</priority>
   </url>
   <url>
     <loc>https://example.com/projects/logseq</loc>
-    <lastmod>2026-06-17T13:40:59.064Z</lastmod>
+    <lastmod>2026-06-22T14:50:53.941Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.7</priority>
   </url>
   <url>
     <loc>https://example.com/projects/private-gpt</loc>
-    <lastmod>2026-06-17T13:40:59.064Z</lastmod>
+    <lastmod>2026-06-22T14:50:53.941Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.7</priority>
   </url>
   <url>
     <loc>https://example.com/projects/wakapi</loc>
-    <lastmod>2026-06-17T13:40:59.064Z</lastmod>
+    <lastmod>2026-06-22T14:50:53.941Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.7</priority>
   </url>

package/templates/default/src/pages/[slug]/index.astro

@@ -7,7 +7,6 @@
  *   - RefinePanel  (Stack / Platform / Category / License / Sort)
  *   - RecordSection rows (full record cards; the `ItemSection` V0
  *     name was renamed to `RecordSection` in V1)
- *   - ExploreByCategory / ExploreByStack (compact pill lists)
  *
  * Generic: the URL slug (e.g. `/projects/`, `/resources/`,
  * `/entities/`) is derived from the blueprint via `getStaticPaths`,
@@ -28,14 +27,10 @@ import SmartLensTabs from "@grove-dev/astro/components/SmartLensTabs.astro";
 import RefinePanel from "@grove-dev/astro/components/RefinePanel.astro";
 import IndexRow from "@grove-dev/astro/components/IndexRow.astro";
 import Pagination from "@grove-dev/astro/components/Pagination.astro";
-import ExploreByCategory from "@grove-dev/astro/components/ExploreByCategory.astro";
-import ExploreByStack from "@grove-dev/astro/components/ExploreByStack.astro";
 import {
   activeFilterChips,
   applySort,
   buildFacets,
-  countByCategory,
-  countByStack,
   effectivePage,
   effectiveSort,
   filterRecords,
@@ -70,16 +65,6 @@ const chips = activeFilterChips(filters);
 const title = `Browse ${slug} — ${siteConfig.name}`;
 const description = `A searchable directory of ${itemLabelPlural()} for ${siteConfig.name}.`;
 
-// Compute the top categories and stacks for the explore pills
-const categoryEntries = [...countByCategory(items as Parameters<typeof countByCategory>[0]).entries()]
-  .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
-  .slice(0, 12)
-  .map(([name, count]) => ({ name, slug: name, count }));
-const stackEntries = [...countByStack(items as Parameters<typeof countByStack>[0]).entries()]
-  .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
-  .slice(0, 18)
-  .map(([name, count]) => ({ name, slug: name, count }));
-
 function hrefForPage(target: number): string {
   const next: IndexFilters = { ...filters, page: target };
   const query = searchParamsFromFilters(next).toString();
@@ -207,20 +192,6 @@ function hrefForRemove(key: keyof IndexFilters, value: string): string {
     </div>
   </section>
 
-  {categoryEntries.length > 0 && (
-    <ExploreByCategory
-      categories={categoryEntries}
-      pathPrefix={`/${slug}`}
-    />
-  )}
-
-  {stackEntries.length > 0 && (
-    <ExploreByStack
-      stacks={stackEntries}
-      pathPrefix={`/${slug}`}
-    />
-  )}
-
   <section class="grove-section-tight">
     <div class="grove-container-wide mx-auto px-5 sm:px-7">
       <header class="mb-6">

package/templates/default/src/styles/global.css

@@ -5,26 +5,22 @@
  * at scaffold time; we expose the same names as CSS variables so
  * consumers can layer their own brand colors in without forking.
  *
- * The `ink-*` color scale is preserved from the V0 template because
- * the page-level classes (`text-ink-900`, `bg-ink-50`, ...) still
- * reference it. New pages should prefer the default Tailwind
- * `gray-*` / `slate-*` palettes; the ink scale exists for
- * back-compat with the V1 minimal template.
+ * The package owns the Starlight-aligned palette, semantic theme tokens,
+ * font stacks, and light/dark base styles. This consumer sheet contains
+ * only scaffold-level overrides so those foundations cannot drift when
+ * the package theme changes.
+ *
+ * NOTE: do NOT add `@custom-variant dark` here. `@grove-dev/astro`'s
+ * `styles.css` already declares the `.dark`-class variant, and
+ * Tailwind v4 only honors one definition per build — adding a
+ * second one in this consumer file has been observed to confuse
+ * the variant resolution and produce utilities that key off
+ * `prefers-color-scheme` instead of the `.dark` class on <html>.
+ * The net effect: `<html class="dark">` is set but the page stays
+ * in light mode because the `dark:` utilities never match.
  */
 @theme {
-  --color-ink-50: #fafafa;
-  --color-ink-100: #f4f4f5;
-  --color-ink-200: #e4e4e7;
-  --color-ink-300: #d4d4d8;
-  --color-ink-400: #a1a1aa;
-  --color-ink-500: #71717a;
-  --color-ink-600: #52525b;
-  --color-ink-700: #3f3f46;
-  --color-ink-800: #27272a;
-  --color-ink-900: #18181b;
-  --color-ink-950: #09090b;
-
-  --color-grove-primary: #16a34a;
+  --color-grove-primary: var(--color-foreground);
 }
 
 @layer base {
@@ -33,26 +29,5 @@
     --grove-radius: 0.5rem;
     --grove-container-width: 72rem;
 
-    color-scheme: light dark;
-  }
-
-  html {
-    -webkit-text-size-adjust: 100%;
-    -webkit-font-smoothing: antialiased;
-    -moz-osx-font-smoothing: grayscale;
-  }
-
-  body {
-    background: #ffffff;
-    color: var(--color-ink-900);
-    font-family: ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto,
-      "Helvetica Neue", Arial, sans-serif;
-    font-size: 15px;
-    line-height: 1.55;
-  }
-
-  body.dark {
-    background: var(--color-ink-950);
-    color: var(--color-ink-100);
   }
 }

package/templates/default/tailwind.config.mjs

@@ -1,130 +0,0 @@
-/** @type {import('tailwindcss').Config} */
-export default {
-  content: ['./src/**/*.{astro,html,js,jsx,ts,tsx,md,mdx}'],
-  // Use a `.dark` class on <html> (toggled by the theme script in
-  // the document head) rather than the OS media query, so a manual
-  // theme switcher can override the user's system preference.
-  darkMode: 'class',
-  theme: {
-    // Disable default palette so we only ship our own neutral / accent
-    // tokens. Keeps the bundle small and forces a unified look.
-    colors: {
-      transparent: 'transparent',
-      current: 'currentColor',
-      white: '#ffffff',
-      black: '#000000',
-      ink: {
-        50: '#fafafa',
-        100: '#f4f4f5',
-        200: '#e4e4e7',
-        300: '#d4d4d8',
-        400: '#a1a1aa',
-        500: '#71717a',
-        600: '#52525b',
-        700: '#3f3f46',
-        800: '#27272a',
-        900: '#18181b',
-        950: '#09090b',
-      },
-      accent: {
-        DEFAULT: '#1f6feb',
-        muted: '#388bfd1a',
-      },
-      emerald: {
-        50: '#ecfdf5',
-        300: '#6ee7b7',
-        400: '#34d399',
-        700: '#047857',
-        800: '#065f46',
-        950: '#022c22',
-      },
-      orange: {
-        50: '#fff7ed',
-        300: '#fdba74',
-        400: '#fb923c',
-        700: '#c2410c',
-        800: '#9a3412',
-        950: '#431407',
-      },
-      blue: {
-        50: '#eff6ff',
-        300: '#93c5fd',
-        400: '#60a5fa',
-        700: '#1d4ed8',
-        800: '#1e40af',
-        950: '#172554',
-      },
-      amber: {
-        50: '#fffbeb',
-        300: '#fcd34d',
-        400: '#fbbf24',
-        700: '#b45309',
-        800: '#92400e',
-        950: '#451a03',
-      },
-    },
-    extend: {
-      fontFamily: {
-        sans: [
-          'ui-sans-serif',
-          'system-ui',
-          '-apple-system',
-          'BlinkMacSystemFont',
-          '"Segoe UI"',
-          'Roboto',
-          '"Helvetica Neue"',
-          'Arial',
-          'sans-serif',
-        ],
-        mono: [
-          'ui-monospace',
-          'SFMono-Regular',
-          'Menlo',
-          'Monaco',
-          'Consolas',
-          '"Liberation Mono"',
-          '"Courier New"',
-          'monospace',
-        ],
-      },
-      fontSize: {
-        '2xs': ['0.6875rem', { lineHeight: '1rem' }],
-      },
-      maxWidth: {
-        container: '1140px',
-        wide: '1400px',
-        narrow: '720px',
-      },
-      borderRadius: {
-        DEFAULT: '0.375rem',
-        lg: '0.5rem',
-        xl: '0.75rem',
-      },
-      keyframes: {
-        'fade-in-up': {
-          '0%': { opacity: '0', transform: 'translateY(8px)' },
-          '100%': { opacity: '1', transform: 'translateY(0)' },
-        },
-        'fade-in': {
-          '0%': { opacity: '0' },
-          '100%': { opacity: '1' },
-        },
-        'gradient-shift': {
-          '0%, 100%': { 'background-position': '0% 50%' },
-          '50%': { 'background-position': '100% 50%' },
-        },
-        'subtle-bob': {
-          '0%, 100%': { transform: 'translateY(0)' },
-          '50%': { transform: 'translateY(-2px)' },
-        },
-      },
-      animation: {
-        'fade-in-up': 'fade-in-up 0.6s ease-out both',
-        'fade-in': 'fade-in 0.8s ease-out both',
-        'gradient-shift': 'gradient-shift 8s ease-in-out infinite',
-        'subtle-bob': 'subtle-bob 3s ease-in-out infinite',
-      },
-    },
-  },
-  plugins: [],
-};