@grove-dev/astro 0.2.6 → 0.2.13

package/templates/default/src/pages/index.astro

@@ -1,28 +1,16 @@
 ---
 /**
- * Home page — the showcase's front door.
+ * Home page — generic.
  *
- * Sections (in order):
- *   1. Hero                       — brand + search + stats row
- *   2. WhyThisExists              — 3 short value-prop points
- *   3. RecordSection "Trending"   — hot lens (stars >= 1000 OR pushed <= 30d)
- *   4. RecordSection "Recently added" — new lens (pushed <= 7d OR curated "new")
- *   5. RecordSection "Established" — mature lens (tier=curated, pushed > 365d)
- *   6. StackGrid                  — browse by stack
- *   7. CategoryGrid               — browse by category
- *   8. ContributorsGrid           — top contributors (when available)
- *   9. OriginalCollection         — origin-card link to the source repo
+ * Mirrors the openapps structure: Hero → WhyThisExists → three
+ * lens sections (hot / new / mature) → StackGrid → CategoryGrid →
+ * ContributorsGrid → OriginalCollection.
  *
- * Every section is defensive: with 0 records (fresh scaffold) it
- * renders a graceful empty state instead of throwing.
- *
- * V1 source-of-truth types are from `@grove-dev/core`. The slim
- * `IndexProjectRecord` shape is what the home page consumes (no
- * `as ProjectRecord` casts); the full `Resource` only flows into
- * the detail page.
+ * All data derives from `data/generated/records.{index,full}.json`
+ * and `data/generated/site-config.json`. Nothing here is hardcoded
+ * to a specific blueprint — section copy uses singular/plural
+ * labels from `itemLabel()`/`itemLabelPlural()`.
  */
-import siteConfig from "../../data/generated/site-config.json";
-import { records, fullRecords, projects, indexSlug, itemLabel } from "../data/records";
 import BaseLayout from "@grove-dev/astro/layouts/BaseLayout.astro";
 import Hero from "@grove-dev/astro/components/Hero.astro";
 import WhyThisExists from "@grove-dev/astro/components/WhyThisExists.astro";
@@ -31,35 +19,16 @@ import StackGrid from "@grove-dev/astro/components/StackGrid.astro";
 import CategoryGrid from "@grove-dev/astro/components/CategoryGrid.astro";
 import ContributorsGrid from "@grove-dev/astro/components/ContributorsGrid.astro";
 import OriginalCollection from "@grove-dev/astro/components/OriginalCollection.astro";
