npm - @grove-dev/astro - Versions diffs - 0.1.0 - Mend

@grove-dev/astro 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (109) hide show

package/templates/default/src/components/layout/Seo.astro ADDED Viewed

@@ -0,0 +1,120 @@
+---
+import { siteConfig } from "../../data/config";
+// SPDX-License-Identifier: MIT
+/**
+ * Per-page SEO: <title>, description, canonical, Open Graph, Twitter Card,
+ * and JSON-LD structured data. Designed to be used inside <head> by the
+ * BaseLayout. Pages pass the rich props they care about; everything else
+ * has a sensible default derived from the site config and the Astro URL.
+ *
+ * Renders:
+ *   - <title>, meta description, canonical link
+ *   - Open Graph (og:*) for Facebook, LinkedIn, Discord, Slack, etc.
+ *   - Twitter Card (twitter:*) for X / Twitter
+ *   - JSON-LD WebSite + Organization on every page
+ *   - JSON-LD SoftwareSourceCode (or custom) when `jsonLd` is provided
+ *     (e.g. on /apps/[slug] for the per-app structured data)
+ *
+ * Noindex is opt-in via the `noindex` prop. By default everything is
+ * indexable; the only noindex target today is the thin /submit wrapper.
+ */
+interface Props {
+  title: string;
+  description: string;
+  /** Open Graph / Twitter image. Default: /og-image.svg. Should be absolute or root-relative. */
+  image?: string;
+  /** og:type. Default: "website". Use "article" for blog posts / changelog. */
+  type?: "website" | "article" | "profile";
+  /** Set true to add noindex,nofollow. */
+  noindex?: boolean;
+  /** Extra JSON-LD payload (object) — typically SoftwareSourceCode on app pages. */
+  jsonLd?: Record<string, unknown> | Record<string, unknown>[];
+}
+const {
+  title,
+  description,
+  image = "/og-image.svg",
+  type = "website",
+  noindex = false,
+  jsonLd,
+} = Astro.props;
+const site = Astro.site ?? new URL("https://open-apps.dev");
+const canonical = new URL(Astro.url.pathname, site).toString();
+const ogImage = new URL(image, site).toString();
+// Truncate description for OG/Twitter where longer is worse (160–200 chars).
+function truncate(s: string, max: number): string {
+  if (s.length <= max) return s;
+  return s.slice(0, max - 1).trimEnd() + "\u2026";
+}
+const shortDescription = truncate(description, 200);
+// WebSite + Organization JSON-LD. These are site-wide identity signals
+// that should appear on every page (Google uses them for site links
+// and the knowledge panel).
+const websiteLd = {
+  "@context": "https://schema.org",
+  "@type": "WebSite",
+  name: `${siteConfig.name}`,
+  description:
+    "A curated, self-refreshing directory of real open-source application codebases.",
+  url: site.toString().replace(/\/$/, ""),
+  inLanguage: "en",
+  potentialAction: {
+    "@type": "SearchAction",
+    target: `${site.toString().replace(/\/$/, "")}/apps?q={search_term_string}`,
+    "query-input": "required name=search_term_string",
+  },
+};
+const organizationLd = {
+  "@context": "https://schema.org",
+  "@type": "Organization",
+  name: `${siteConfig.name}`,
+  url: site.toString().replace(/\/$/, ""),
+  logo: new URL("/og-image.svg", site).toString(),
+  sameAs: ["https://github.com/tortuvshin/open-apps"],
+};
+---
+<!-- Primary meta -->
+<title>{title}</title>
+<meta name="description" content={description} />
+<link rel="canonical" href={canonical} />
+{noindex && <meta name="robots" content="noindex,nofollow" />}
+<!-- Open Graph -->
+<meta property="og:type" content={type} />
+<meta property="og:url" content={canonical} />
+<meta property="og:title" content={title} />
+<meta property="og:description" content={shortDescription} />
+<meta property="og:image" content={ogImage} />
+<meta property="og:image:width" content="1200" />
+<meta property="og:image:height" content="630" />
+<meta property="og:image:alt" content="{siteConfig.name} — a directory of real open-source apps" />
+<meta property="og:site_name" content="{siteConfig.name}" />
+<meta property="og:locale" content="en" />
+<!-- Twitter Card -->
+<meta name="twitter:card" content="summary_large_image" />
+<meta name="twitter:title" content={title} />
+<meta name="twitter:description" content={shortDescription} />
+<meta name="twitter:image" content={ogImage} />
+<meta name="twitter:image:alt" content="{siteConfig.name} — a directory of real open-source apps" />
+<!-- JSON-LD: site-wide identity -->
+<script is:inline type="application/ld+json" set:html={JSON.stringify(websiteLd)} />
+<script is:inline type="application/ld+json" set:html={JSON.stringify(organizationLd)} />
+<!-- JSON-LD: per-page (SoftwareSourceCode for /apps/[slug], etc.) -->
+{jsonLd && (
+  <script
+    is:inline
+    type="application/ld+json"
+    set:html={JSON.stringify(Array.isArray(jsonLd) ? jsonLd : [jsonLd])}
+  />
+)}

