@grove-dev/astro 0.2.10 → 0.2.14

package/src/lib/taxonomy-counts.ts

@@ -1,60 +1,26 @@
-/**
- * Build-time helpers that compute taxonomy counts from an array of
- * records. Generic over any object that carries the index-payload
- * fields the UI cares about (`category`, `stack` / `stacks`,
- * `curation.labels`). No filesystem / data import — consumers pass
- * the records explicitly so this stays testable.
- *
- * All functions are synchronous and cheap — they're called from
- * Astro page frontmatter at build time, never on the client.
- */
-
-export interface Taxonomable {
+type TaxonomyRecord = {
   category?: string;
   stack?: string;
   stacks?: string[];
-  curation?: { labels?: string[] };
-}
+};
 
-/** Number of records per category name. */
-export function countByCategory<T extends Taxonomable>(
-  records: T[],
-): Map<string, number> {
+/** Number of items in the directory, per category name. */
+export function countByCategory(items: TaxonomyRecord[] = []): Map<string, number> {
   const m = new Map<string, number>();
-  for (const r of records) {
-    const k = r.category || "Other";
+  for (const a of items) {
+    const k = a.category || "Other";
     m.set(k, (m.get(k) ?? 0) + 1);
   }
   return m;
 }
 
-/** Number of records per primary stack (combines `stack` and `stacks`). */
-export function countByStack<T extends Taxonomable>(
-  records: T[],
-): Map<string, number> {
-  const m = new Map<string, number>();
-  for (const r of records) {
-    const keys = new Set(
-      [r.stack, ...(r.stacks ?? [])].filter(
-        (s): s is string => Boolean(s),
-      ),
-    );
-    for (const k of keys) {
-      m.set(k, (m.get(k) ?? 0) + 1);
-    }
-  }
-  return m;
-}
-
-/** Number of records per curated label (curation.labels). */
-export function countByLabel<T extends Taxonomable>(
-  records: T[],
-): Map<string, number> {
+/** Number of items in the directory, per primary stack. */
+export function countByStack(items: TaxonomyRecord[] = []): Map<string, number> {
   const m = new Map<string, number>();
-  for (const r of records) {
-    for (const l of r.curation?.labels ?? []) {
-      m.set(l, (m.get(l) ?? 0) + 1);
-    }
+  for (const a of items) {
+    const stacks = new Set([a.stack, ...(a.stacks ?? [])].filter(Boolean) as string[]);
+    if (stacks.size === 0) stacks.add("Other");
+    for (const stack of stacks) m.set(stack, (m.get(stack) ?? 0) + 1);
   }
   return m;
 }

package/src/styles.css

@@ -16,6 +16,9 @@
  * removed) prefix. Only `grove-*` remains.
  */
 
+@import "tailwindcss";
+@source "./**/*.{astro,html,js,jsx,ts,tsx}";
+
 @theme {
   /* ── Neutral ink scale (V1 default) ───────────────────────────── */
   --color-ink-50: #fafafa;
@@ -154,7 +157,7 @@
     line-height: 1.55;
   }
 
-  body.dark {
+  .dark body {
     background: var(--color-ink-950);
     color: var(--color-ink-100);
   }
@@ -199,6 +202,84 @@
   }
 }
 
+/* ──────────────────────────────────────────────────────────────────
+ * Rendered record Markdown
+ * ────────────────────────────────────────────────────────────────── */
+.grove-prose {
+  max-width: 72ch;
+  color: var(--color-ink-700);
+  font-size: 0.9375rem;
+  line-height: 1.75;
+}
+
+.dark .grove-prose {
+  color: var(--color-ink-200);
+}
+
+.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;
+}
+
+.dark .grove-prose :where(h1, h2, h3, h4) {
+  color: var(--color-ink-100);
+}
+
+.grove-prose :where(p, ul, ol, pre, blockquote) {
+  margin: 1em 0;
+}
+
+.grove-prose :where(ul, ol) {
+  padding-left: 1.5rem;
+}
+
+.grove-prose a {
+  color: var(--color-accent);
+  text-decoration: underline;
+  text-underline-offset: 0.18em;
+}
+
+.grove-prose :where(code, pre) {
+  font-family: var(--font-mono);
+}
+
+.grove-prose code {
+  border-radius: 0.25rem;
+  background: var(--color-ink-100);
+  padding: 0.1em 0.3em;
+  font-size: 0.875em;
+}
+
+.dark .grove-prose code {
+  background: var(--color-ink-800);
+}
+
+.grove-prose pre {
+  overflow-x: auto;
+  border: 1px solid var(--color-ink-200);
+  border-radius: var(--radius-lg);
+  background: var(--color-ink-50);
+  padding: 1rem;
+}
+
+.dark .grove-prose pre {
+  border-color: var(--color-ink-800);
+  background: var(--color-ink-900);
+}
+
+.grove-prose pre code {
+  background: transparent;
+  padding: 0;
+}
+
+.grove-prose blockquote {
+  border-left: 3px solid var(--color-ink-300);
+  padding-left: 1rem;
+  color: var(--color-ink-500);
+}
+
 /* ──────────────────────────────────────────────────────────────────
  * Component classes — shared by the showcase component library.
  * Use these directly; you can also use the equivalent Tailwind
@@ -206,6 +287,31 @@
  * ────────────────────────────────────────────────────────────────── */
 
 @layer components {
+  /*
+   * Stable container classes for consumers of the packaged stylesheet.
+   * Tailwind does not emit utilities referenced only inside a dependency,
+   * so relying on `max-w-container` alone can leave template content
+   * unconstrained.
+   */
+  .grove-container,
+  .grove-container-wide,
+  .grove-container-narrow {
+    width: 100%;
+    margin-inline: auto;
+  }
+
+  .grove-container {
+    max-width: var(--container-container);
+  }
+
+  .grove-container-wide {
+    max-width: var(--container-wide);
+  }
+
+  .grove-container-narrow {
+    max-width: var(--container-narrow);
+  }
+
   /* Section spacing — consistent vertical rhythm */
   .grove-section {
     padding-top: 3rem;
@@ -401,3 +507,105 @@
     background: #ffffff;
   }
 }
+
+/* ────────────────────────────────────────────────────────────────────
+ * Backwards-compat aliases — openapps used the unprefixed utility
+ * names (`card`, `btn-primary`, `btn-outline`, `btn-ghost`). New
+ * components should use the `grove-` prefix. These rules mirror
+ * the `grove-*` definitions above so the openapps-derived
+ * components (ItemCard, AppCard, etc. — kept as `ItemCard` for V1
+ * published API stability) work without per-component
+ * edits.
+ * ────────────────────────────────────────────────────────────────────*/
+.card {
+  border: 1px solid var(--color-ink-200);
+  background: #ffffff;
+  border-radius: 0.5rem;
+  transition: border-color 150ms ease, background-color 150ms ease, box-shadow 150ms ease;
+}
+.dark .card {
+  border-color: var(--color-ink-800);
+  background: var(--color-ink-950);
+}
+.card-hover:hover {
+  border-color: var(--color-ink-300);
+  background: rgba(244, 244, 245, 0.6);
+  box-shadow: 0 1px 2px rgba(0, 0, 0, 0.04), 0 4px 12px -2px rgba(0, 0, 0, 0.06);
+}
+.dark .card-hover:hover {
+  border-color: var(--color-ink-700);
+  background: rgba(24, 24, 27, 0.4);
+  box-shadow: 0 1px 2px rgba(0, 0, 0, 0.4), 0 4px 12px -2px rgba(0, 0, 0, 0.3);
+}
+
+/* Chip — small inline label used for platforms/stacks/etc. on
+ * ItemCard. Mirrors openapps' `.chip` from the ItemCard.astro
+ * (component name retained for V1 published API stability).
+ * `<style>` block so the @apply in the component still works. */
+.chip {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.25rem;
+  border-radius: 0.375rem;
+  border: 1px solid var(--color-ink-200);
+  background: #ffffff;
+  padding: 0.125rem 0.375rem;
+  font-size: 0.6875rem;
+  font-weight: 500;
+  color: var(--color-ink-700);
+  transition: color 150ms ease, background-color 150ms ease, border-color 150ms ease;
+}
+.dark .chip {
+  border-color: var(--color-ink-200);
+  background: var(--color-ink-950);
+  color: var(--color-ink-300);
+}
+.chip-stack {
+  background: var(--color-ink-50);
+}
+.dark .chip-stack {
+  background: rgba(24, 24, 27, 0.6);
+}
+.btn-primary,
+.btn-outline,
+.btn-ghost {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.375rem;
+  border-radius: 0.5rem;
+  padding: 0.5rem 0.875rem;
+  font-size: 0.875rem;
+  font-weight: 500;
+  white-space: nowrap;
+  transition: color 0.15s, background-color 0.15s, border-color 0.15s;
+  cursor: pointer;
+  border: 1px solid transparent;
+  text-decoration: none;
+}
+.btn-primary {
+  border-color: var(--color-ink-900);
+  background: var(--color-ink-900);
+  color: var(--color-ink-50);
+}
+.btn-primary:hover {
+  background: var(--color-ink-700);
+  border-color: var(--color-ink-700);
+}
+.btn-outline {
+  border-color: var(--color-ink-200);
+  background: var(--color-ink-50);
+  color: var(--color-ink-700);
+}
+.btn-outline:hover {
+  border-color: var(--color-ink-300);
+  background: var(--color-ink-100);
+}
+.btn-ghost {
+  background: transparent;
+  color: var(--color-ink-500);
+}
+.btn-ghost:hover {
+  color: var(--color-ink-900);
+  background: var(--color-ink-100);
+}

package/templates/default/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,33 @@
+---
+name: Bug report
+about: Something is broken on the site
+title: "[bug] "
+labels: ["bug"]
+assignees: []
+---
+
+## What happened
+
+A clear, concise description of the bug.
+
+## Steps to reproduce
+
+1. Go to '…'
+2. Click on '…'
+3. Scroll down to '…'
+4. See error
+
+## What I expected
+
+A clear, concise description of what you expected to happen.
+
+## What I saw
+
+Screenshots, error messages, console output — anything that helps.
+
+## Environment
+
+- Browser:
+- OS:
+- Page URL:
+- Viewport size (rough):

package/templates/default/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an improvement to the site
+title: "[feature] "
+labels: ["enhancement"]
+assignees: []
+---
+
+## The problem
+
+What's missing or awkward today?
+
+## The proposed solution
+
+What would you like to see? Mockups, links, references — anything
+that helps us understand the shape of the change.
+
+## Alternatives considered
+
+Any other approaches you weighed, and why this one wins.

package/templates/default/.github/ISSUE_TEMPLATE/record_submission.md

@@ -0,0 +1,48 @@
+---
+name: Submit a record
+about: Suggest a new entry for the directory
+title: "[submit] "
+labels: ["submission"]
+assignees: []
+---
+
+Thanks for taking the time to suggest a new entry! Please fill in the
+template below — the more complete it is, the faster it lands.
+
+**Important:** this issue tracker is for **suggestions**, not for the
+actual data. Once approved, a maintainer will add the record to
+`data/records/<slug>.yml` (or invite you to open a PR).
+
+## 1. Basics
+
+- **Name:**
+- **One-line description:**
+- **Category:** (e.g. Mobile, Web, DevOps, AI/ML)
+- **Primary stack:** (e.g. Flutter, Vue, Go, Python)
+- **Platforms:** (e.g. iOS, Android, Web, Linux, Self-host)
+- **Project type:** (real-app, production, reference, library, tool,
+  demo, template, historical)
+- **Difficulty:** (beginner, intermediate, advanced)
+
+## 2. Links
+
+- **Repository URL:** (the canonical `https://github.com/owner/repo`)
+- **Website / homepage:**
+- **Docs:**
+
+## 3. Why it deserves a spot
+
+A short paragraph — what makes it stand out, what it's good for, who
+should look at it.
+
+## 4. Caveats
+
+Anything we should know about: license quirks, abandoned status,
+paid-only features, etc.
+
+## 5. Checkboxes
+
+- [ ] The repo is **public** on GitHub / another public forge
+- [ ] It's **open source** under an OSI-approved license
+- [ ] It has been **maintained** in the last 12 months
+- [ ] I am **not** the author (or I'm disclosing that I am)

package/templates/default/.github/pull_request_template.md

@@ -0,0 +1,27 @@
+## What this PR does
+
+A short summary of the change. One or two sentences. If it closes an
+issue, write "Closes #123" so it auto-links.
+
+## Why
+
+The motivation. Link to any relevant issues or discussions. If this
+is a UI change, attach a before/after screenshot.
+
+## How to verify
+
+Steps for a reviewer to follow:
+
+1. `pnpm install`
+2. `pnpm exec grove validate`
+3. `pnpm grove:dev` and open `…`
+4. Confirm that `…`
+
+## Checklist
+
+- [ ] `pnpm exec grove validate` passes
+- [ ] `pnpm run build` succeeds locally
+- [ ] For record changes: the `slug` is unique and matches the
+      filename (`data/records/<slug>.yml`)
+- [ ] For new categories / stacks / platforms: the field appears
+      sensibly in `Browse by category` and `Browse by stack`

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

@@ -0,0 +1,55 @@
+name: Build
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: grove build
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      # `build` chains build:data + build:sitemap + build:llms + astro build.
+      # Site URL is overridden so sitemap/OG/canonical links resolve to
+      # the deployed URL rather than the placeholder in grove.config.ts.
+      - name: Build site
+        env:
+          SITE_URL: ${{ vars.SITE_URL || github.pages.custom_domain || format('https://{0}.github.io/{1}', github.repository_owner, github.event.repository.name) }}
+        run: pnpm run build
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./dist
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+
+      - name: Summary
+        if: success()
+        run: |
+          echo "✅ Deployed to ${{ steps.deployment.outputs.page_url }}"

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

@@ -0,0 +1,48 @@
+name: Cleanup stale records
+
+on:
+  schedule:
+    # Monthly — first Monday 05:00 UTC. Cheap enough to run daily
+    # if you want, but most repos don't change status that often.
+    - cron: "0 5 1-7 * 1"
+  workflow_dispatch:
+
+jobs:
+  cleanup:
+    name: grove cleanup stale
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    permissions:
+      contents: read
+      issues: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      # `grove cleanup stale` lists records whose health signals say
+      # they need human review (archived, no commits in 12+ months,
+      # unparseable repo, etc). The report is rendered as a Markdown
+      # summary in the workflow run.
+      - name: Run cleanup report
+        id: report
+        run: pnpm exec grove cleanup stale --report > cleanup-report.md
+
+      - name: Summarise
+        run: |
+          if [ -s cleanup-report.md ]; then
+            echo "## Cleanup candidates" >> $GITHUB_STEP_SUMMARY
+            cat cleanup-report.md >> $GITHUB_STEP_SUMMARY
+          else
+            echo "✅ No records need cleanup." >> $GITHUB_STEP_SUMMARY
+          fi

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

@@ -0,0 +1,53 @@
+name: Daily records refresh
+
+on:
+  schedule:
+    # Daily — 06:00 UTC. Refreshes stars, forks, and the most
+    # recent commit date for every record so the home page and
+    # /apps filters stay accurate.
+    - cron: "0 6 * * *"
+  workflow_dispatch:
+
+jobs:
+  refresh:
+    name: refresh activity
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    permissions:
+      contents: write
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Refresh activity
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        # `grove sync github` walks every record, fetches the
+        # latest stars/forks/pushed_at, and writes back to the
+        # corresponding yml file. Idempotent — no change if the
+        # record is already up to date.
+        run: pnpm exec grove sync github
+
+      - name: Open PR if records changed
+        uses: peter-evans/create-pull-request@v6
+        with:
+          commit-message: "chore(data): daily records refresh"
+          title: "Daily records refresh"
+          body: |
+            Automated daily refresh of stars, forks, and last-commit
+            timestamps for every record. Generated by the
+            `daily-refresh` workflow.
+          branch: chore/daily-refresh
+          delete-branch: true

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

@@ -0,0 +1,53 @@
+name: Sync contributors
+
+on:
+  schedule:
+    # Weekly — Sunday 04:00 UTC (after the metadata sync).
+    - cron: "0 4 * * 0"
+  workflow_dispatch:
+
+jobs:
+  sync:
+    name: sync contributors
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      # Walk the records' repoUrl fields, fetch each repo's
+      # /contributors endpoint, and write a single
+      # `data/generated/contributors.json` (consumed by the home
+      # page and /contributors page). The script lives at the root
+      # of the project — it's not a CLI command because contributor
+      # fan-in is tightly coupled to this directory's git history
+      # and doesn't generalise across forks.
+      - name: Sync contributors from GitHub
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: node scripts/sync-contributors.mjs
+
+      - name: Commit contributors.json
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          if git diff --quiet data/generated/contributors.json; then
+            echo "No changes to contributors.json"
+          else
+            git add data/generated/contributors.json
+            git commit -m "chore(data): refresh contributors"
+            git push
+          fi