Deployment

The marketing/docs site and the local dashboard app are different deploy surfaces. The Astro site deploys to Cloudflare for neondeck.dev. The local app runs on the user's machine.

Astro site

The site lives in docs/ and builds to static assets.

npm run docs:build
npm run docs:preview

Cloudflare deploy

npm run docs:deploy

Wrangler config lives at docs/wrangler.jsonc. It deploys the built docs/dist assets to the neondeck-site Worker with custom domains for neondeck.dev and www.neondeck.dev. Deployment is currently manual: merging main does not publish the site until npm run docs:deploy is run from the merged revision.

Validation

cd docs
npx wrangler deploy --dry-run

Use a dry run before important deploys to validate the Worker config and asset bundle without publishing.

Local app packaging

The local app builds the React dashboard and Flue Node server. It uses runtime-home config and secrets on the user's machine, not Cloudflare Worker secrets.

npm run build:dashboard
npm run package:app
npm run release:app

Domain

The public docs domain is neondeck.dev. The local dashboard normally runs at http://127.0.0.1:5173/ during development.