package/templates/default/src/components/layout/ThemeToggle.astro ADDED Viewed

@@ -0,0 +1,97 @@
+---
+// A three-position theme switcher: light / dark / system.
+//
+// State is persisted in `localStorage` under the key "open-apps-theme".
+// On mount it reads the stored value (or "system" if none), applies
+// the corresponding class to <html>, and re-syncs when the OS
+// preference changes (only meaningful when mode is "system").
+//
+// Implementation note: the actual <html class="dark"> toggle happens
+// in the inline script in `src/components/layout/BaseLayout.astro`
+// (THEME_INIT). That script runs before paint so the user never sees
+// a flash of the wrong theme.
+interface Props {
+  class?: string;
+}
+const { class: className = "" } = Astro.props;
+---
+<button
+  type="button"
+  id="theme-toggle"
+  data-theme-toggle
+  aria-label="Toggle theme"
+  title="Toggle theme"
+  class={`relative inline-flex h-8 w-8 items-center justify-center rounded-md border border-ink-200 bg-white text-ink-700 transition-colors hover:border-ink-300 hover:bg-ink-50 dark:border-ink-800 dark:bg-ink-950 dark:text-ink-200 dark:hover:border-ink-700 dark:hover:bg-ink-900/40 ${className}`}
+>
+  {/* Sun — shown in dark mode (click to go light) */}
+  <svg
+    class="h-4 w-4 hidden dark:block"
+    viewBox="0 0 24 24"
+    fill="none"
+    stroke="currentColor"
+    stroke-width="1.8"
+    stroke-linecap="round"
+    stroke-linejoin="round"
+    aria-hidden="true"
+  >
+    <circle cx="12" cy="12" r="4"/>
+    <path d="M12 2v2M12 20v2M4.93 4.93l1.41 1.41M17.66 17.66l1.41 1.41M2 12h2M20 12h2M4.93 19.07l1.41-1.41M17.66 6.34l1.41-1.41"/>
+  </svg>
+  {/* Moon — shown in light mode (click to go dark) */}
+  <svg
+    class="h-4 w-4 block dark:hidden"
+    viewBox="0 0 24 24"
+    fill="none"
+    stroke="currentColor"
+    stroke-width="1.8"
+    stroke-linecap="round"
+    stroke-linejoin="round"
+    aria-hidden="true"
+  >
+    <path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79Z"/>
+  </svg>
+</button>
+<script>
+  // The toggle button simply rotates between the three modes on
+  // click. The actual class application lives in the page-level
+  // THEME_INIT script so behaviour stays consistent.
+  const STORAGE_KEY = "open-apps-theme";
+  type Mode = "light" | "dark" | "system";
+  function currentMode(): Mode {
+    const stored = localStorage.getItem(STORAGE_KEY);
+    return stored === "light" || stored === "dark" || stored === "system"
+      ? stored
+      : "system";
+  }
+  function rotate(): Mode {
+    const order: Mode[] = ["light", "dark", "system"];
+    const next = order[(order.indexOf(currentMode()) + 1) % order.length];
+    localStorage.setItem(STORAGE_KEY, next);
+    // Notify the page-level listener.
+    window.dispatchEvent(new CustomEvent("theme:set", { detail: next }));
+    return next;
+  }
+  // A small tooltip label so the user knows what mode they'll get
+  // on the next click. We re-read current mode on focus/hover so it
+  // stays in sync.
+  function updateLabel(btn: HTMLButtonElement) {
+    btn.title = `Theme: ${currentMode()} (click to switch)`;
+  }
+  document.querySelectorAll<HTMLButtonElement>("[data-theme-toggle]").forEach((btn) => {
+    updateLabel(btn);
+    btn.addEventListener("click", () => {
+      rotate();
+      updateLabel(btn);
+    });
+    btn.addEventListener("mouseenter", () => updateLabel(btn));
+    btn.addEventListener("focus", () => updateLabel(btn));
+  });
+</script>

package/templates/default/src/data/apps.ts ADDED Viewed

