Publish the docs
This page is for people who maintain the bglad docs site. It is not a step in Solo or Team. Product-repo users can ignore it.
The docs site is static Starlight (output public/). Cloudflare’s git
integration for this project runs npx wrangler deploy. That is enough:
wrangler.jsonc has a build.command that builds docs-site into public/
before upload.
Leave the dashboard Deploy command as npx wrangler deploy. Do not rely on
a second Cloudflare “build command”.
Cloudflare settings
Section titled “Cloudflare settings”| Setting | Value |
|---|---|
| Production branch | master |
| Root directory | (leave empty) |
| Deploy command | npx wrangler deploy |
Optional: package manager npm.
Environment variables
| Variable | Environment | Value |
|---|---|---|
NODE_VERSION | Production + Preview | 20 |
SITE_URL | Production | set after the first success (https://<name>.workers.dev or *.pages.dev); update again for a custom domain |
Retry the deployment after this wrangler.jsonc is on the production branch.
Optional custom domain
Section titled “Optional custom domain”Project → Custom domains. Then set Production SITE_URL to that origin and
retry.
npm run docs:devThis repo may also build the same public/ artifact in CI (GitLab Pages or
whatever host you use). That job is optional once Cloudflare is deploying.