N Nimbus Docs

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.