@grove-dev/astro 0.2.19 → 0.3.1

package/src/template-routes.test.ts

@@ -0,0 +1,103 @@
+import { describe, expect, it } from "vitest";
+import { readFile, stat } from "node:fs/promises";
+import { resolve } from "node:path";
+
+const pagesDir = resolve(import.meta.dirname, "../templates/default/src/pages");
+
+describe("default Astro route configuration", () => {
+  it("ships TypeScript settings that resolve package exports and Node built-ins", async () => {
+    const templateRoot = resolve(pagesDir, "../..");
+    const tsconfig = JSON.parse(
+      await readFile(resolve(templateRoot, "tsconfig.json"), "utf8"),
+    ) as {
+      extends?: string;
+      compilerOptions?: {
+        moduleResolution?: string;
+        types?: string[];
+      };
+    };
+    const manifest = JSON.parse(
+      await readFile(resolve(templateRoot, "package.json"), "utf8"),
+    ) as { devDependencies?: Record<string, string> };
+
+    expect(tsconfig.extends).toBe("astro/tsconfigs/base");
+    expect(tsconfig.compilerOptions?.moduleResolution).toBe("Bundler");
+    expect(tsconfig.compilerOptions?.types).toContain("node");
+    expect(manifest.devDependencies?.["@types/node"]).toMatch(/^\^/);
+  });
+
+  it("treats generated JSON as an untyped boundary before applying payload types", async () => {
+    const recordsModule = await readFile(
+      resolve(pagesDir, "../data/records.ts"),
+      "utf8",
+    );
+
+    expect(recordsModule).toContain(
+      "fullPayload as unknown as FullPayload",
+    );
+  });
+
+  it("derives the directory route from generated site config", async () => {
+    const listPage = await readFile(resolve(pagesDir, "[slug]/index.astro"), "utf8");
+
+    expect(listPage).toContain("siteConfig.blueprintConfig?.routeSlug");
+  });
+
+  it("does not generate the legacy apps alias when apps is canonical", async () => {
+    const aliasPage = await readFile(resolve(pagesDir, "apps/[recordSlug].astro"), "utf8");
+
+    expect(aliasPage).toContain('if (indexSlug() === "apps")');
+    expect(aliasPage).toContain("return []");
+  });
+
+  it("renders consumer-authored about Markdown through the default page", async () => {
+    const aboutPage = await readFile(resolve(pagesDir, "about.astro"), "utf8");
+
+    expect(aboutPage).toContain('getPageContentHtml("about")');
+  });
+
+  it("generates submission drafts accepted by the Grove record schema", async () => {
+    const submitPage = await readFile(resolve(pagesDir, "submit.astro"), "utf8");
+
+    expect(submitPage).toContain('"  type: manual"');
+    expect(submitPage).not.toContain('"  type: github"');
+  });
+
+  it("keeps generic maintenance behavior in Grove instead of consumer scripts", async () => {
+    const templateRoot = resolve(pagesDir, "../..");
+    const manifest = JSON.parse(
+      await readFile(resolve(templateRoot, "package.json"), "utf8"),
+    ) as { scripts?: Record<string, string> };
+    const scriptsDirExists = await stat(resolve(templateRoot, "scripts"))
+      .then(() => true)
+      .catch(() => false);
+
+    expect(manifest.scripts?.["build:llms"]).toBe("grove llms");
+    expect(manifest.scripts?.["sync:contributors"]).toBe(
+      "grove sync contributors",
+    );
+    expect(scriptsDirExists).toBe(false);
+  });
+
+  it("hydrates static list pages with URL-driven search and pagination", async () => {
+    const listPage = await readFile(resolve(pagesDir, "[slug]/index.astro"), "utf8");
+
+    expect(listPage).toContain('id="grove-index-data"');
+    expect(listPage).toContain("function applyClientFilters()");
+    expect(listPage).toContain("const PAGE_SIZE = 20");
+  });
+
+  it("uses generated taxonomy names as display labels", async () => {
+    const recordsModule = await readFile(
+      resolve(pagesDir, "../data/records.ts"),
+      "utf8",
+    );
+    const homePage = await readFile(resolve(pagesDir, "index.astro"), "utf8");
+    const listPage = await readFile(resolve(pagesDir, "[slug]/index.astro"), "utf8");
+
+    expect(recordsModule).toContain("export function taxonomyLabel");
+    expect(recordsModule).toContain("?? prettySlug(id)");
+    expect(homePage).toContain('taxonomyLabel("categories"');
+    expect(listPage).toContain("labelFacetsWithTaxonomy");
+  });
+});

