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 clinical-gore splash whose copy is drawn from the constitution's pitch, pillars, and visual law — public claims are part of that contract. DESIGN.md syncs to /constitution/; the wiki tree fills the rest of the sidebar.

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.