Docs

apps/docs is this documentation site. It runs on TanStack Start, Vite, React 19, and Fumadocs, serving on port 4000 in development.

What it owns

• Reader-facing docs under content/docs/**.
• English and Italian content, with Italian pages as .it siblings.
• The docs sidebar through meta.json files.
• Search, raw Markdown routes, llms.txt, llms-full.txt, and the Ask AI docs chat.
• Deployment as the docs Railway service.

The docs are not meant to be literal copies of AGENTS.md. AGENTS files are the agent-facing source of truth; this site explains the repo to readers and downstream users.

Local workflow

Copybun run --filter docs dev
bun run --filter docs typecheck
bun run --filter docs build

Fumadocs generates .source/ during dev/build/typecheck. Do not edit or commit generated .source files.

Deployment

The docs service builds from apps/docs/docker/Dockerfile, uses the narrow @halostack/env/docs environment subset, exposes /health, and sleeps when idle on Railway. It does not need the app database or Redis at runtime.