@@ -0,0 +1,149 @@
+import generatedJson from "../../data/generated/apps.json";
+import type { OpenSourceApp, AppLabel } from "./types";
+// ──────────────────────────────────────────────────────────────────────
+// Source of truth: data/generated/apps.json, produced at build time
+// from data/apps/*.yml by scripts/build-apps-json.mjs. The yml files
+// are the human-edited source; this file is just a typed re-export
+// that fills in safe defaults so consumers don't have to guard every
+// optional field.
+//
+// When adding a new app: write a yml in data/apps/, run
+// `pnpm run build:data`, and it will appear here.
+// ──────────────────────────────────────────────────────────────────────
+const generated = generatedJson as { apps: unknown[] };
+type GeneratedApp = Partial<OpenSourceApp> & {
+  slug: string;
+  name: string;
+  repoUrl: string;
+  description?: string;
+  stack: string;
+  platforms: string[];
+  category: string;
+  activity?: {
+    stars?: number;
+    forks?: number;
+    lastCommitAt?: string | null;
+    contributors?: number;
+    updatedAt?: string;
+  };
+};
+/**
+ * Auto-compute labels for an app from its activity block. Used as a
+ * fallback when a curator hasn't hand-set `labels:` in the yml. Drives
+ * the homepage "new / hot / mature" sections.
+ *
+ *   mature — stars ≥ 500, OR very high stars (popular, established)
+ *   hot    — last commit within the last 6 months (currently active)
+ *   new    — emerging: not mature, not in the last commit window, or
+ *            no commit signal at all
+ *
+ * Multiple labels can apply (a popular active project is both mature
+ * and hot).
+ */
+function computeLabels(g: GeneratedApp): AppLabel[] {
+  const labels: AppLabel[] = [];
+  // After the schemaVersion 1 migration, stars + lastCommitAt live at
+  // the top level of the generated record (the v1 normalizer in
+  // `app-schema.mjs` flattens `github.repository.stargazers_count`
+  // and `github.repository.pushed_at` to top-level). The old
+  // `g.activity.stars` shape still works for legacy records, so we
+  // fall back to it for mixed input.
+  const stars =
+    typeof g.stars === "number"
+      ? g.stars
+      : typeof g.activity?.stars === "number"
+        ? g.activity.stars
+        : 0;
+  const lastCommit = g.lastCommitAt ?? g.activity?.lastCommitAt;
+  if (stars >= 500) labels.push("mature");
+  if (stars >= 100 && stars < 500) labels.push("hot");
+  if (stars < 100) labels.push("new");
+  // Hot: recent commit and not already tagged as such
+  if (lastCommit) {
+    const sixMonthsAgo = new Date();
+    sixMonthsAgo.setMonth(sixMonthsAgo.getMonth() - 6);
+    if (new Date(lastCommit) >= sixMonthsAgo && !labels.includes("hot")) {
+      labels.push("hot");
+    }
+  }
+  return labels;
+}
+/**
+ * Map a generated yml-shaped record to the OpenSourceApp shape that
+ * pages expect. Fills defaults, flattens `activity.stars` → `stars`,
+ * and tolerates missing curation fields.
+ */
+function normalize(g: GeneratedApp): OpenSourceApp {
+  const a = g.activity ?? {};
+  return {
+    slug: g.slug,
+    name: g.name,
+    description: g.description ?? "",
+    repoUrl: g.repoUrl,
+    homepageUrl: g.homepageUrl,
+    stack: g.stack,
+    stacks: g.stacks,
+    platforms: g.platforms ?? [],
+    distribution: g.distribution,
+    category: g.category,
+    tags: g.tags,
+    logoUrl: g.logoUrl,
+    stars: typeof a.stars === "number" ? a.stars : g.stars,
+    license: g.license,
+    status: g.status,
+    addedAt: g.addedAt,
+    lastCommitAt: a.lastCommitAt ?? g.lastCommitAt,
+    labels: g.labels && g.labels.length > 0 ? g.labels : computeLabels(g),
+    // Curation (optional)
+    projectType: g.projectType,
+    stateManagement: g.stateManagement,
+    backend: g.backend,
+    architecture: g.architecture,
+    difficulty: g.difficulty,
+    codebaseSize: g.codebaseSize,
+    bestFor: g.bestFor,
+    whyListed: g.whyListed,
+    caveats: g.caveats,
+    goodFirstIssues: g.goodFirstIssues,
+    contributionGuide: g.contributionGuide,
+    launchedBy: g.launchedBy,
+    launchAsk: g.launchAsk,
+    lenses: g.lenses,
+    scores: g.scores,
+    curation: g.curation,
+    github: g.github,
+    health: g.health,
+    tier: g.tier,
+  };
+}
+const generatedApps = generated.apps as GeneratedApp[];
+export const apps: OpenSourceApp[] = generatedApps.map(normalize);
+// ── Convenience filters ──────────────────────────────────────────────
+export function newApps(): OpenSourceApp[] {
+  return apps.filter((a) => a.labels?.includes("new"));
+}
+export function hotApps(): OpenSourceApp[] {
+  return apps.filter((a) => a.labels?.includes("hot"));
+}
+export function matureApps(): OpenSourceApp[] {
+  return apps.filter((a) => a.labels?.includes("mature"));
+}
+// ── Lookups ──────────────────────────────────────────────────────────
+const bySlug = new Map(apps.map((a) => [a.slug, a]));
+export function appBySlug(slug: string): OpenSourceApp | undefined {
+  return bySlug.get(slug);
+}

