site/ — Starlight wiki builder #

Type: knowledge

Astro + Starlight project that renders wiki/ (and root DESIGN.md) as the public Misaligned documentation site for Tangled Sites.

The site root (src/pages/index.astro) is a game-first one-page splash: hero mood, pitch, what you do, why the systems are cool, and a primary CTA to the constitution. Its copy is sourced from DESIGN.md's pitch, public-page scope, and no-unsourced-surface law — public claims are part of that contract. DESIGN.md syncs to /constitution/; the wiki tree fills the rest of the sidebar.

Provenance #

Every site asset/page must have a source clause, per DESIGN.md's "No unsourced surface" law.

• src/pages/index.astro — public splash, justified by DESIGN.md "The pitch", "Visual identity: clinical gore", "Public-page scope", and wiki/interface/site.md.
• public/misaligned-cartoon.png — hero atmosphere for the splash, justified by DESIGN.md "Visual identity: clinical gore" and "Public-page scope", plus wiki/interface/site.md's reference composition. If the hero stops using it, delete it.
• public/favicon.svg — browser/site identity affordance for the public documentation site, justified by wiki/interface/site.md and the Starlight public-site workflow in wiki/process/workflows.md.
• Generated src/content/docs/, src/generated/, and dist/ — outputs of scripts/sync-wiki.mjs / Astro, justified by wiki/process/wiki.md and wiki/process/workflows.md; never hand-edit them.

Commands #

From the repo root:

pnpm --dir site sync     # wiki → src/content/docs + sidebar
pnpm --dir site dev      # local preview (SITE_BASE=/)
./tools/site-build.sh    # production build (base=/misaligned)
./tools/site-deploy.sh   # build + force-push orphan `pages` branch

Generated paths (src/content/docs/, src/generated/, dist/) are gitignored. Do not hand-edit them.

See wiki/process/workflows.md for Tangled Sites configuration and the deferred CI deploy note.