@grove-dev/astro 0.2.6 → 0.2.13

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

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" fill="none"><rect width="100" height="100" rx="18" fill="#0F172A"/><circle cx="50" cy="42" r="18" fill="none" stroke="#A78BFA" stroke-width="4"/><circle cx="35" cy="38" r="3" fill="#A78BFA"/><circle cx="65" cy="38" r="3" fill="#A78BFA"/><path d="M40 50 Q50 56 60 50" stroke="#A78BFA" stroke-width="3" fill="none" stroke-linecap="round"/><text x="50" y="82" font-family="ui-sans-serif, system-ui, sans-serif" font-size="16" font-weight="700" fill="#A78BFA" text-anchor="middle">LLM</text></svg>

package/templates/default/public/icons/stacks/node.js.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" fill="none"><rect width="100" height="100" rx="18" fill="#339933"/><path fill="#FFFFFF" d="M30 50c0-4 3-7 7-7s7 3 7 7-3 7-7 7-7-3-7-7zm28 0c0-4 3-7 7-7s7 3 7 7-3 7-7 7-7-3-7-7zm14-22c0-2 1-3 3-3s3 1 3 3-1 3-3 3-3-1-3-3zm0 44c0-2 1-3 3-3s3 1 3 3-1 3-3 3-3-1-3-3z"/><text x="50" y="82" font-family="ui-sans-serif, system-ui, sans-serif" font-size="14" font-weight="700" fill="#FFFFFF" text-anchor="middle">node.js</text></svg>

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

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" fill="none"><rect width="100" height="100" rx="20" fill="#FF3E00"/><path fill="#FFFFFF" d="M50 18c-9 0-17 4.5-22.5 11.5l-6 7.5 6 7.5C33 51.5 41 56 50 56s17-4.5 22.5-11.5l6-7.5-6-7.5C67 22.5 59 18 50 18zm0 28.5c-5.5 0-10-4.5-10-10s4.5-10 10-10 10 4.5 10 10-4.5 10-10 10z"/><text x="50" y="82" font-family="Arial, sans-serif" font-size="14" font-weight="700" fill="#FFFFFF" text-anchor="middle">SVELTE</text></svg>

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

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" fill="none"><path fill="#42B883" d="M75.4 28.7 50 73.3 24.6 28.7h11.3L50 51.1l14.1-22.4z"/><path fill="#35495E" d="M50 73.3 75.4 28.7H89L50 95.1 11 28.7h13.6z"/></svg>

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

@@ -1,14 +1,206 @@
-# Grove Directory — full directory
+# example.com — full directory
 
-> Generated 2026-06-10T15:03:23.841Z from 0 records.
-> Source: https://example.com/projects · Regenerate with `grove generate`.
+Generated: 2026-06-13T10:16:37.910Z
+Records: 8
 
-Each section below mirrors one record detail page.
+---
 
-## Index
+## Coolify
 
+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
 
+**Why listed:**
+- One-click app + DB deploys
+- Active dev
+- Clear upgrade path from manual Docker
 
+---
 
+## Gitea
+
+Lightweight, self-hosted Git service — painless, single-binary, low-resource alternative to GitHub.
+
+- **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
+
+Open-source API development ecosystem — design, test, and debug APIs faster from a single interface.
+
+- **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
+
+Open-source inventory management system with parts, stock, and purchase orders.
+
+- **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
+
+Open-source data labeling platform — annotate images, text, audio, video, and time series for ML training.
+
+- **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
+
+Privacy-first, open-source knowledge base that works on top of plain text Markdown and Org-mode files.
+
+- **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
+
+Interact privately with your documents using LLMs — 100% private, no data leaves your execution environment.
+
+- **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
+
+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
+
+---

package/templates/default/public/llms.txt

@@ -1,11 +1,112 @@
 # Grove Directory
 
-A curated, health-aware developer directory powered by Grove.
+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.
 
-Directory: https://example.com/projects
-Records indexed: 0
-Categories: 0
+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.
 
-## Usage
+## Main URLs
 
-Use /llms-full.txt for record-level details. Prefer detail pages for citations.
+- 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.

package/templates/default/public/sitemap.xml