-import { countByCategory, countByStack } from "@grove-dev/astro";
+
+import { items, fullRecords, fullItems } from "../data/records";
 import { existsSync, readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { dirname, resolve } from "node:path";
-import type { IndexProjectRecord } from "@grove-dev/core";
-
-const slug = indexSlug();
-const projectKind = projects;
+import siteConfig from "../../data/generated/site-config.json";
 
-// ── Hero stats ──────────────────────────────────────────────────
-const totalApps = fullRecords.filter((r) => r.kind === "project").length;
-const totalCategories = new Set(projectKind.map((r) => r.category).filter(Boolean))
-  .size;
-const totalStacks = new Set(
-  projectKind.flatMap((r) => [r.stack, ...(r.stacks ?? [])]).filter(Boolean),
-).size;
-const totalContributors = new Set(
-  projectKind
-    .map((r) => {
-      const url = r.repoUrl ?? r.links?.github ?? "";
-      const m = /github\.com\/([^/]+)\//.exec(url);
-      return m?.[1];
-    })
-    .filter(Boolean),
-).size;
-const totalStars = projectKind.reduce(
-  (acc, r) => acc + (r.github?.stars ?? 0),
-  0,
-);
+const slug = (siteConfig.blueprintConfig?.routeSlug ?? "projects") as string;
+const itemSingular = (siteConfig.blueprintConfig?.labelSingular ?? "project") as string;
+const itemPlural = (siteConfig.blueprintConfig?.labelPlural ?? "projects") as string;
 
 // ── Lens sectioning (Hot / New / Mature) ────────────────────────
 const DAY_MS = 86_400_000;
@@ -69,54 +38,66 @@ function daysSince(iso: string | null | undefined): number {
   if (Number.isNaN(d.valueOf())) return Infinity;
   return (Date.now() - d.valueOf()) / DAY_MS;
 }
+function starsOf(r: typeof items[number]): number {
+  return (r as { github?: { stars?: number } }).github?.stars ?? 0;
+}
+function pushedAtOf(r: typeof items[number]): string | null {
+  return (r as { github?: { pushedAt?: string | null } }).github?.pushedAt ?? null;
+}
+function reviewedAtOf(r: typeof items[number]): string | null {
+  return r.curation?.reviewedAt ?? null;
+}
+function labelsOf(r: typeof items[number]): string[] {
+  return r.curation?.labels ?? [];
+}
+function tierOf(r: typeof items[number]): string | undefined {
+  return (r as { health?: { tier?: string } }).health?.tier;
+}
 
-const hot = projectKind
-  .filter((r: IndexProjectRecord) => {
-    const stars = r.github?.stars ?? 0;
-    const pushedAt = r.github?.pushedAt ?? null;
-    const pushed = daysSince(pushedAt);
-    const labelledHot = r.curation?.labels?.includes("hot") ?? false;
-    return labelledHot || stars >= 1000 || pushed <= 30;
+const hotList = items
+  .filter((r) => r.kind === "project")
+  .filter((r) => {
+    const labelledHot = labelsOf(r).includes("hot");
+    return labelledHot || starsOf(r) >= 1000 || daysSince(pushedAtOf(r)) <= 30;
   })
   .slice(0, 6);
-
-const newItems = projectKind
-  .filter((r: IndexProjectRecord) => {
-    const pushedAt = r.github?.pushedAt ?? null;
-    const pushed = daysSince(pushedAt);
-    const labelledNew = r.curation?.labels?.includes("new") ?? false;
-    return pushed <= 7 || labelledNew;
+const newList = items
+  .filter((r) => r.kind === "project")
+  .filter((r) => {
+    const labelledNew = labelsOf(r).includes("new");
+    return daysSince(reviewedAtOf(r)) <= 21 || labelledNew;
   })
   .slice(0, 6);
-
-const mature = projectKind
-  .filter((r: IndexProjectRecord) => {
-    const tier = r.health?.tier;
-    const pushedAt = r.github?.pushedAt ?? null;
-    const pushed = daysSince(pushedAt);
-    return tier === "curated" && pushed > 365;
-  })
+const matureList = items
+  .filter((r) => r.kind === "project")
+  .filter((r) => labelsOf(r).includes("mature") || tierOf(r) === "curated")
   .slice(0, 6);
 
-// ── Stack / category aggregates ─────────────────────────────────
-const stackCounts = countByStack(projectKind);
-const stacks = [...stackCounts.entries()]
+// Stacks and categories derived from items
+const stackMap = new Map<string, number>();
+const catMap = new Map<string, number>();
+for (const r of fullItems) {
+  const cat = (r as { category?: string }).category;
+  if (cat) catMap.set(cat, (catMap.get(cat) ?? 0) + 1);
+  const s1 = (r as { stack?: string }).stack;
+  if (s1) stackMap.set(s1, (stackMap.get(s1) ?? 0) + 1);
+  const s2 = (r as { stacks?: string[] }).stacks ?? [];
+  for (const s of s2) stackMap.set(s, (stackMap.get(s) ?? 0) + 1);
+}
+const stacks = [...stackMap.entries()]
   .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
   .slice(0, 12)
   .map(([name, count]) => ({ name, slug: name, count }));
-
-const categoryCounts = countByCategory(projectKind);
-const categories = [...categoryCounts.entries()]
+const categories = [...catMap.entries()]
   .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
   .map(([name, count]) => ({ name, slug: name, count }));
 
-// ── Contributors (best-effort, from records) ────────────────────
+// Contributors (best-effort from data/generated/contributors.json)
 const here = dirname(fileURLToPath(import.meta.url));
 const contributorsPath = [
   resolve(here, "..", "..", "data", "generated", "contributors.json"),
   resolve(process.cwd(), "data", "generated", "contributors.json"),
 ].find((p) => existsSync(p));
-
 interface ContributorsFile {
   contributors?: Array<{
     username: string;
@@ -126,7 +107,6 @@ interface ContributorsFile {
     contributions?: number;
   }>;
 }
-
 let contributors: ContributorsFile["contributors"] = [];
 if (contributorsPath) {
   try {
@@ -136,63 +116,52 @@ if (contributorsPath) {
     contributors = [];
   }
 }
-const hasContributors = contributors && contributors.length > 0;
 
-// ── OriginalCollection (repo-stats.json if present) ─────────────
-interface RepoStats {
-  originalRepo?: string;
-  stars?: number;
-  forks?: number;
-  contributors?: number;
-  description?: string;
-}
-let repoStats: RepoStats = {};
-const repoStatsPath = [
-  resolve(here, "..", "..", "data", "generated", "repo-stats.json"),
-  resolve(process.cwd(), "data", "generated", "repo-stats.json"),
-].find((p) => existsSync(p));
-if (repoStatsPath) {
-  try {
-    repoStats = JSON.parse(readFileSync(repoStatsPath, "utf8")) as RepoStats;
-  } catch {
-    repoStats = {};
-  }
-}
+const stats = {
+  originalRepo: siteConfig.repoUrl ?? "",
+  apps: siteConfig.stats?.totalApps ?? 0,
+  categories: siteConfig.stats?.totalCategories ?? 0,
+  stacks: siteConfig.stats?.totalStacks ?? 0,
+  contributors: siteConfig.stats?.totalOwners ?? 0,
+  stars: siteConfig.stats?.totalStars ?? 0,
+};
 
 const title = `${siteConfig.name} — ${siteConfig.tagline}`;
 const description =
-  siteConfig.description ?? `A growing community knowledge site powered by Grove.`;
-
-// ── Render-time helpers ─────────────────────────────────────────
-function detailHrefFor(r: IndexProjectRecord): string {
-  return `/${slug}/${r.slug}`;
-}
+  siteConfig.description ??
+  `A searchable directory of real ${itemPlural} — organized by stack, category, platform, license, activity, and maturity.`;
 ---
 
-<BaseLayout
-  title={title}
-  description={description}
-  site={siteConfig}
-  submitHref="/submit"
-  submitLabel={`Submit ${itemLabel()}`}
->
+<BaseLayout title={title} description={description} site={siteConfig}>
   <Hero
-    name={siteConfig.name}
-    tagline={siteConfig.tagline}
+    name={`Find ${itemPlural} you can actually`}
+    tagline="run, study, and contribute to."
     description={description}
-    eyebrow="Curated directory"
-    searchPlaceholder={`Search ${slug}...`}
-    searchHref={`/${slug}`}
+    eyebrow={`A directory of real curated ${itemPlural}`}
+    eyebrowBadge="Beta"
     stats={{
-      apps: totalApps,
-      categories: totalCategories,
-      stacks: totalStacks,
-      contributors: totalContributors || undefined,
-      stars: totalStars || undefined,
+      totalApps: stats.apps,
+      totalCategories: stats.categories,
+      totalStacks: stats.stacks,
+      totalOwners: stats.contributors,
+      totalStars: stats.stars,
+      originalRepo: stats.originalRepo,
     }}
+    itemsLabel={itemPlural}
+    itemLabel={itemSingular}
+    searchHref={`/${slug}`}
+    searchPlaceholder={`Search ${itemPlural}, stacks, categories, licenses, platforms...`}
+    quickFilters={[
+      { label: `Trending ${itemPlural}`, href: `/${slug}?label=hot` },
+      { label: "Recently added", href: `/${slug}?label=new` },
+      { label: "Established", href: `/${slug}?label=mature` },
+    ]}
     ctas={[
-      { label: `Browse ${slug}`, href: `/${slug}`, variant: "primary" },
-      { label: "About", href: "/about", variant: "outline" },
+      { label: `Browse ${itemPlural}`, href: `/${slug}`, variant: "primary" },
+      { label: `Submit ${itemSingular} via GitHub`, href: "/submit", variant: "outline" },
+      ...(siteConfig.repoUrl
+        ? [{ label: "View source", href: siteConfig.repoUrl, variant: "outline" as const }]
+        : []),
     ]}
   />
 
@@ -200,68 +169,56 @@ function detailHrefFor(r: IndexProjectRecord): string {
 
   <RecordSection
     id="hot"
-    title="Trending"
-    description="The projects getting attention right now — high-star repos and recently active codebases."
-    items={hot}
-    hrefFor={detailHrefFor}
-    viewAllHref={`/${slug}?lens=hot`}
+    title="Trending now"
+    description={`${itemPlural.charAt(0).toUpperCase() + itemPlural.slice(1)} gaining stars, activity, or attention recently.`}
     eyebrow="Hot"
-    emptyLabel="No trending projects yet."
+    items={hotList}
+    hrefFor={(r) => `/${slug}/${r.slug}`}
+    viewAllHref={`/${slug}?label=hot`}
+    viewAllLabel={`View all trending ${itemPlural}`}
   />
 
   <RecordSection
     id="new"
     title="Recently added"
-    description="Fresh entries — pushed within the last week or carrying the curated 'new' label."
-    items={newItems}
-    hrefFor={detailHrefFor}
-    viewAllHref={`/${slug}?lens=new`}
+    description={`${itemPlural.charAt(0).toUpperCase() + itemPlural.slice(1)} added to the directory in the last few weeks.`}
     eyebrow="New"
-    emptyLabel="No new projects yet."
+    items={newList}
+    hrefFor={(r) => `/${slug}/${r.slug}`}
+    viewAllHref={`/${slug}?label=new`}
+    viewAllLabel={`View all recently added`}
   />
 
   <RecordSection
     id="mature"
     title="Established"
-    description="Long-running curated projects with deep history and stable architecture."
-    items={mature}
-    hrefFor={detailHrefFor}
-    viewAllHref={`/${slug}?lens=mature`}
+    description={`Long-running curated ${itemPlural} with strong history, active maintainers, and real-world usage.`}
     eyebrow="Mature"
-    emptyLabel="No established projects yet."
+    items={matureList}
+    hrefFor={(r) => `/${slug}/${r.slug}`}
+    viewAllHref={`/${slug}?label=mature`}
+    viewAllLabel={`View all established`}
   />
 
-  {stacks.length > 0 && (
-    <StackGrid
-      stacks={stacks}
-      pathPrefix={`/${slug}`}
-    />
-  )}
-
-  {categories.length > 0 && (
-    <CategoryGrid
-      categories={categories}
-      pathPrefix={`/${slug}`}
-    />
-  )}
+  <StackGrid stacks={stacks} pathPrefix={`/${slug}`} itemLabelPlural={itemPlural} />
+  <CategoryGrid categories={categories} pathPrefix={`/${slug}`} itemLabelPlural={itemPlural} />
 
-  {hasContributors && (
+  {contributors.length > 0 && (
     <ContributorsGrid
-      contributors={contributors!}
-      total={contributors!.length}
-      viewAllHref={siteConfig.repoUrl || undefined}
-      viewAllLabel="View on GitHub"
+      contributors={contributors}
+      total={contributors.length}
+      viewAllHref={`/contributors`}
+      viewAllLabel="View all contributors"
     />
   )}
 
-  {repoStats.originalRepo && (
+  {siteConfig.stats?.originalRepo && (
     <OriginalCollection
-      repoUrl={repoStats.originalRepo}
+      repoUrl={siteConfig.stats.originalRepo}
       stats={{
-        stars: repoStats.stars,
-        forks: repoStats.forks,
-        contributors: repoStats.contributors,
-        description: repoStats.description,
+        stars: siteConfig.stats.originalStars,
+        forks: siteConfig.stats.originalForks,
+        contributors: siteConfig.stats.originalContributors,
       }}
     />
   )}