@grove-dev/astro 0.1.5 → 0.2.5

package/templates/default/astro.config.mjs

@@ -2,18 +2,20 @@
 // SPDX-License-Identifier: MIT
 import { defineConfig } from 'astro/config';
 import tailwindcss from '@tailwindcss/vite';
+import groveAstro from '@grove-dev/astro';
 
 // `site` is the canonical URL the build uses for absolute links
-// (sitemap, OpenGraph, canonical tags, JSON-LD). Set curated.config.ts
-// → `siteUrl` and run `grove build` — this file is read by
-// Astro directly.
+// (sitemap, OpenGraph, canonical tags, JSON-LD). The CLI injects
+// `grove.config.ts` → `site.url` at scaffold time, but it can also
+// be overridden per-build via the `SITE_URL` env var.
 //
-// The sitemap itself is generated by a custom Astro endpoint at
-// `src/pages/sitemap.xml.ts` rather than `@astrojs/sitemap`, so the
-// public URL is exactly `/sitemap.xml` (no `-index.xml` suffix).
+// The sitemap is generated by the CLI's `grove sitemap` command
+// into `public/sitemap.xml`; the public URL is exactly `/sitemap.xml`
+// (no `-index.xml` suffix).
 export default defineConfig({
   site: process.env.SITE_URL || 'https://example.com',
   trailingSlash: 'ignore',
+  integrations: [groveAstro()],
   vite: {
     plugins: [tailwindcss()],
   },

package/templates/default/content/pages/about.md

@@ -0,0 +1,66 @@
+---
+title: "About"
+description: "What this directory is, who it's for, and how it works."
+---
+
+# About this directory
+
+This site is a small, hand-curated index of useful open-source work
+relevant to a specific community. The framing is deliberately
+narrow: we list *one* project per record, with a hand-written
+"why listed" note for each, and we surface the things that matter
+in practice (recent activity, install friction, license, etc.)
+rather than the things that look impressive on a GitHub profile.
+
+## How it works
+
+Records live as YAML files in `data/records/`. Each record carries:
+
+- A `kind` (`project`, `resource`, or `entity` — picked by the
+  blueprint in `grove.config.ts`).
+- A `slug` (URL-safe identifier; becomes the path on
+  `/<kind>/<slug>`).
+- A `name` and a one-line `description`.
+- Cross-links (`links.github`, `links.website`, etc.) and free-form
+  tags.
+- An optional `curation` block with `labels`, `reviewedAt`,
+  `bestFor`, `whyListed`, `caveats`, and `scores`.
+- An optional `github` block with the live repository signals
+  (stars, forks, latest release, languages, pushed-at).
+
+At build time:
+
+1. `grove validate` checks every record against the JSON schema.
+2. `grove generate` writes `data/generated/records.{full,index}.json`
+   and `data/generated/site-config.json`.
+3. `grove sitemap` writes `public/sitemap.xml`.
+4. `grove llms` writes `public/llms.txt` and `llms-full.txt`.
+5. `astro build` produces the static output.
+
+The whole pipeline is reproducible. The records are the source of
+truth; everything else is derived.
+
+## Why a static site
+
+The directory is a *reference*, not an *app*. Static HTML is the
+right tool:
+
+- Every page is a single round-trip. No client-side data layer.
+- The output is auditable: open the deployed HTML and you can see
+  the full markup, no hidden hydration.
+- Hosting is cheap (or free, on GitHub Pages / Cloudflare Pages).
+- AI crawlers can read the full content. The `llms.txt` /
+  `llms-full.txt` files give them a single fetch to land on.
+
+## Contributing
+
+To add a record, open a submission issue. The maintainer will
+review and, if accepted, open a PR that adds the new YAML file.
+See `/submit` for the issue form and a minimal record template.
+
+## License
+
+The site's source code is MIT. The records are released under CC-BY
+4.0 unless a record's `license` field says otherwise. A record's
+`license` field is the license of the *project it describes*, not
+the license of the directory entry.

package/templates/default/content/pages/methodology.md

@@ -0,0 +1,103 @@
+---
+title: "Methodology"
+description: "How records are picked, scored, and surfaced in this directory."
+---
+
+# Methodology
+
+This page describes how entries in the directory are chosen, how the
+curation signals are computed, and what we do (and don't) promise about
+the data. The intent is to make the directory's logic auditable — every
+number on a detail page is reproducible from the record's YAML.
+
+## Selection
+
+A record is included if it is:
+
+1. **Open source.** Source is public under an OSI-approved license
+   (or public-domain dedication).
+2. **Actively maintained.** A pushed commit within the last 18 months
+   OR a declared maintenance status of `maintained` / `passive`.
+3. **Useful to a curious developer.** A working build, a real user
+   base (or a credible path to one), and a clear description of what
+   the project does.
+
+We exclude: abandoned experiments, vapourware, projects whose entire
+purpose is to sell a hosted plan, and any record that has not been
+hand-checked by a maintainer.
+
+## Curation labels
+
+The `curation.labels` field is a small, hand-set list. The supported
+labels are:
+
+- `hot` — high recent activity or attention (≥ 1 000 stars or a
+  commit within the last 30 days).
+- `new` — added to the directory in the last 7 days.
+- `mature` — long-running curated project, pushed > 365 days ago,
+  but still maintained.
+- `featured` — editor's pick for the front page.
+- `needs-review` — open submission awaiting a second maintainer
+  look.
+
+These labels are mutually additive, not exclusive. A `new` record
+can also be `hot`; a `mature` record can also be `featured`.
+
+## Scoring
+
+The detail page surfaces a five-dimension score block. The five
+dimensions are:
+
+- **Documentation** — is the README / docs site enough to onboard
+  without reading the source?
+- **Onboarding** — install in < 5 min, first useful result in < 1 h.
+- **Maintenance** — recent commits, issue close rate, release cadence.
+- **Community** — issues answered, discussions active, contributors
+  per release.
+- **Production-readiness** — CI, tests, security policy, releases
+  with semver.
+
+Each dimension is scored 0-5. The overall score on the detail page
+is the mean. Scores are stored on the record, not computed at build
+time, so we can deliberately disagree with the raw signals (a 1-line
+toy that happens to be wildly popular can still score low on
+documentation).
+
+## Health signals
+
+The `health` block on each record tracks four state machines:
+
+- `status` — `healthy` / `slowing` / `stale` / `archived`.
+- `tier` — `curated` / `community` / `experimental`.
+- `issue_close_rate` — moving 90-day average.
+- `last_release` — most recent semver tag.
+
+A record's `status` transitions are time-boxed: a project with no
+commits in 365 days flips from `slowing` to `stale`; 730 days flips
+to `archived`. The transition is mechanical; the recovery is
+manual (a maintainer sets `tier` back to `community` after review).
+
+## Lenses
+
+The directory's home page surfaces three curated lenses:
+
+- **Hot** — `curation.labels` includes `hot`, OR `github.stars` ≥
+  1 000, OR `pushedAt` within 30 days.
+- **New** — `pushedAt` within 7 days, OR `curation.labels` includes
+  `new`.
+- **Mature** — `health.tier === "curated"` AND `pushedAt` > 365 days
+  ago.
+
+Each lens caps at 6 items on the home page; the full filtered list
+is reachable via the lens tab on `/projects`.
+
+## What we don't promise
+
+- **Real-time data.** The site is rebuilt on a schedule, not on
+  every push. Counts and dates can lag by up to one build cycle.
+- **Verdict-free scores.** A high overall score means "useful to a
+  curious developer", not "best in class" — judgement calls are
+  documented per record, not baked into the score.
+- **Causal claims.** The "best for" / "why listed" / "caveats"
+  blocks are editorial notes, not derived signals. They reflect
+  what a maintainer thought at review time.

package/templates/default/data/generated/records.full.json

@@ -0,0 +1,8 @@
+{
+  "schemaVersion": 1,
+  "blueprint": "project-directory",
+  "generatedAt": "2026-06-10T15:03:23.841Z",
+  "totalRecords": 0,
+  "visibleRecords": 0,
+  "records": []
+}

package/templates/default/data/generated/records.index.json

@@ -0,0 +1,7 @@
+{
+  "schemaVersion": 1,
+  "blueprint": "project-directory",
+  "generatedAt": "2026-06-10T15:03:23.841Z",
+  "totalRecords": 0,
+  "records": []
+}

package/templates/default/data/generated/records.json

@@ -0,0 +1,8 @@
+{
+  "schemaVersion": 1,
+  "blueprint": "project-directory",
+  "generatedAt": "2026-06-10T15:03:23.841Z",
+  "totalRecords": 0,
+  "visibleRecords": 0,
+  "records": []
+}

package/templates/default/data/generated/site-config.json

@@ -0,0 +1,31 @@
+{
+  "blueprint": "project-directory",
+  "name": "Grove Directory",
+  "tagline": "A curated, health-aware developer directory.",
+  "description": "A curated, health-aware developer directory powered by Grove.",
+  "siteUrl": "https://example.com",
+  "repoUrl": "https://github.com/tortuvshin/grove",
+  "nav": [
+    {
+      "label": "Home",
+      "href": "/"
+    },
+    {
+      "label": "Browse",
+      "href": "/projects"
+    },
+    {
+      "label": "About",
+      "href": "/about"
+    }
+  ],
+  "theme": {
+    "primaryColor": "#16a34a",
+    "radius": "soft",
+    "density": "comfortable",
+    "containerWidth": "72rem"
+  },
+  "integrations": {
+    "github": false
+  }
+}

package/templates/default/grove.config.ts

@@ -0,0 +1,36 @@
+import { defineConfig } from "@grove-dev/core";
+
+/**
+ * Default template config — the smallest viable project-directory
+ * showcase. Consumers (created via `grove new`) override this
+ * with their own branding, taxonomy, and integrations.
+ */
+export default defineConfig({
+  blueprint: "project-directory",
+
+  site: {
+    name: "Grove Directory",
+    tagline: "A curated, health-aware developer directory.",
+    description:
+      "A curated, health-aware developer directory powered by Grove.",
+    url: "https://example.com",
+    repoUrl: "https://github.com/tortuvshin/grove",
+  },
+
+  nav: [
+    { label: "Home", href: "/" },
+    { label: "Browse", href: "/projects" },
+    { label: "About", href: "/about" },
+  ],
+
+  facets: ["category", "stacks", "platforms", "tags"],
+
+  integrations: {},
+
+  theme: {
+    primaryColor: "#16a34a",
+    radius: "soft",
+    density: "comfortable",
+    containerWidth: "72rem",
+  },
+});

package/templates/default/package.json

@@ -11,16 +11,17 @@
   },
   "scripts": {
     "validate:data": "grove validate",
-    "build:data": "grove build-data",
-    "build:llms-full": "grove build-llms-full",
-    "build": "pnpm run build:data && pnpm run build:llms-full && astro build",
+    "build:data": "grove generate",
+    "build:sitemap": "grove sitemap",
+    "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",
     "preview": "astro preview",
     "astro": "astro",
     "check": "astro check",
-    "refresh:activity": "grove analyze",
-    "enrich:github": "grove enrich"
+    "sync:github": "grove sync github",
+    "cleanup": "grove cleanup stale"
   },
   "dependencies": {
     "@astrojs/check": "^0.9.9",

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

@@ -0,0 +1,14 @@
+# Grove Directory — full directory
+
+> Generated 2026-06-10T15:03:23.841Z from 0 records.
+> Source: https://example.com/projects · Regenerate with `grove generate`.
+
+Each section below mirrors one record detail page.
+
+## Index
+
+
+
+
+
+

package/templates/default/public/llms.txt

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

package/templates/default/src/components/layout/BaseLayout.astro

@@ -1,32 +1,16 @@
 ---
-// SPDX-License-Identifier: MIT
-
-/**
- * BaseLayout — wraps every page. Owns the theme-detection inline script
- * and the global shell (Header, Footer). Per-page SEO (title, description,
- * OG, JSON-LD) is delegated to <Seo /> so each page can declare what it
- * needs without polluting the layout file.
- */
 import "../../styles/global.css";
 import Header from "./Header.astro";
 import Footer from "./Footer.astro";
-import Seo from "./Seo.astro";
 
 interface Props {
   title: string;
   description: string;
-  type?: "website" | "article" | "profile";
   noindex?: boolean;
   jsonLd?: Record<string, unknown> | Record<string, unknown>[];
 }
 
-const {
-  title,
-  description,
-  type,
-  noindex,
-  jsonLd,
-} = Astro.props;
+const { title, description, noindex, jsonLd } = Astro.props;
 
 const favicon =
   "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Crect width='16' height='16' rx='3' fill='%2318181b'/%3E%3C/svg%3E";
@@ -38,57 +22,26 @@ const favicon =
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="generator" content={Astro.generator} />
+    <meta name="description" content={description} />
     <meta name="theme-color" content="#0a0a0c" media="(prefers-color-scheme: dark)" />
     <meta name="theme-color" content="#fafafa" media="(prefers-color-scheme: light)" />
     <link rel="icon" href={favicon} />
     <link rel="sitemap" href="/sitemap.xml" />
     <link rel="alternate" type="text/plain" href="/llms.txt" title="LLM usage guidance" />
-
-    <Seo
-      title={title}
-      description={description}
-      type={type}
-      noindex={noindex}
-      jsonLd={jsonLd}
-    />
-
-    <slot name="head" />
-    <script is:inline>
-      (function () {
-        var STORAGE_KEY = "open-apps-theme";
-        function getMode() {
-          var stored = localStorage.getItem(STORAGE_KEY);
-          if (stored === "light" || stored === "dark" || stored === "system") return stored;
-          return "system";
-        }
-        function apply(mode) {
-          var resolved =
-            mode === "system"
-              ? (window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light")
-              : mode;
-          var root = document.documentElement;
-          if (resolved === "dark") root.classList.add("dark");
-          else root.classList.remove("dark");
-          root.dataset.theme = mode;
-          root.dataset.resolvedTheme = resolved;
-        }
-        apply(getMode());
-        window.addEventListener("theme:set", function (e) { apply(e.detail); });
-        var mq = window.matchMedia("(prefers-color-scheme: dark)");
-        mq.addEventListener("change", function () {
-          if (getMode() === "system") apply("system");
-        });
-      })();
-    </script>
+    {noindex && <meta name="robots" content="noindex,nofollow" />}
+    <title>{title}</title>
+    {jsonLd && (
+      <script
+        type="application/ld+json"
+        set:html={JSON.stringify(jsonLd)}
+      />
+    )}
   </head>
   <body class="min-h-screen bg-white text-ink-900 dark:bg-ink-950 dark:text-ink-100">
     <Header />
-
     <main>
       <slot />
     </main>
-
     <Footer />
-    <slot name="body-end" />
   </body>
 </html>

package/templates/default/src/components/layout/Footer.astro

@@ -1,145 +1,27 @@
 ---
-import { siteConfig } from "../../data/config";
-import { stats } from "../../data/stats";
+import siteConfig from "../../data/generated/site-config.json";
 
-const githubUrl = stats.originalRepo;
 const year = new Date().getFullYear();
-
-// One-line positioning. Should be the same on every page so the
-// project's identity is consistent.
-const positioning =
-  "A searchable directory of real open-source applications — organized by stack, category, platform, license, activity, and maturity.";
 ---
 
 <footer class="mt-16 border-t border-ink-200 bg-white text-ink-500 dark:border-ink-800 dark:bg-ink-950 dark:text-ink-400">
-  <div
-    class="mx-auto grid max-w-wide grid-cols-2 gap-8 px-5 py-12 md:grid-cols-4 sm:px-7"
-  >
-    <div class="col-span-2 md:col-span-1">
-      <div
-        class="mb-2 inline-flex items-center gap-2 text-[0.95rem] font-semibold text-ink-900 dark:text-ink-100"
-      >
-        <span
-          aria-hidden="true"
-          class="inline-block h-3.5 w-3.5 rounded bg-ink-900 dark:bg-ink-100"
-        ></span>
-        <span>{siteConfig.name}</span>
-      </div>
-      <p class="m-0 max-w-[36ch] text-[0.8125rem] leading-relaxed text-ink-500 dark:text-ink-400">
-        {positioning}
+  <div class="mx-auto max-w-6xl px-5 py-8 sm:px-7">
+    <div class="flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between">
+      <p class="m-0 text-sm">
+        © {year} {siteConfig.name}.
       </p>
-      <p class="mt-3 m-0 text-2xs text-ink-500 dark:text-ink-400">
-        <span class="font-mono">{stats.apps}</span> apps
-        <span class="mx-1 text-ink-300 dark:text-ink-700">·</span>
-        <span class="font-mono">{stats.categories}</span> categories
-        <span class="mx-1 text-ink-300 dark:text-ink-700">·</span>
-        <span class="font-mono">{stats.contributors}</span> contributors
+      <p class="m-0 text-2xs text-ink-500 dark:text-ink-400">
+        Built with{" "}
+        <a
+          href="https://github.com/tortuvshin/grove"
+          target="_blank"
+          rel="noopener noreferrer"
+          class="hover:text-ink-900 dark:hover:text-ink-100"
+        >
+          Grove
+        </a>
+        {" "}— an open-source framework for community knowledge sites.
       </p>
     </div>
-
-    <div>
-      <h4
-        class="mb-3 text-2xs font-semibold uppercase tracking-wider text-ink-900 dark:text-ink-100"
-      >
-        Discover
-      </h4>
-      <ul class="m-0 flex list-none flex-col gap-2 p-0">
-        <li><a href="#hot" class="text-sm transition-colors hover:text-ink-900 dark:hover:text-ink-100">Hot apps</a></li>
-        <li><a href="#new" class="text-sm transition-colors hover:text-ink-900 dark:hover:text-ink-100">New apps</a></li>
-        <li><a href="#mature" class="text-sm transition-colors hover:text-ink-900 dark:hover:text-ink-100">Mature apps</a></li>
-        <li><a href="#stacks" class="text-sm transition-colors hover:text-ink-900 dark:hover:text-ink-100">By stack</a></li>
-        <li><a href="#categories" class="text-sm transition-colors hover:text-ink-900 dark:hover:text-ink-100">By category</a></li>
-      </ul>
-    </div>
-
-    <div>
-      <h4
-        class="mb-3 text-2xs font-semibold uppercase tracking-wider text-ink-900 dark:text-ink-100"
-      >
-        Contribute
-      </h4>
-      <ul class="m-0 flex list-none flex-col gap-2 p-0">
-        <li>
-          <a
-            href={`${githubUrl}/blob/main/CONTRIBUTING.md`}
-            target="_blank"
-            rel="noopener noreferrer"
-            class="text-sm transition-colors hover:text-ink-900 dark:hover:text-ink-100"
-            >Submit via GitHub</a
-          >
-        </li>
-        <li><a href="#contributors" class="text-sm transition-colors hover:text-ink-900 dark:hover:text-ink-100">Contributors</a></li>
-        <li>
-          <a
-            href={`${githubUrl}/issues`}
-            target="_blank"
-            rel="noopener noreferrer"
-            class="text-sm transition-colors hover:text-ink-900 dark:hover:text-ink-100"
-            >Report an issue</a
-          >
-        </li>
-        <li>
-          <a
-            href={`${githubUrl}/blob/main/CONTRIBUTING.md`}
-            target="_blank"
-            rel="noopener noreferrer"
-            class="text-sm transition-colors hover:text-ink-900 dark:hover:text-ink-100"
-            >Contributing guide</a
-          >
-        </li>
-      </ul>
-    </div>
-
-    <div>
-      <h4
-        class="mb-3 text-2xs font-semibold uppercase tracking-wider text-ink-900 dark:text-ink-100"
-      >
-        Project
-      </h4>
-      <ul class="m-0 flex list-none flex-col gap-2 p-0">
-        <li>
-          <a
-            href={githubUrl}
-            target="_blank"
-            rel="noopener noreferrer"
-            class="text-sm transition-colors hover:text-ink-900 dark:hover:text-ink-100"
-            >Source on GitHub</a
-          >
-        </li>
-        <li><a href="#about" class="text-sm transition-colors hover:text-ink-900 dark:hover:text-ink-100">Why this exists</a></li>
-        <li>
-          <a
-            href={`${githubUrl}/blob/main/README.md`}
-            target="_blank"
-            rel="noopener noreferrer"
-            class="text-sm transition-colors hover:text-ink-900 dark:hover:text-ink-100"
-            >README</a
-          >
-        </li>
-        <li>
-          <a
-            href="/about"
-            class="text-sm transition-colors hover:text-ink-900 dark:hover:text-ink-100"
-            >About</a
-          >
-        </li>
-      </ul>
-    </div>
-  </div>
-
-  <div class="border-t border-ink-200 dark:border-ink-800">
-    <div
-      class="mx-auto flex max-w-wide flex-wrap items-center gap-3 px-5 py-4 text-2xs text-ink-500 sm:px-7 dark:text-ink-400"
-    >
-      <span>© {year} {siteConfig.name}. Content under CC BY-SA 4.0.</span>
-      <span class="text-ink-300 dark:text-ink-700">·</span>
-      <a
-        href={githubUrl}
-        target="_blank"
-        rel="noopener noreferrer"
-        class="transition-colors hover:text-ink-900 dark:hover:text-ink-100"
-        >View source on GitHub</a
-      >
-    </div>
   </div>
 </footer>