Appearance
Cloudflare Pages (Docs Site)
This repo hosts the docs source in docs/ and a VitePress wrapper in docs-site/. To avoid conflicts with the web app, deploy the docs as a separate Cloudflare Pages project.
Recommended Setup
- Project type: Cloudflare Pages
- Repository: this repo
- Root Directory: repo root
- Build command:
npm --prefix docs-site install && npm --prefix docs-site run build - Build output directory:
docs/.vitepress/dist
Notes
- Keep
docs/as the canonical docs root. - The
docs-site/wrapper isolates VitePress dependencies and scripts. - No changes to the web app config are required.
Optional: Local Preview
bash
npm --prefix docs-site install
npm --prefix docs-site run dev