This project uses bun (>= 1.2) as its package manager and task runner. Older bun versions can't read the text-based bun.lock lockfile and will do a slow, unpinned full resolve — upgrade with bun upgrade.
to install dependencies:
bun installto start the development server:
bun devto build the Cloudflare Pages artifact (output in dist/public/):
bun run buildProduction is served by Cloudflare Pages at https://docs.eden.zone.
The GitHub Actions workflow in .github/workflows/deploy-cloudflare.yml is the
normal deploy path. Pushes to main build and deploy the Pages project using
the CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID repository secrets.
bun run build must produce the full Pages artifact:
- the static Vocs site in
dist/public/ - root-level Markdown files copied from
dist/public/assets/md/ dist/public/_worker.js, copied fromworker/index.js
The Pages worker serves the public MCP endpoint at:
https://docs.eden.zone/api/mcp
Do not configure or document a separate Worker for MCP. The MCP endpoint is
bundled into the Pages deployment as _worker.js.
OAuth/OIDC authorization server metadata, OAuth protected resource metadata, and auth.md registration metadata are unnecessary for this public documentation service. Add them only if actual protected resources, issuers, or registration flows exist; missing scanner checks are not grounds to invent those services.