The lemonfiber frontpage — a build-in-the-open site whose roadmap,
progress and repo state are read from the org, not written by hand.
Astro, static, self-hosted assets. Zero maintenance for maintainers.
Most project sites rot: the roadmap on the homepage drifts from the real one, the "in progress" list is months stale, and keeping them honest is a chore nobody signs up for. This site removes the chore. The GitHub org is the motor.
At build time it reads:
- the org — repositories, languages, releases, open issues, good-first-issues, stars
spec/00-overview/roadmap.md— the sequenced milestoneslemonfiber/IMPLEMENTATION-STATUS.md— per-deliverable status (✅ / ◐ / ☐)
…and renders them. When a maintainer pushes to any of those repos, CI rebuilds and the site moves. Nobody edits a page to ship a milestone.
If the network is unreachable at build time, a committed snapshot
(src/data/seed.ts) keeps the build green — live data always overrides it.
| Route | What it shows |
|---|---|
/ |
The pitch, a live status strip, the "runs in slices" switcher, the 19 services |
/roadmap |
Every milestone with progress, derived from the status file |
/transparency |
Every repo, release and open issue — read live from GitHub |
/contribute |
Ways to help + live good-first-issues |
$ npm ci # or: just install
$ npm run dev # local dev at http://localhost:4321
$ npm run build # production build (fetches live org data)
$ just ci # type-check + typos + build — what CI runsNode ≥ 20. GITHUB_TOKEN is optional locally (raises the API rate limit).
src/lib/github.ts the motor — fetch + parse, with a resilient fallback
src/data/site.ts editorial copy; the service / profile / form model
src/data/seed.ts offline snapshot
src/components/ Nav · Footer · Console · FormsSwitcher · RepoCard · …
src/pages/ index · roadmap · transparency · contribute · 404
src/styles/tokens.css design tokens mirrored from lemonfiber/brand
This project's spec is canonical: every change cites a spec identifier that already exists. Before your first PR, read AGENTS.md and the contributing guide.
Hippocratic License 3.0 — ethical-source, source-available. See the rationale.
