Docs site

Local development

Install dependencies and start Astro:

cd docs
bun install
bun run dev

Astro serves the site locally, usually at:

http://localhost:4321

Files to edit

The docs site is isolated under docs/:

docs/src/data/docs.ts                site name, repo URL, navigation, categories
docs/src/pages/index.astro           overview page
docs/src/pages/docs/index.astro      grouped docs index
docs/src/pages/docs/[...slug].astro  article route
docs/src/pages/docs.md.ts            raw markdown docs index
docs/src/pages/docs/[...slug].md.ts  raw markdown page route
docs/src/content/docs/**/*.md        documentation pages
docs/src/styles/global.css           visual system

Use docs/src/content/docs for most documentation changes. Use docs/src/pages/index.astro for the overview narrative and product positioning.

Validate the docs site

Run:

cd docs
bun run check
bun run build

check catches Astro and TypeScript issues. build verifies static output and route generation.

Keep generated files out of commits

The repository ignores:

node_modules/
.astro/
dist/

Commit source files, lockfiles, and content. Do not commit local build output.

Deployment

The site builds to static output in dist and can be deployed by any static host:

cd docs
bun run build

Use the host’s static output setting:

dist

When the docs site is deployed behind a custom domain, keep the repository link pointed at https://github.com/amxv/zodex.