@@ -0,0 +1,63 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  <url>
+    <loc>https://example.com/</loc>
+    <lastmod>2026-06-13T10:16:37.466Z</lastmod>
+    <changefreq>daily</changefreq>
+    <priority>1.0</priority>
+  </url>
+  <url>
+    <loc>https://example.com/projects</loc>
+    <lastmod>2026-06-13T10:16:37.466Z</lastmod>
+    <changefreq>daily</changefreq>
+    <priority>0.9</priority>
+  </url>
+  <url>
+    <loc>https://example.com/projects/coolify</loc>
+    <lastmod>2026-06-13T10:16:37.466Z</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://example.com/projects/gitea</loc>
+    <lastmod>2026-06-13T10:16:37.466Z</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://example.com/projects/hoppscotch</loc>
+    <lastmod>2026-06-13T10:16:37.466Z</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://example.com/projects/inventree</loc>
+    <lastmod>2026-06-13T10:16:37.466Z</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://example.com/projects/label-studio</loc>
+    <lastmod>2026-06-13T10:16:37.466Z</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://example.com/projects/logseq</loc>
+    <lastmod>2026-06-13T10:16:37.466Z</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://example.com/projects/private-gpt</loc>
+    <lastmod>2026-06-13T10:16:37.466Z</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://example.com/projects/wakapi</loc>
+    <lastmod>2026-06-13T10:16:37.466Z</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+</urlset>