package/templates/default/src/data/categories.ts ADDED Viewed

@@ -0,0 +1,27 @@
+export type Category = {
+  slug: string;
+  name: string;
+  blurb: string;
+};
+// Static taxonomy. Counts are NOT stored here — they are computed at
+// build time from data/generated/apps.json via src/lib/category-counts.ts
+// so the numbers always match what's actually rendered.
+export const categories: Category[] = [
+  { slug: "productivity", name: "Productivity", blurb: "Tasks, notes, calendars, knowledge bases." },
+  { slug: "finance", name: "Finance", blurb: "Budgeting, wallets, expense tracking." },
+  { slug: "education", name: "Education", blurb: "Flashcards, learning, reference apps." },
+  { slug: "tools", name: "Tools", blurb: "Browsers, utilities, dev helpers, file tools." },
+  { slug: "communication", name: "Communication", blurb: "Chat, messaging, social, team tools." },
+  { slug: "health-and-fitness", name: "Health and Fitness", blurb: "Workouts, nutrition, wellness tracking." },
+  { slug: "business", name: "Business", blurb: "Invoicing, jobs, marketplace, ops tools." },
+  { slug: "games", name: "Games", blurb: "Open-source games and engines." },
+  { slug: "media", name: "Media", blurb: "Music, movies, photos, audio and video." },
+  { slug: "entertainment", name: "Entertainment", blurb: "TV, movies, books, anime, ebooks." },
+  { slug: "social-network", name: "Social Network", blurb: "Decentralized social clients and readers." },
+  { slug: "shopping", name: "Shopping", blurb: "E-commerce, delivery, food, retail." },
+  { slug: "news", name: "News and Magazine", blurb: "Hacker News clients, RSS, magazines." },
+  { slug: "travel", name: "Travel", blurb: "Flights, tourism, cab sharing, guides." },
+  { slug: "lifestyle", name: "Lifestyle", blurb: "Habits, journaling, daily life tools." },
+  { slug: "personalization", name: "Personalization", blurb: "Launchers, themes, customization." },
+];

package/templates/default/src/data/config.ts ADDED Viewed

@@ -0,0 +1,28 @@
+/**
+ * Site config exposed to Astro pages.
+ *
+ * This file is the typed view of `curated.config.ts`. The CLI builds it
+ * from the project-root config at `grove build-data` time. Astro
+ * pages and components import it directly for branding strings.
+ *
+ * Do not edit by hand. Re-run `grove build-data` after changing
+ * `curated.config.ts`.
+ */
+export type SiteConfig = {
+  name: string;
+  tagline: string;
+  description: string;
+  siteUrl: string;
+  repoUrl: string;
+  itemLabel: string;
+};
+export const siteConfig: SiteConfig = {
+  name: "Grove",
+  tagline: "A living, health-aware developer directory.",
+  description: "A searchable directory of open-source projects — organized by stack, category, platform, license, activity, and maturity.",
+  siteUrl: "https://example.com",
+  repoUrl: "https://github.com/tortuvshin/grove",
+  itemLabel: "project",
+};

package/templates/default/src/data/contributors.ts ADDED Viewed

