Docs hosting

Docs hosting

Boon docs are built as a static Astro Starlight site and deployed to Cloudflare Workers Static Assets.

Chosen path

docs.boonprotocol.com  →  boon-docs Worker Static Assets

The docs app lives in this repository’s docs/ workspace. Starlight content lives under docs/src/content/docs/; internal planning/review artifacts such as docs/plans/, docs/reviews/, docs/verification/, and docs/screenshots/ stay in the repository but are not part of the Starlight content collection.

Local development

pnpm --filter boon-docs dev

Build

pnpm --filter boon-docs build

The static output is docs/dist/.

Deploy

pnpm --filter boon-docs deploy

docs/wrangler.jsonc binds docs.boonprotocol.com as a custom domain route and uploads ./dist as static assets.

Agent skill endpoints

Because Starlight does not auto-generate agent-skill endpoints, Boon serves generated static skill files from docs/public/:

/skill.md
/.well-known/skills/boon.md
/.well-known/agent-skills/boon.md

skill/boon/SKILL.md is the source of truth. pnpm run docs:sync-skill refreshes the hosted raw files and the Starlight “Agent skill file” page. pnpm run docs:check-skill fails CI if any generated copy drifts from the repository skill.