package/templates/default/scripts/build-llms.mjs

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+// SPDX-License-Identifier: MIT
+
+/**
+ * build-llms.mjs — emit `public/llms-full.txt` (per-record
+ * markdown mirror) only.
+ *
+ * `public/llms.txt` is a static file committed to the template —
+ * it does NOT get regenerated by this script. The build pipeline
+ * treats the committed version as the canonical, hand-curated
+ * LLM-facing index. The script only refreshes the per-record
+ * `llms-full.txt` from the latest `data/generated/records.full.json`.
+ *
+ * This is intentional: openapps' `llms.txt` is also a
+ * hand-curated 30+ line document, not an auto-generated stub.
+ *
+ * Usage:  node scripts/build-llms.mjs
+ */
+import { mkdir, readFile, writeFile, access } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = resolve(__dirname, "..");
+const SOURCE = join(ROOT, "data", "generated", "records.full.json");
+const OUT_DIR = join(ROOT, "public");
+const FULL = join(OUT_DIR, "llms-full.txt");
+
+const SITE = process.env.GROVE_SITE ?? "https://example.com";
+
+function compactStars(n) {
+  if (typeof n !== "number" || !Number.isFinite(n)) return "—";
+  if (n >= 1_000_000) return (n / 1_000_000).toFixed(1).replace(/\.0$/, "") + "M";
+  if (n >= 1_000) {
+    const k = n / 1_000;
+    return (k >= 10 ? Math.round(k).toString() : k.toFixed(1).replace(/\.0$/, "")) + "k";
+  }
+  return n.toString();
+}
+
+function relativeTime(iso) {
+  if (!iso) return "—";
+  const d = new Date(iso);
+  if (isNaN(d.valueOf())) return "—";
+  const days = Math.floor((Date.now() - d.valueOf()) / 86_400_000);
+  if (days === 0) return "today";
+  if (days === 1) return "1 day ago";
+  if (days < 30) return `${days} days ago`;
+  if (days < 365) return `${Math.floor(days / 30)} months ago`;
+  return `${Math.floor(days / 365)} years ago`;
+}
+
+function buildFullTxt(records) {
+  const lines = [];
+  lines.push(`# ${SITE.replace(/^https?:\/\//, "")} — full directory`);
+  lines.push("");
+  lines.push(`Generated: ${new Date().toISOString()}`);
+  lines.push(`Records: ${records.length}`);
+  lines.push("");
+  lines.push("---");
+  lines.push("");
+
+  for (const r of records) {
+    const name = r.name ?? r.title ?? r.slug;
+    const stack = r.stack ?? (Array.isArray(r.stacks) ? r.stacks.join(", ") : "");
+    const platforms = Array.isArray(r.platforms) ? r.platforms.join(", ") : "";
+    const tags = Array.isArray(r.tags) ? r.tags.join(", ") : "";
+    const stars = compactStars(r.stars ?? r.github?.stars ?? 0);
+    const updated = relativeTime(r.lastCommitAt ?? r.github?.pushedAt ?? null);
+    const repoUrl = r.repoUrl ?? r.links?.github ?? "";
+    const url = `${SITE.replace(/\/$/, "")}/${r.slug}`;
+    const desc = r.description ?? "";
+
+    lines.push(`## ${name}`);
+    lines.push("");
+    if (desc) lines.push(desc);
+    lines.push("");
+    lines.push(`- **URL**: ${url}`);
+    if (repoUrl) lines.push(`- **Repository**: ${repoUrl}`);
+    if (stack) lines.push(`- **Stack**: ${stack}`);
+    if (platforms) lines.push(`- **Platforms**: ${platforms}`);
+    if (r.category) lines.push(`- **Category**: ${r.category}`);
+    if (tags) lines.push(`- **Tags**: ${tags}`);
+    if (r.license) lines.push(`- **License**: ${r.license}`);
+    lines.push(`- **Stars**: ${stars}`);
+    lines.push(`- **Last commit**: ${updated}`);
+    lines.push("");
+    if (Array.isArray(r.bestFor) && r.bestFor.length) {
+      lines.push("**Best for:**");
+      for (const b of r.bestFor) lines.push(`- ${b}`);
+      lines.push("");
+    }
+    if (Array.isArray(r.whyListed) && r.whyListed.length) {
+      lines.push("**Why listed:**");
+      for (const w of r.whyListed) lines.push(`- ${w}`);
+      lines.push("");
+    }
+    lines.push("---");
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+
+async function main() {
+  if (!(await access(SOURCE).then(() => true).catch(() => false))) {
+    console.error(`No ${SOURCE} found. Run \`grove generate\` first.`);
+    process.exit(1);
+  }
+  const raw = JSON.parse(await readFile(SOURCE, "utf8"));
+  const records = (raw.records ?? []).filter(
+    (r) => r.visibility !== "hide" && r.visibility !== "remove",
+  );
+
+  await mkdir(OUT_DIR, { recursive: true });
+  await writeFile(FULL, buildFullTxt(records), "utf8");
+  console.log(`[llms] ${records.length} indexed → ${FULL}`);
+  console.log(`[llms] public/llms.txt is committed (NOT regenerated) — see scripts/build-llms.mjs`);
+}
+
+main().catch((err) => {
+  console.error("build-llms failed:", err);
+  process.exit(1);
+});

package/templates/default/scripts/build-records-json.mjs

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+// SPDX-License-Identifier: MIT
+
+/**
+ * build-records-json.mjs — yml → normalized JSON.
+ *
+ * Wraps `@grove-dev/cli generate`, which produces:
+ *   - data/generated/records.full.json   (every record, all fields)
+ *   - data/generated/records.index.json  (slim projection, visible only)
+ *   - data/generated/records.json        (alias of records.full.json)
+ *   - data/generated/site-config.json    (current blueprint + stats)
+ *
+ * Run by `pnpm run build:data` (also pre-build).
+ */
+import { spawnSync } from "node:child_process";
+
+const result = spawnSync("grove", ["generate"], {
+  stdio: "inherit",
+  env: process.env,
+});
+
+if (result.error) {
+  console.error("Failed to spawn `grove generate`:", result.error.message);
+  process.exit(1);
+}
+
+process.exit(result.status ?? 0);

package/templates/default/scripts/build-sitemap.mjs

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+// SPDX-License-Identifier: MIT
+
+/**
+ * build-sitemap.mjs — emit public/sitemap.xml from the generated
+ * index JSON. Thin wrapper around `@grove-dev/cli sitemap`.
+ */
+import { spawnSync } from "node:child_process";
+
+const result = spawnSync("grove", ["sitemap"], {
+  stdio: "inherit",
+  env: process.env,
+});
+
+if (result.error) {
+  console.error("Failed to spawn `grove sitemap`:", result.error.message);
+  process.exit(1);
+}
+
+process.exit(result.status ?? 0);

package/templates/default/scripts/cleanup-stale-records.mjs

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+// SPDX-License-Identifier: MIT
+
+/**
+ * cleanup-stale-records.mjs — flag records that look like they
+ * should be archived. Wrapper around `grove cleanup stale`.
+ */
+import { spawnSync } from "node:child_process";
+
+const result = spawnSync("grove", ["cleanup", "stale"], {
+  stdio: "inherit",
+  env: process.env,
+});
+
+if (result.error) {
+  console.error("Failed to spawn `grove cleanup stale`:", result.error.message);
+  process.exit(1);
+}
+
+process.exit(result.status ?? 0);