@@ -0,0 +1,96 @@
+export type Contributor = {
+  username: string;
+  name?: string;
+  avatarUrl: string;
+  profileUrl: string;
+  contributions?: number;
+};
+// AUTO-GENERATED by scripts/sync-contributors.mjs — do not edit by hand.
+// Re-run the script (or wait for the weekly workflow) to refresh from GitHub.
+// Source: GET /repos/tortuvshin/open-apps/contributors (82 named contributors).
+// Anonymous contributors are excluded — the homepage grid renders <a> avatars with no anonymous target.
+export const contributors: Contributor[] = [
+  { username: "tortuvshin", avatarUrl: "https://avatars.githubusercontent.com/u/9257227?v=4", profileUrl: "https://github.com/tortuvshin", contributions: 140 },
+  { username: "j-j-gajjar", avatarUrl: "https://avatars.githubusercontent.com/u/57590688?v=4", profileUrl: "https://github.com/j-j-gajjar", contributions: 5 },
+  { username: "ArizArmeidi", avatarUrl: "https://avatars.githubusercontent.com/u/60814961?v=4", profileUrl: "https://github.com/ArizArmeidi", contributions: 3 },
+  { username: "vellt", avatarUrl: "https://avatars.githubusercontent.com/u/61885011?v=4", profileUrl: "https://github.com/vellt", contributions: 3 },
+  { username: "tejasbadone", avatarUrl: "https://avatars.githubusercontent.com/u/81501235?v=4", profileUrl: "https://github.com/tejasbadone", contributions: 3 },
+  { username: "ErfanRht", avatarUrl: "https://avatars.githubusercontent.com/u/68302442?v=4", profileUrl: "https://github.com/ErfanRht", contributions: 2 },
+  { username: "monolidth", avatarUrl: "https://avatars.githubusercontent.com/u/71930307?v=4", profileUrl: "https://github.com/monolidth", contributions: 2 },
+  { username: "proninyaroslav", avatarUrl: "https://avatars.githubusercontent.com/u/7840559?v=4", profileUrl: "https://github.com/proninyaroslav", contributions: 2 },
+  { username: "Tarikul711", avatarUrl: "https://avatars.githubusercontent.com/u/9304805?v=4", profileUrl: "https://github.com/Tarikul711", contributions: 2 },
+  { username: "lucalves", avatarUrl: "https://avatars.githubusercontent.com/u/17712401?v=4", profileUrl: "https://github.com/lucalves", contributions: 2 },
+  { username: "1hanzla100", avatarUrl: "https://avatars.githubusercontent.com/u/59178380?v=4", profileUrl: "https://github.com/1hanzla100", contributions: 2 },
+  { username: "jerichoi224", avatarUrl: "https://avatars.githubusercontent.com/u/4184001?v=4", profileUrl: "https://github.com/jerichoi224", contributions: 2 },
+  { username: "tsvillain", avatarUrl: "https://avatars.githubusercontent.com/u/42140007?v=4", profileUrl: "https://github.com/tsvillain", contributions: 1 },
+  { username: "TNT-Likely", avatarUrl: "https://avatars.githubusercontent.com/u/9278923?v=4", profileUrl: "https://github.com/TNT-Likely", contributions: 1 },
+  { username: "sumittiware", avatarUrl: "https://avatars.githubusercontent.com/u/64718675?v=4", profileUrl: "https://github.com/sumittiware", contributions: 1 },
+  { username: "simonbengtsson", avatarUrl: "https://avatars.githubusercontent.com/u/3586691?v=4", profileUrl: "https://github.com/simonbengtsson", contributions: 1 },
+  { username: "shaxxx", avatarUrl: "https://avatars.githubusercontent.com/u/1778875?v=4", profileUrl: "https://github.com/shaxxx", contributions: 1 },
+  { username: "88srzh", avatarUrl: "https://avatars.githubusercontent.com/u/61797666?v=4", profileUrl: "https://github.com/88srzh", contributions: 1 },
+  { username: "SatyamX64", avatarUrl: "https://avatars.githubusercontent.com/u/62766656?v=4", profileUrl: "https://github.com/SatyamX64", contributions: 1 },
+  { username: "sarvesh4396", avatarUrl: "https://avatars.githubusercontent.com/u/68162479?v=4", profileUrl: "https://github.com/sarvesh4396", contributions: 1 },
+  { username: "illussna", avatarUrl: "https://avatars.githubusercontent.com/u/20238269?v=4", profileUrl: "https://github.com/illussna", contributions: 1 },
+  { username: "SAHILDUDHAL21", avatarUrl: "https://avatars.githubusercontent.com/u/129080375?v=4", profileUrl: "https://github.com/SAHILDUDHAL21", contributions: 1 },
+  { username: "SaadAAkash", avatarUrl: "https://avatars.githubusercontent.com/u/16515550?v=4", profileUrl: "https://github.com/SaadAAkash", contributions: 1 },
+  { username: "Rohithgilla12", avatarUrl: "https://avatars.githubusercontent.com/u/19389850?v=4", profileUrl: "https://github.com/Rohithgilla12", contributions: 1 },
+  { username: "teolemon", avatarUrl: "https://avatars.githubusercontent.com/u/1689815?v=4", profileUrl: "https://github.com/teolemon", contributions: 1 },
+  { username: "Re4ch-Jay", avatarUrl: "https://avatars.githubusercontent.com/u/111555521?v=4", profileUrl: "https://github.com/Re4ch-Jay", contributions: 1 },
+  { username: "pauek", avatarUrl: "https://avatars.githubusercontent.com/u/4069?v=4", profileUrl: "https://github.com/pauek", contributions: 1 },
+  { username: "DaNnyKg07", avatarUrl: "https://avatars.githubusercontent.com/u/78636435?v=4", profileUrl: "https://github.com/DaNnyKg07", contributions: 1 },
+  { username: "omar-h-omar", avatarUrl: "https://avatars.githubusercontent.com/u/58376513?v=4", profileUrl: "https://github.com/omar-h-omar", contributions: 1 },
+  { username: "FatoomRe", avatarUrl: "https://avatars.githubusercontent.com/u/112693194?v=4", profileUrl: "https://github.com/FatoomRe", contributions: 1 },
+  { username: "yon30c", avatarUrl: "https://avatars.githubusercontent.com/u/83658386?v=4", profileUrl: "https://github.com/yon30c", contributions: 1 },
+  { username: "y-pakorn", avatarUrl: "https://avatars.githubusercontent.com/u/48324733?v=4", profileUrl: "https://github.com/y-pakorn", contributions: 1 },
+  { username: "virlow-voice", avatarUrl: "https://avatars.githubusercontent.com/u/102702984?v=4", profileUrl: "https://github.com/virlow-voice", contributions: 1 },
+  { username: "trizin", avatarUrl: "https://avatars.githubusercontent.com/u/25263018?v=4", profileUrl: "https://github.com/trizin", contributions: 1 },
+  { username: "sparkleMing", avatarUrl: "https://avatars.githubusercontent.com/u/38350996?v=4", profileUrl: "https://github.com/sparkleMing", contributions: 1 },
+  { username: "softjapan", avatarUrl: "https://avatars.githubusercontent.com/u/11269856?v=4", profileUrl: "https://github.com/softjapan", contributions: 1 },
+  { username: "moda20", avatarUrl: "https://avatars.githubusercontent.com/u/23613485?v=4", profileUrl: "https://github.com/moda20", contributions: 1 },
+  { username: "mihalycsaba", avatarUrl: "https://avatars.githubusercontent.com/u/50019470?v=4", profileUrl: "https://github.com/mihalycsaba", contributions: 1 },
+  { username: "ivirtex", avatarUrl: "https://avatars.githubusercontent.com/u/57679865?v=4", profileUrl: "https://github.com/ivirtex", contributions: 1 },
+  { username: "comerc", avatarUrl: "https://avatars.githubusercontent.com/u/1025241?v=4", profileUrl: "https://github.com/comerc", contributions: 1 },
+  { username: "albemala", avatarUrl: "https://avatars.githubusercontent.com/u/2332860?v=4", profileUrl: "https://github.com/albemala", contributions: 1 },
+  { username: "xal", avatarUrl: "https://avatars.githubusercontent.com/u/1388084?v=4", profileUrl: "https://github.com/xal", contributions: 1 },
+  { username: "yash1200", avatarUrl: "https://avatars.githubusercontent.com/u/38391570?v=4", profileUrl: "https://github.com/yash1200", contributions: 1 },
+  { username: "wad3g", avatarUrl: "https://avatars.githubusercontent.com/u/2086896?v=4", profileUrl: "https://github.com/wad3g", contributions: 1 },
+  { username: "VarunS2002", avatarUrl: "https://avatars.githubusercontent.com/u/30069380?v=4", profileUrl: "https://github.com/VarunS2002", contributions: 1 },
+  { username: "friebetill", avatarUrl: "https://avatars.githubusercontent.com/u/10923085?v=4", profileUrl: "https://github.com/friebetill", contributions: 1 },
+  { username: "theachoem", avatarUrl: "https://avatars.githubusercontent.com/u/29684683?v=4", profileUrl: "https://github.com/theachoem", contributions: 1 },
+  { username: "Enhancifire", avatarUrl: "https://avatars.githubusercontent.com/u/81345756?v=4", profileUrl: "https://github.com/Enhancifire", contributions: 1 },
+  { username: "Ehtiram-Ullah", avatarUrl: "https://avatars.githubusercontent.com/u/157794767?v=4", profileUrl: "https://github.com/Ehtiram-Ullah", contributions: 1 },
+  { username: "Deepanshu-Rohilla", avatarUrl: "https://avatars.githubusercontent.com/u/52520071?v=4", profileUrl: "https://github.com/Deepanshu-Rohilla", contributions: 1 },
+  { username: "DattatreyaReddy", avatarUrl: "https://avatars.githubusercontent.com/u/58727124?v=4", profileUrl: "https://github.com/DattatreyaReddy", contributions: 1 },
+  { username: "shurygindv", avatarUrl: "https://avatars.githubusercontent.com/u/38868386?v=4", profileUrl: "https://github.com/shurygindv", contributions: 1 },
+  { username: "csuka1219", avatarUrl: "https://avatars.githubusercontent.com/u/70962953?v=4", profileUrl: "https://github.com/csuka1219", contributions: 1 },
+  { username: "ChangJoo-Park", avatarUrl: "https://avatars.githubusercontent.com/u/1451365?v=4", profileUrl: "https://github.com/ChangJoo-Park", contributions: 1 },
+  { username: "KyleKun", avatarUrl: "https://avatars.githubusercontent.com/u/36611739?v=4", profileUrl: "https://github.com/KyleKun", contributions: 1 },
+  { username: "bipinct", avatarUrl: "https://avatars.githubusercontent.com/u/1249142?v=4", profileUrl: "https://github.com/bipinct", contributions: 1 },
+  { username: "Spyy004", avatarUrl: "https://avatars.githubusercontent.com/u/54628130?v=4", profileUrl: "https://github.com/Spyy004", contributions: 1 },
+  { username: "AyanDas-99", avatarUrl: "https://avatars.githubusercontent.com/u/86493736?v=4", profileUrl: "https://github.com/AyanDas-99", contributions: 1 },
+  { username: "aryamangodara", avatarUrl: "https://avatars.githubusercontent.com/u/77824849?v=4", profileUrl: "https://github.com/aryamangodara", contributions: 1 },
+  { username: "agordn52", avatarUrl: "https://avatars.githubusercontent.com/u/17294994?v=4", profileUrl: "https://github.com/agordn52", contributions: 1 },
+  { username: "akmadan", avatarUrl: "https://avatars.githubusercontent.com/u/56507451?v=4", profileUrl: "https://github.com/akmadan", contributions: 1 },
+  { username: "akashlilhare", avatarUrl: "https://avatars.githubusercontent.com/u/39927872?v=4", profileUrl: "https://github.com/akashlilhare", contributions: 1 },
+  { username: "aditya-njr", avatarUrl: "https://avatars.githubusercontent.com/u/169588760?v=4", profileUrl: "https://github.com/aditya-njr", contributions: 1 },
+  { username: "abhith", avatarUrl: "https://avatars.githubusercontent.com/u/7039457?v=4", profileUrl: "https://github.com/abhith", contributions: 1 },
+  { username: "NaserElziadna", avatarUrl: "https://avatars.githubusercontent.com/u/24838963?v=4", profileUrl: "https://github.com/NaserElziadna", contributions: 1 },
+  { username: "brownboycodes", avatarUrl: "https://avatars.githubusercontent.com/u/64550304?v=4", profileUrl: "https://github.com/brownboycodes", contributions: 1 },
+  { username: "mzsdev1", avatarUrl: "https://avatars.githubusercontent.com/u/34914546?v=4", profileUrl: "https://github.com/mzsdev1", contributions: 1 },
+  { username: "mllrr96", avatarUrl: "https://avatars.githubusercontent.com/u/28247455?v=4", profileUrl: "https://github.com/mllrr96", contributions: 1 },
+  { username: "hadiuzzaman524", avatarUrl: "https://avatars.githubusercontent.com/u/52348628?v=4", profileUrl: "https://github.com/hadiuzzaman524", contributions: 1 },
+  { username: "deandreamatias", avatarUrl: "https://avatars.githubusercontent.com/u/21011641?v=4", profileUrl: "https://github.com/deandreamatias", contributions: 1 },
+  { username: "mateusz-bak", avatarUrl: "https://avatars.githubusercontent.com/u/32651935?v=4", profileUrl: "https://github.com/mateusz-bak", contributions: 1 },
+  { username: "maksymilian-majer", avatarUrl: "https://avatars.githubusercontent.com/u/1215868?v=4", profileUrl: "https://github.com/maksymilian-majer", contributions: 1 },
+  { username: "musfique113", avatarUrl: "https://avatars.githubusercontent.com/u/53111065?v=4", profileUrl: "https://github.com/musfique113", contributions: 1 },
+  { username: "Mufaddal5253110", avatarUrl: "https://avatars.githubusercontent.com/u/60619133?v=4", profileUrl: "https://github.com/Mufaddal5253110", contributions: 1 },
+  { username: "Kessir", avatarUrl: "https://avatars.githubusercontent.com/u/2332730?v=4", profileUrl: "https://github.com/Kessir", contributions: 1 },
+  { username: "kaiwalyakoparkar", avatarUrl: "https://avatars.githubusercontent.com/u/53310847?v=4", profileUrl: "https://github.com/kaiwalyakoparkar", contributions: 1 },
+  { username: "Livinglist", avatarUrl: "https://avatars.githubusercontent.com/u/7277662?v=4", profileUrl: "https://github.com/Livinglist", contributions: 1 },
+  { username: "jerald-jacob", avatarUrl: "https://avatars.githubusercontent.com/u/25875900?v=4", profileUrl: "https://github.com/jerald-jacob", contributions: 1 },
+  { username: "jaysavsani07", avatarUrl: "https://avatars.githubusercontent.com/u/43170852?v=4", profileUrl: "https://github.com/jaysavsani07", contributions: 1 },
+  { username: "javipacheco", avatarUrl: "https://avatars.githubusercontent.com/u/456025?v=4", profileUrl: "https://github.com/javipacheco", contributions: 1 },
+  { username: "7flash", avatarUrl: "https://avatars.githubusercontent.com/u/4569866?v=4", profileUrl: "https://github.com/7flash", contributions: 1 },
+  { username: "floranguyen0", avatarUrl: "https://avatars.githubusercontent.com/u/72301141?v=4", profileUrl: "https://github.com/floranguyen0", contributions: 1 },
+];

