Docs site

Source type

Hand-authored app guide. The app-level deep dive is apps/docs/FEATURE.md.

apps/docs is the primary internal documentation product. It is an Astro/Starlight static site with hand-authored pages and generated references.

Item	Value
Local run	bun --filter @repo/docs dev
Build	bun --filter @repo/docs build
Check	bun run docs:check
Generated refs	API, Knock workflows, design tokens, workspace inventory
Deploy	Dokploy GitHub App (auto on development push)

Maintenance rules

• Hand-authored pages should state source type with a callout.
• Generated pages stay gitignored and are rebuilt by bun run generate.
• Add sidebar entries when adding hand-authored pages.
• Keep root README.md short and point readers here for detail.