package/src/theme.test.ts

@@ -7,6 +7,15 @@ const scaffoldTheme = readFileSync(
   resolve(import.meta.dirname, "../templates/default/src/styles/global.css"),
   "utf8",
 );
+const tailwindMarkup = [
+  "components/ItemCard.astro",
+  "layouts/Header.astro",
+  "../templates/default/src/pages/submit.astro",
+].map((file) => readFileSync(resolve(import.meta.dirname, file), "utf8")).join("\n");
+const iconMarkup = readFileSync(
+  resolve(import.meta.dirname, "components/Icon.astro"),
+  "utf8",
+);
 
 describe("Astro theme contract", () => {
   it("keeps Starlight's light and dark foundation values", () => {
@@ -49,4 +58,19 @@ describe("Astro theme contract", () => {
     expect(scaffoldTheme).not.toContain("font-family:");
     expect(scaffoldTheme).not.toContain("color-scheme:");
   });
+
+  it("styles components in HTML with Starlight-aligned Tailwind utilities", () => {
+    expect(tailwindMarkup).toContain("rounded-[calc(var(--radius)+0.25rem)]");
+    expect(tailwindMarkup).toContain("rounded-full");
+    expect(tailwindMarkup).toContain("min-h-5");
+    expect(tailwindMarkup).toContain("h-8");
+    expect(tailwindMarkup).toContain("focus-visible:ring-3");
+    expect(astroTheme).not.toContain(".grove-card");
+    expect(astroTheme).not.toContain(".grove-btn");
+  });
+
+  it("falls back to initials when a consumer has no matching icon asset", () => {
+    expect(iconMarkup).toContain("data-grove-icon-fallback-initials");
+    expect(iconMarkup).toContain("onerror=");
+  });
 });

package/templates/default/.github/workflows/build.yml

@@ -18,12 +18,10 @@ jobs:
       - uses: actions/checkout@v4
 
       - uses: pnpm/action-setup@v4
-        with:
-          version: 10
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: "24"
           cache: pnpm
 
       - name: Install dependencies

package/templates/default/.github/workflows/cleanup-stale-records.yml

@@ -19,12 +19,10 @@ jobs:
       - uses: actions/checkout@v4
 
       - uses: pnpm/action-setup@v4
-        with:
-          version: 10
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: "24"
           cache: pnpm
 
       - name: Install dependencies

package/templates/default/.github/workflows/daily-refresh.yml

@@ -20,12 +20,10 @@ jobs:
       - uses: actions/checkout@v4
 
       - uses: pnpm/action-setup@v4
-        with:
-          version: 10
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: "24"
           cache: pnpm
 
       - name: Install dependencies

package/templates/default/.github/workflows/sync-contributors.yml

@@ -17,12 +17,10 @@ jobs:
       - uses: actions/checkout@v4
 
       - uses: pnpm/action-setup@v4
-        with:
-          version: 10
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: "24"
           cache: pnpm
 
       - name: Install dependencies
@@ -38,7 +36,7 @@ jobs:
       - name: Sync contributors from GitHub
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: node scripts/sync-contributors.mjs
+        run: pnpm exec grove sync contributors
 
       - name: Commit contributors.json
         run: |

package/templates/default/.github/workflows/sync-github-metadata.yml

@@ -25,12 +25,10 @@ jobs:
       - uses: actions/checkout@v4
 
       - uses: pnpm/action-setup@v4
-        with:
-          version: 10
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: "24"
           cache: pnpm
 
       - name: Install dependencies

package/templates/default/.github/workflows/validate-data.yml

@@ -15,12 +15,10 @@ jobs:
       - uses: actions/checkout@v4
 
       - uses: pnpm/action-setup@v4
-        with:
-          version: 10
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: "24"
           cache: pnpm
 
       - name: Install dependencies

package/templates/default/grove.config.ts

@@ -25,7 +25,7 @@ export default defineConfig({
 
   facets: ["category", "stacks", "platforms", "tags"],
 
-  integrations: {},
+  integrations: { github: false },
 
   theme: {
     primaryColor: "#1f6feb",

package/templates/default/package.json

@@ -13,7 +13,7 @@
     "validate:data": "grove validate",
     "build:data": "grove generate",
     "build:sitemap": "grove sitemap",
-    "build:llms": "node scripts/build-llms.mjs",
+    "build:llms": "grove llms",
     "build": "pnpm run build:data && pnpm run build:sitemap && pnpm run build:llms && astro build",
     "dev": "pnpm run build:data && astro dev",
     "start": "astro dev",
@@ -21,18 +21,23 @@
     "astro": "astro",
     "check": "astro check",
     "sync:github": "grove sync github",
+    "sync:contributors": "grove sync contributors",
     "cleanup": "grove cleanup stale"
   },
   "dependencies": {
     "@astrojs/check": "^0.9.9",
-    "@grove-dev/astro": "0.2.18",
-    "@grove-dev/cli": "0.2.16",
-    "@grove-dev/core": "0.2.16",
+    "@grove-dev/astro": "workspace:*",
+    "@grove-dev/cli": "workspace:*",
+    "@grove-dev/core": "workspace:*",
     "@tailwindcss/vite": "^4.3.0",
     "astro": "^6.4.4",
     "marked": "^18.0.0",
     "sanitize-html": "^2.17.5",
     "tailwindcss": "^4.3.0",
     "yaml": "^2.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.2",
+    "@types/sanitize-html": "^2.16.0"
   }
 }

package/templates/default/public/icons/stacks/rag.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" fill="none">
+  <rect width="100" height="100" rx="18" fill="#0F172A"/>
+  <path d="M29 28h42v13H29zM29 59h42v13H29z" stroke="#38BDF8" stroke-width="4" stroke-linejoin="round"/>
+  <path d="M50 41v18M42 50h16" stroke="#A78BFA" stroke-width="4" stroke-linecap="round"/>
+  <circle cx="36" cy="34.5" r="2.5" fill="#38BDF8"/>
+  <circle cx="36" cy="65.5" r="2.5" fill="#38BDF8"/>
+</svg>

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

@@ -1,206 +1,83 @@
-# example.com — full directory
+# Grove Directory — full directory
 
-Generated: 2026-06-22T14:50:54.564Z
-Records: 8
+> Generated 2026-07-01T16:50:32.236Z from 8 records.
+> Source: https://example.com/projects · Regenerate with `grove generate`.
 
----
+Each section below mirrors one record detail page.
 
-## Coolify
+## Index
 
-Open-source, self-hostable Heroku / Netlify / Vercel alternative — deploy apps and databases from a single dashboard.
-
-- **URL**: https://example.com/coolify
-- **Repository**: https://github.com/coollabsio/coolify
-- **Stack**: SvelteKit
-- **Platforms**: linux, self-host
-- **Category**: DevOps
-- **Tags**: self-host, paas, deployment, svelte
-- **Stars**: 0
-- **Last commit**: —
-
-**Best for:**
-- Self-hosted PaaS
-- VPS deployments
-- Docker-based stacks
+- [Coolify](#coolify) — DevOps · SvelteKit · 0★ — Open-source, self-hostable Heroku / Netlify / Vercel alternative — deploy apps and databases from a single dashboard.
+- [Gitea](#gitea) — DevOps · Go · 0★ — Lightweight, self-hosted Git service — painless, single-binary, low-resource alternative to GitHub.
+- [Hoppscotch](#hoppscotch) — Web · Vue · 0★ — Open-source API development ecosystem — design, test, and debug APIs faster from a single interface.
+- [InvenTree](#inventree) — Mobile · Flutter · 0★ — Open-source inventory management system with parts, stock, and purchase orders.
+- [Label Studio](#label-studio) — AI/ML · Python · 0★ — Open-source data labeling platform — annotate images, text, audio, video, and time series for ML training.
+- [Logseq](#logseq) — Web · ClojureScript · 0★ — Privacy-first, open-source knowledge base that works on top of plain text Markdown and Org-mode files.
+- [PrivateGPT](#private-gpt) — AI/ML · Python · 0★ — Interact privately with your documents using LLMs — 100% private, no data leaves your execution environment.
+- [Wakapi](#wakapi) — Mobile · Kotlin · 0★ — Open-source time tracker for developers — coding stats, language breakdowns, and project-level metrics.
 
-**Why listed:**
-- One-click app + DB deploys
-- Active dev
-- Clear upgrade path from manual Docker
+## Projects
 
----
-
-## Gitea
+### Coolify
+Open-source, self-hostable Heroku / Netlify / Vercel alternative — deploy apps and databases from a single dashboard.
+- slug: coolify
+- category: DevOps
+- stack: SvelteKit
+- stars: 0
+- url: https://example.com/projects/coolify
 
+### Gitea
 Lightweight, self-hosted Git service — painless, single-binary, low-resource alternative to GitHub.
+- slug: gitea
+- category: DevOps
+- stack: Go
+- stars: 0
+- url: https://example.com/projects/gitea
 
-- **URL**: https://example.com/gitea
-- **Repository**: https://github.com/go-gitea/gitea
-- **Stack**: Go
-- **Platforms**: linux, self-host, docker
-- **Category**: DevOps
-- **Tags**: git, forge, self-host, go
-- **Stars**: 0
-- **Last commit**: —
-
-**Best for:**
-- Self-hosted Git hosting
-- Lightweight CI/CD integration
-- Internal team forges
-
-**Why listed:**
-- Single binary, easy install
-- Mature, stable releases
-- Active community
-
----
-
-## Hoppscotch
-
+### Hoppscotch
 Open-source API development ecosystem — design, test, and debug APIs faster from a single interface.
+- slug: hoppscotch
+- category: Web
+- stack: Vue
+- stars: 0
+- url: https://example.com/projects/hoppscotch
 
-- **URL**: https://example.com/hoppscotch
-- **Repository**: https://github.com/hoppscotch/hoppscotch
-- **Stack**: Vue
-- **Platforms**: web, desktop, self-host
-- **Category**: Web
-- **Tags**: api, testing, developer-tools, vue
-- **Stars**: 0
-- **Last commit**: —
-
-**Best for:**
-- API exploration
-- REST/GraphQL/WebSocket testing
-- Self-hosted team workflows
-
-**Why listed:**
-- Lightweight, fast UI
-- PWA + desktop builds
-- Open-source Postman/Insomnia alternative
-
----
-
-## InvenTree
-
+### InvenTree
 Open-source inventory management system with parts, stock, and purchase orders.
+- slug: inventree
+- category: Mobile
+- stack: Flutter
+- stars: 0
+- url: https://example.com/projects/inventree
 
-- **URL**: https://example.com/inventree
-- **Repository**: https://github.com/inventree/InvenTree
-- **Stack**: Flutter
-- **Platforms**: ios, android, web
-- **Category**: Mobile
-- **Tags**: inventory, stock, mobile, dart, flutter
-- **Stars**: 0
-- **Last commit**: —
-
-**Best for:**
-- Inventory tracking
-- Manufacturing
-- Hardware projects
-
-**Why listed:**
-- Production-grade mobile + web stack
-- Strong community
-- Cleanly factored Dart codebase
-
----
-
-## Label Studio
-
+### Label Studio
 Open-source data labeling platform — annotate images, text, audio, video, and time series for ML training.
+- slug: label-studio
+- category: AI/ML
+- stack: Python
+- stars: 0
+- url: https://example.com/projects/label-studio
 
-- **URL**: https://example.com/label-studio
-- **Repository**: https://github.com/HumanSignal/label-studio
-- **Stack**: Python
-- **Platforms**: web, self-host
-- **Category**: AI/ML
-- **Tags**: labeling, ml-ops, annotation, python
-- **Stars**: 0
-- **Last commit**: —
-
-**Best for:**
-- ML dataset labeling
-- Multi-modal annotation
-- Active learning pipelines
-
-**Why listed:**
-- Mature, production-grade
-- Strong ML backend
-- Active commercial + community backing
-
----
-
-## Logseq
-
+### Logseq
 Privacy-first, open-source knowledge base that works on top of plain text Markdown and Org-mode files.
+- slug: logseq
+- category: Web
+- stack: ClojureScript
+- stars: 0
+- url: https://example.com/projects/logseq
 
-- **URL**: https://example.com/logseq
-- **Repository**: https://github.com/logseq/logseq
-- **Stack**: ClojureScript
-- **Platforms**: web, desktop
-- **Category**: Web
-- **Tags**: notes, knowledge-base, productivity, clojure
-- **Stars**: 0
-- **Last commit**: —
-
-**Best for:**
-- PKM (personal knowledge management)
-- Local-first note taking
-- Graph-based outliner
-
-**Why listed:**
-- Local-first with sync
-- Active community
-- Strong plugin ecosystem
-
----
-
-## PrivateGPT
-
+### PrivateGPT
 Interact privately with your documents using LLMs — 100% private, no data leaves your execution environment.
+- slug: private-gpt
+- category: AI/ML
+- stack: Python
+- stars: 0
+- url: https://example.com/projects/private-gpt
 
-- **URL**: https://example.com/private-gpt
-- **Repository**: https://github.com/zylon-ai/private-gpt
-- **Stack**: Python
-- **Platforms**: linux, macos, self-host
-- **Category**: AI/ML
-- **Tags**: llm, rag, privacy, python
-- **Stars**: 0
-- **Last commit**: —
-
-**Best for:**
-- Private document Q&A
-- Local LLM experimentation
-- Enterprise privacy use cases
-
-**Why listed:**
-- Strict no-network mode
-- Pluggable LLM providers
-- Clean ingestion pipeline
-
----
-
-## Wakapi
-
+### Wakapi
 Open-source time tracker for developers — coding stats, language breakdowns, and project-level metrics.
-
-- **URL**: https://example.com/wakapi
-- **Repository**: https://github.com/muety/wakapi
-- **Stack**: Kotlin
-- **Platforms**: android
-- **Category**: Mobile
-- **Tags**: time-tracking, analytics, mobile, kotlin
-- **Stars**: 0
-- **Last commit**: —
-
-**Best for:**
-- Personal coding stats
-- WakaTime alternative
-- Privacy-first telemetry
-
-**Why listed:**
-- Self-host friendly
-- Companion mobile app
-- Clean MVVM architecture
-
----
+- slug: wakapi
+- category: Mobile
+- stack: Kotlin
+- stars: 0
+- url: https://example.com/projects/wakapi

package/templates/default/public/llms.txt

@@ -1,112 +1,11 @@
 # Grove Directory
 
-Grove Directory is a curated, health-aware developer directory powered by
-the Grove framework. Every entry is real, runnable, and actively
-maintained — not an SDK, not a template, not a toy demo.
+A curated, health-aware developer directory powered by Grove.
 
-The directory is built from plain YAML files in the consumer's
-repository. The build pipeline renders a static Astro site. No
-database, no JavaScript framework, no CDN with sticky sessions.
+Directory: https://example.com/projects
+Records indexed: 8
+Categories: 4
 
-## Main URLs
+## Usage
 
-- Home: https://example.com/
-- Browse: https://example.com/projects
-- About: https://example.com/about
-- Contributors: https://example.com/contributors
-- Submit a record: https://example.com/submit
-
-## Filter views (one URL = one curated lens)
-
-- Trending: https://example.com/projects?label=hot
-- Recently added: https://example.com/projects?label=new
-- Established (mature): https://example.com/projects?label=mature
-- Featured: https://example.com/projects?label=featured
-- Good to learn: https://example.com/projects?lens=good-to-learn
-- Production-like: https://example.com/projects?lens=production-like
-- Beginner-friendly: https://example.com/projects?lens=beginner-friendly
-- Contribution-ready: https://example.com/projects?lens=contribution-ready
-
-## Browse axes
-
-- By stack: https://example.com/projects (use the `stack` query param)
-- By category: https://example.com/projects (use the `category` query param)
-- By platform: https://example.com/projects (use the `platform` query param)
-- By license: https://example.com/projects (use the `license` query param)
-- By health: https://example.com/projects (use the `status` query param)
-
-## What the directory contains
-
-- Real, runnable open-source records (projects, resources, entities)
-- Stack, language, and architecture at a glance
-- Activity, health signals, and maturity tiers
-- License, stars, and contribution readiness
-- Curated notes: best for, why listed, caveats
-- Filters by stack, platform, license, and status
-
-## Data layout (for AI agents that want to ingest the catalog)
-
-- `data/records/*.yml` — human-edited source of truth (one file per record)
-- `data/taxonomy/categories.yml` — 16 categories (Productivity, Finance, …)
-- `data/taxonomy/stacks.yml` — 6 stacks (Flutter, React Native, …)
-- `data/taxonomy/platforms.yml` — 7 platforms (iOS, Android, …)
-- `data/taxonomy/distribution-channels.yml` — 11 distribution channels
-- `data/generated/records.full.json` — full record projection
-- `data/generated/records.index.json` — slim list-page projection
-- `data/generated/site-config.json` — blueprint + site metadata
-
-For per-record markdown (one section per record with description, repo,
-stack, platforms, stars, last-commit), see `/llms-full.txt`.
-
-## Blueprint system
-
-Grove supports three blueprints out of the box:
-
-- `project-directory` (default) — `kind: project` records under
-  `/projects/<slug>`. Use this for code-reference showcases.
-- `resource-hub` — `kind: resource` records (datasets, libraries,
-  tools) under `/resources/<slug>`.
-- `ecosystem-map` — `kind: entity` records (companies, foundations,
-  people) under `/entities/<slug>`.
-
-The blueprint is selected in `grove.config.ts` and propagates through
-to every page, route, and component — no per-blueprint forks needed.
-
-## How the build runs
-
-```
-pnpm run build:data    # yml → JSON (grove generate)
-pnpm run build:sitemap # emit public/sitemap.xml (grove sitemap)
-pnpm run build:llms    # emit public/llms-full.txt (committed llms.txt is preserved)
-astro build            # render the static site
-```
-
-## Contributing
-
-Open a PR against `data/records/<slug>.yml`. The build pipeline will
-fail if your record doesn't validate against the blueprint schema.
-Read `grove.config.ts` and the `data/taxonomy/` files for the
-available fields and enum values.
-
-## License
-
-MIT — the directory content, schema, and source code are all
-permissively licensed. The data is yours to fork, mirror, or
-republish; attribution to the original author is appreciated but not
-required.
-
-## Contact
-
-Issues: open a ticket on the consumer repository's issue tracker.
-Pull requests: see `CONTRIBUTING.md` for the workflow.
-
-## LLM-specific guidance
-
-- Per-record markdown: `/llms-full.txt` (generated, ~2,000 lines for
-  ~150 records).
-- Sitemap: `/sitemap.xml` (lists every record's detail URL).
-- robots.txt: explicitly allows GPTBot, ChatGPT-User, ClaudeBot,
-  Claude-Web, anthropic-ai, PerplexityBot, Google-Extended,
-  Applebot-Extended, cohere-ai, CCBot, Amazonbot.
-- Schema: each detail page emits a `SoftwareSourceCode` (or
-  `Dataset` / `Organization`) JSON-LD block for AI crawlers.
+Use /llms-full.txt for record-level details. Prefer detail pages for citations.