package/templates/default/src/data/stacks.ts ADDED Viewed

@@ -0,0 +1,47 @@
+export type Stack = {
+  slug: string;
+  name: string;
+  blurb: string;
+  status: "live" | "expanding" | "planned";
+};
+// Static taxonomy. Counts are NOT stored here — they are computed at
+// build time from data/generated/apps.json. See src/lib/stack-counts.ts.
+export const stacks: Stack[] = [
+  {
+    slug: "flutter",
+    name: "Flutter",
+    blurb: "Dart-based, cross-platform mobile apps.",
+    status: "live",
+  },
+  {
+    slug: "react-native",
+    name: "React Native",
+    blurb: "JavaScript / TypeScript mobile apps using React.",
+    status: "expanding",
+  },
+  {
+    slug: "ios",
+    name: "iOS",
+    blurb: "Native Swift apps from the App Store and the open-source community.",
+    status: "expanding",
+  },
+  {
+    slug: "android",
+    name: "Android",
+    blurb: "Native Kotlin / Java apps with a long, mature history.",
+    status: "expanding",
+  },
+  {
+    slug: "kmp",
+    name: "Kotlin Multiplatform",
+    blurb: "Shared Kotlin codebases targeting iOS and Android.",
+    status: "planned",
+  },
+  {
+    slug: "capacitor",
+    name: "Capacitor",
+    blurb: "Hybrid mobile apps built on web standards.",
+    status: "planned",
+  },
+];

