Public template + discovery-grade README (#5)

Public template + discovery-grade README

Author: fritzhand

.github/screenshots/directory.png

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jeremy Fritzhand
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

.github/screenshots/finder-results.png

@@ -1,71 +1,128 @@
-# Startup India Guide
+<div align="center">
 
-**A searchable, filterable documentation site for the Government of India's _Playbook of Government Schemes and Initiatives for Startups_ (June 2026).**
+# startup-india-guide
 
-69 central government schemes — grants, equity, loans, credit guarantees, incubation and market access — extracted from the official playbook PDF, machine-verified against the source, and organised the way a founder actually looks for money: by need, by stage, by sector.
+**Every central government scheme for Indian startups — one searchable, comparable, verified documentation site.**
+
+The Government of India's 107-page *Playbook of Government Schemes and Initiatives for Startups* (June 2026), rebuilt as a docs site: 69 schemes with verbatim eligibility, benefits and official links, organised the way a founder actually looks for money — by need, by stage, by sector.
+
+[**Live site**](https://fritzhand.github.io/startup-india-guide/) · [**Scheme Finder**](https://fritzhand.github.io/startup-india-guide/finder.html) · [**All 69 schemes**](https://fritzhand.github.io/startup-india-guide/directory.html) · [**Compare**](https://fritzhand.github.io/startup-india-guide/compare.html)
+
+[![Use this template](https://img.shields.io/badge/Use%20this%20template-238636?style=for-the-badge&logo=github&logoColor=white)](https://github.com/fritzhand/startup-india-guide/generate)
+
+![Live on GitHub Pages](https://img.shields.io/badge/live-fritzhand.github.io-1f3864?style=flat-square&logo=githubpages&logoColor=white)
+![Node ≥ 18](https://img.shields.io/badge/node-%E2%89%A5%2018-5FA04E?style=flat-square&logo=nodedotjs&logoColor=white)
+![Zero dependencies](https://img.shields.io/badge/dependencies-zero-0E6B63?style=flat-square)
+![WCAG 2.1 AA](https://img.shields.io/badge/contrast-WCAG%202.1%20AA-359a4c?style=flat-square)
+![License: MIT](https://img.shields.io/badge/license-MIT-bf4c0e?style=flat-square)
+
+<br>
+
+<a href="https://fritzhand.github.io/startup-india-guide/"><img src=".github/screenshots/hero-home.png" alt="The playbook site's home page — hero, stats, and browse-by-support cards" width="840"></a>
+
+*The home page. Palette sampled from the source PDF's own navy, saffron and green.*
+
+</div>
+
+## What it looks like
+
+Four views from the [live site](https://fritzhand.github.io/startup-india-guide/) — dark home, the filterable directory, a scheme one-pager, the finder's results. Light/dark theme, ⌘K search, and mobile-first layout throughout.
+
+| | |
+| --- | --- |
+| ![Home page in dark mode](.github/screenshots/home-dark.png) | ![Directory with filters by support type, stage, sector](.github/screenshots/directory.png) |
+| ![A scheme page: facts panel, eligibility checklist, verified links](.github/screenshots/scheme-page.png) | ![Scheme Finder results grouped by question](.github/screenshots/finder-results.png) |
 
 ## What's on the site
 
 | Page | What it does |
 | --- | --- |
-| **Overview** (`index.html`) | Stats, browse-by-support / stage / sector, flagship schemes |
-| **Scheme Finder** (`finder.html`) | The playbook's official 5-question decision tree as an interactive wizard, plus the full static tree |
-| **All schemes** (`directory.html`) | Filter all 69 schemes by part, support type, lifecycle stage, sector and audience — card or table view, deep-linkable filters (`?support=grant&stage=ideation`) |
-| **Scheme pages** (`schemes/<slug>.html`) | One page per scheme: plain-English summary, objectives, eligibility checklist, benefits, how to apply, verified official links, related schemes, source page citation |
-| **Compare** (`compare.html`) | Up to three schemes side by side |
-| **Lifecycle Map** (`lifecycle.html`) | Which schemes fit ideation → prototype → seed → growth → market access |
-| **What do you need?** (`needs.html`) | Jump from a need (grant / loan / lab / buyers / IP) to the schemes that provide it |
-| **PSU & regulators** (`psu.html`) | 17 startup programs run by PSUs and regulators |
-| **States & UTs** (`states.html`) | Every state/UT startup portal |
-| **Glossary** (`glossary.html`) | The playbook's definitions and abbreviations |
+| [Overview](https://fritzhand.github.io/startup-india-guide/) | Stats, browse by support / stage / sector, flagship schemes |
+| [Scheme Finder](https://fritzhand.github.io/startup-india-guide/finder.html) | The playbook's official 5-question decision tree as an interactive wizard |
+| [All schemes](https://fritzhand.github.io/startup-india-guide/directory.html) | Filter 69 schemes by part, support type, stage, sector, audience — cards or table, deep-linkable (`?support=grant&stage=ideation`) |
+| Scheme pages | One per scheme: plain-English summary, eligibility checklist, benefits, how to apply, verified official links, related schemes, source-page citation |
+| [Compare](https://fritzhand.github.io/startup-india-guide/compare.html) | Up to three schemes side by side |
+| [Lifecycle Map](https://fritzhand.github.io/startup-india-guide/lifecycle.html) | Ideation → prototype → seed → growth → market access |
+| [What do you need?](https://fritzhand.github.io/startup-india-guide/needs.html) | From a need (grant / loan / lab / buyers / IP) to the schemes that provide it |
+| [PSU & regulators](https://fritzhand.github.io/startup-india-guide/psu.html) · [States & UTs](https://fritzhand.github.io/startup-india-guide/states.html) | 17 PSU/regulator programs; every state startup portal |
+| [Glossary](https://fritzhand.github.io/startup-india-guide/glossary.html) · [About](https://fritzhand.github.io/startup-india-guide/about.html) | Definitions, abbreviations, disclaimer, method |
+
+## How it works
+
+```
+Startup-Schemes-Playbook-June-2026.pdf          the source document
+      │
+      │  extract (text + page images) → parse → adversarially verify
+      ▼
+data/*.json                                     the content: 69 schemes, decision tree,
+      │                                         lifecycle, needs index, PSU/states, glossary
+      +
+site/tokens.css + site.css + site.js            the skin (PDF-sampled palette) + engine
+      │
+      │  node build.mjs                         zero dependencies, fails loudly
+      ▼
+docs/  →  GitHub Pages                          80 static pages, ⌘K search, no runtime deps
+```
 
-Site-wide: **⌘K / `/` search** across schemes, glossary, states and PSU programs · **light/dark theme** with system default · mobile-first responsive layout · print-friendly scheme pages · zero runtime dependencies.
+1. **Extract** — every PDF page rendered to text *and* image; scheme one-pagers parsed to structured JSON; hyperlinks taken from the PDF's link annotations, never retyped.
+2. **Verify** — an independent pass re-reads each source page and corrects amounts, bullets and URLs before anything ships.
+3. **Build** — `build.mjs` turns `data/` + `site/` into `docs/`: directory, wizard, compare, search index, sitemap, per-scheme pages.
+4. **Deploy** — pushing to `main` publishes `docs/` to the `gh-pages` branch via the included workflow.
 
-## Enable GitHub Pages
+## Use this as a template
 
-The generated site lives in `docs/`. To publish it:
+The engine is content-agnostic: it turns any structured reference corpus — a scheme catalogue, a benefits handbook, an internal policy binder — into this site. Click **[Use this template](https://github.com/fritzhand/startup-india-guide/generate)**, then:
 
-1. Repo **Settings → Pages**
-2. Source: **Deploy from a branch**
-3. Branch: **`gh-pages`**, folder **`/` (root)** — already set up; the `Publish site to gh-pages` workflow refreshes it on every push to `main`
-4. Save — the site appears at `https://<user>.github.io/startup-india-guide/`
+1. **Point it at your home.** Edit `site.config.json` — `siteName`, `siteBase`, `pathPrefix`, `repo`.
+2. **Bring your content.** Replace `data/*.json` (schemes, decision tree, lifecycle, needs index, glossary). The shapes are plain and documented by example; `data/aliases.json` resolves any cross-reference spellings.
+3. **Wear your brand.** `site/tokens.css` is the only file that knows the palette — light and dark themes, ~60 custom properties.
+4. **Build & publish.** `node build.mjs`, push, and enable Pages (the included workflow publishes `docs/` → `gh-pages`).
+
+The build fails loudly on duplicate slugs, missing fields, malformed URLs, or any scheme name that doesn't resolve to a page — broken cross-references can't ship silently.
 
 ## Repo tour
 
 ```
 startup-india-guide/
 ├── Startup-Schemes-Playbook-June-2026.pdf   # the source document (also served by the site)
-├── data/                    # the extracted, verified content — the single source of truth
+├── site.config.json         # template knobs: site name, base URL, path prefix, repo
+├── data/                    # the extracted, verified content — single source of truth
 │   ├── schemes.json         # 69 schemes: verbatim eligibility/benefits/links + tags
 │   ├── decision-tree.json   # the 5-question finder
 │   ├── lifecycle.json       # stage → schemes map
 │   ├── needs-index.json     # need → schemes map
-│   ├── master? — master-table columns (howMuch, category) are merged into schemes.json
-│   ├── psu.json, states.json, glossary.json, about.json
-│   └── aliases.json         # printed-name → slug overrides for cross-reference resolution
+│   ├── psu.json · states.json · glossary.json · about.json
+│   └── aliases.json         # printed-name → slug overrides for cross-references
 ├── site/                    # the engine — consumed by build.mjs
-│   ├── tokens.css           # the brand skin (palette sampled from the PDF) — light + dark
+│   ├── tokens.css           # the skin: PDF-sampled palette, light + dark
 │   ├── site.css             # layout & component vocabulary; reads only tokens
 │   └── site.js              # search, filters, wizard, compare, theme toggle
-├── build.mjs                # data + site → docs/  (zero dependencies, Node ≥ 18)
-└── docs/                    # GENERATED — never hand-edit; this is what GitHub Pages serves
+├── build.mjs                # data + site → docs/   (zero dependencies, Node ≥ 18)
+├── docs/                    # GENERATED — never hand-edit; what GitHub Pages serves
+└── .github/workflows/deploy-pages.yml   # publishes docs/ → gh-pages on push to main
 ```
 
 ## Working on the site
 
 ```bash
-node build.mjs        # regenerate docs/ from data/ + site/
-npx serve docs        # or: python3 -m http.server -d docs 8000
+node build.mjs                        # regenerate docs/ from data/ + site/
+python3 -m http.server -d docs 8000   # preview locally (or: npx serve docs)
 ```
 
-- **Content change** (a scheme's amount, a new link)? Edit `data/*.json`, rebuild.
-- **Design change**? Edit `site/tokens.css` (colours/fonts) or `site/site.css` (components), rebuild.
-- **Never edit `docs/`** — it is overwritten on every build.
-
-The build **fails loudly** on duplicate slugs, missing required fields, malformed URLs, or any scheme name referenced in the decision tree / lifecycle / needs index that doesn't resolve to a scheme page (fix those by adding an entry to `data/aliases.json`).
+- **Content change** (an amount, a new link, a new scheme)? Edit `data/*.json`, rebuild.
+- **Design change**? Edit `site/tokens.css` (palette/fonts) or `site/site.css` (components), rebuild.
+- **Never edit `docs/`** — every build overwrites it.
 
 ## How the data was made
 
-Each of the playbook's 107 pages was extracted to text and rendered to an image; every scheme one-pager was parsed into structured JSON and then **independently re-verified against the source page** (amounts, eligibility bullets, benefits, URLs). Hyperlinks come from the PDF's link annotations — never reconstructed by hand. Each scheme page cites the playbook page it came from.
+Each of the playbook's 107 pages was extracted to text and rendered to an image; every scheme one-pager was parsed into structured JSON and then **independently re-verified against the source page** — ₹ amounts, eligibility bullets, benefits and URLs are reproduced as printed, and each scheme page cites the playbook page it came from. Hyperlinks come from the PDF's link annotations, never reconstructed by hand.
+
+## Honest limitations
+
+- **Scheme details drift.** Deadlines, corpus sizes and application windows change after any snapshot; every page carries a "verify on the official portal" notice for exactly that reason.
+- **This is an independent reference,** not a government website, and not legal or financial advice.
+- **Extraction is machine-verified, not lawyer-reviewed.** The verification pass catches transcription errors; it cannot catch changes the government made after June 2026.
+
+## License
 
-This is an independent reference, not a government website. Scheme details change — always verify on the linked official portals before applying.
+MIT — see [LICENSE](LICENSE). The underlying playbook is a Government of India publication; this repo reproduces its content as a reference with attribution and a link to [the source PDF](Startup-Schemes-Playbook-June-2026.pdf).

.github/screenshots/hero-home.png

@@ -19,7 +19,16 @@ const DATA = join(ROOT, "data");
 const SITE = join(ROOT, "site");
 const OUT = join(ROOT, "docs");
 const PDF_NAME = "Startup-Schemes-Playbook-June-2026.pdf";
-const SITE_BASE = "https://fritzhand.github.io/startup-india-guide/"; // used for sitemap + og:url only
+
+/* site.config.json — the template knobs: where the site is hosted and what
+   it is called. Everything else is content (data/) or skin (site/). */
+const CONFIG = existsSync(join(ROOT, "site.config.json"))
+  ? JSON.parse(readFileSync(join(ROOT, "site.config.json"), "utf8"))
+  : {};
+const SITE_NAME = CONFIG.siteName || "Startup Schemes Playbook";
+const SITE_BASE = CONFIG.siteBase || "https://fritzhand.github.io/startup-india-guide/"; // sitemap + og
+const PATH_PREFIX = CONFIG.pathPrefix ?? "/startup-india-guide/"; // 404 page absolute links
+const REPO_URL = CONFIG.repo || "https://github.com/fritzhand/startup-india-guide";
 
 /* ---------------- utilities ---------------- */
 const readJSON = (f) => JSON.parse(readFileSync(join(DATA, f), "utf8"));
@@ -255,8 +264,12 @@ const themeBoot = `<script>(function(){var t;try{t=localStorage.getItem("playboo
 if(t!=="light"&&t!=="dark"){t=window.matchMedia&&matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light"}
 document.documentElement.setAttribute("data-theme",t)})();</script>`;
 
+const brandParts = SITE_NAME.split(" ");
+const brandMain = brandParts.length > 1 ? brandParts.slice(0, -1).join(" ") : SITE_NAME;
+const brandThin = brandParts.length > 1 ? brandParts[brandParts.length - 1] : "";
+
 function shell({ root, active, title, description, body, extraHead = "", pageClass = "", toc = "" }) {
-  const fullTitle = title ? `${title} · Startup Schemes Playbook` : "Startup Schemes Playbook — Government Schemes for Indian Startups";
+  const fullTitle = title ? `${title} · ${SITE_NAME}` : `${SITE_NAME} — Government Schemes for Indian Startups`;
   return `<!doctype html>
 <html lang="en" data-root="${root}">
 <head>
@@ -269,7 +282,7 @@ function shell({ root, active, title, description, body, extraHead = "", pageCla
 <meta property="og:title" content="${attr(fullTitle)}">
 <meta property="og:description" content="${attr(description)}">
 <meta property="og:type" content="website">
-<meta property="og:site_name" content="Startup Schemes Playbook">
+<meta property="og:site_name" content="${attr(SITE_NAME)}">
 <meta property="og:image" content="${SITE_BASE}assets/og.png">
 <meta name="twitter:card" content="summary_large_image">
 <link rel="icon" type="image/svg+xml" href="${root}assets/favicon.svg">
@@ -287,7 +300,7 @@ ${extraHead}
   <button class="nav-toggle" id="nav-toggle" aria-label="Toggle navigation" aria-expanded="false">${ICONS.menu}</button>
   <a class="brand" href="${root}index.html">
     <span class="brand-mark" aria-hidden="true"><svg viewBox="0 0 64 64" width="18" height="18"><rect x="6" y="14" width="52" height="9" rx="4.5" fill="#e2621b"/><rect x="6" y="27.5" width="52" height="9" rx="4.5" fill="#ffffff"/><rect x="6" y="41" width="52" height="9" rx="4.5" fill="#359a4c"/></svg></span>
-    <span class="brand-name">Startup Schemes <span class="thin">Playbook</span></span>
+    <span class="brand-name">${esc(brandMain)}${brandThin ? ` <span class="thin">${esc(brandThin)}</span>` : ""}</span>
   </a>
   <span class="topbar-spacer"></span>
   <button class="searchbtn" data-search-open type="button" aria-label="Search schemes">
@@ -321,6 +334,7 @@ ${toc ? `<div class="content-with-toc"><div class="content-main">${body}</div>${
     <a href="${root}about.html">About &amp; disclaimer</a>
     <a href="${root}assets/${PDF_NAME}" download>Source PDF</a>
     <a href="https://www.startupindia.gov.in/" target="_blank" rel="noopener">startupindia.gov.in ↗</a>
+    <a href="${attr(REPO_URL)}" target="_blank" rel="noopener">GitHub ↗</a>
   </div>
 </div></footer>
 <div class="search-modal" id="search-modal" role="dialog" aria-modal="true" aria-label="Search">
@@ -883,9 +897,9 @@ ${rel.length ? `
 
 /* ================= 404 ================= */
 write("404.html", shell({
-  root: "/startup-india-guide/", active: "", title: "Page not found",
+  root: PATH_PREFIX, active: "", title: "Page not found",
   description: "Page not found.",
-  body: `<div class="empty-state" style="margin-top:60px"><div class="big">🧭</div><h1 style="font-size:1.5rem">That page doesn't exist</h1><p class="muted" style="margin-top:8px">The scheme may have been renamed. Try the search (<kbd>⌘K</kbd>) or start from the directory.</p><p style="margin-top:18px"><a class="btn btn-primary" href="/startup-india-guide/directory.html">Browse all schemes</a></p></div>`,
+  body: `<div class="empty-state" style="margin-top:60px"><div class="big">🧭</div><h1 style="font-size:1.5rem">That page doesn't exist</h1><p class="muted" style="margin-top:8px">The scheme may have been renamed. Try the search (<kbd>⌘K</kbd>) or start from the directory.</p><p style="margin-top:18px"><a class="btn btn-primary" href="${PATH_PREFIX}directory.html">Browse all schemes</a></p></div>`,
 }));
 
 /* ================= SEARCH INDEX ================= */

.github/screenshots/home-dark.png

@@ -171,6 +171,7 @@
     <a href="/startup-india-guide/about.html">About &amp; disclaimer</a>
     <a href="/startup-india-guide/assets/Startup-Schemes-Playbook-June-2026.pdf" download>Source PDF</a>
     <a href="https://www.startupindia.gov.in/" target="_blank" rel="noopener">startupindia.gov.in ↗</a>
+    <a href="https://github.com/fritzhand/startup-india-guide" target="_blank" rel="noopener">GitHub ↗</a>
   </div>
 </div></footer>
 <div class="search-modal" id="search-modal" role="dialog" aria-modal="true" aria-label="Search">