Operations
Deployments
How Nimbus deploys the app, landing page, and documentation.
Deployments
Nimbus production deploys are driven from main by GitHub Actions. Do not run production Worker deploys or remote D1 migrations from a local machine.
Worker app
The main application deploys through the Deploy Worker workflow. It builds the web app, applies D1 migrations, syncs secrets, and deploys the Cloudflare Worker.
Marketing site
The marketing landing page lives in landing/ and deploys to Cloudflare Pages when landing files change on main.
Documentation site
The docs source lives in docs/ as Markdown. At deploy time, npm run build:docs compiles those files into dist/docs with generated navigation, table of contents, and search index. The docs workflow deploys that static output to Cloudflare Pages.
Local validation
For documentation-only work, run:
npm run build:docs
Then serve dist/docs with any static server and verify search, navigation, and page rendering.