package/templates/default/src/data/stats.ts ADDED Viewed

@@ -0,0 +1,65 @@
+// Site stats, derived from generated JSON files at build time.
+//
+// This file imports the same JSON the rest of the app uses, so the numbers
+// here always match what's actually rendered. No hand-tuned magic numbers.
+//
+// Numbers in the rendered UI (hero, header, OriginalCollection) come from
+// this module. If a number looks wrong, refresh the source data:
+//   - pnpm run sync:repo-stats    → data/generated/repo-stats.json (open-apps repo)
+//   - pnpm run sync:contributors  → src/data/contributors.ts
+//   - pnpm run refresh:activity   → data/apps/*.yml (per-app activity, then build:data)
+import generatedJson from "../../data/generated/apps.json";
+import repoStats from "../../data/generated/repo-stats.json";
+import { categories } from "./categories";
+import { contributors } from "./contributors";
+type GeneratedApp = {
+  stack?: string;
+  platforms?: string[];
+};
+type RepoStats = {
+  stars: number;
+  forks: number;
+  watchers?: number;
+  openIssues?: number;
+  defaultBranch?: string;
+  pushedAt?: string;
+  syncedAt?: string;
+};
+const raw = generatedJson as { apps?: GeneratedApp[] };
+const apps: GeneratedApp[] = raw.apps ?? [];
+const repo = repoStats as RepoStats;
+const platforms = new Set<string>();
+for (const a of apps) {
+  for (const p of a.platforms ?? []) platforms.add(p);
+}
+export type SiteStats = {
+  apps: number;
+  contributors: number;
+  stars: number;
+  forks: number;
+  categories: number;
+  stacks: number;
+  platforms: number;
+  originalRepo: string;
+};
+export const stats: SiteStats = {
+  apps: apps.length,
+  contributors: contributors.length,
+  // Stars/forks are the open-apps repo's own — sourced from
+  // data/generated/repo-stats.json, refreshed weekly by the
+  // sync-repo-stats workflow. Previously these were summed across
+  // every app in the directory, which produced 6-figure numbers
+  // for a 4k-star repo.
+  stars: repo.stars,
+  forks: repo.forks,
+  categories: categories.length,
+  stacks: new Set(apps.map((a) => a.stack).filter(Boolean)).size,
+  platforms: platforms.size,
+  originalRepo: "https://github.com/tortuvshin/open-apps",
+};