Deploy and Operations

Deploy Pipeline

bun run deploy    # Runs: astro build && wrangler deploy

This builds the Astro site and deploys the output to Cloudflare Workers.

Pre-Deploy Verification

Always run before deploying:

bun run check     # TypeScript type checking
bun run test      # 42 tests across 7 files
bun run build     # Production build

Wrangler Configuration

wrangler.jsonc defines the Worker name, bindings, compatibility settings, and asset serving. See wrangler config reference.

Managing Secrets

Local (.dev.vars):

CONTACT_EMAIL=you@domain.com
POLICY_AUD=aud-tag
TEAM_DOMAIN=yourteam

Production:

bunx wrangler secret put CONTACT_EMAIL
bunx wrangler secret put POLICY_AUD
bunx wrangler secret put TEAM_DOMAIN

Custom Domains

1. Deploy the Worker first
2. Go to Workers & Pages > your worker > Settings > Domains & Routes
3. Add a custom domain (Cloudflare handles DNS + SSL)
4. Update site in astro.config.mjs to match

Troubleshooting

See troubleshooting reference for common errors and fixes.