Cloudflare Pages

Automatic Deployments

Every push to main triggers a Cloudflare Pages deployment via GitHub Actions. The CI pipeline also runs linting, type checking, and security scans before building.

The release.yml workflow handles production deployments from version tags.

Preview Deployments

Pull requests get automatic preview deployments, so you can review changes before merging to main.

Manual Deployment

pnpm build

# Deploy via wrangler
npx wrangler pages deploy dist --branch=main

# Or via Cloudflare Dashboard
# Project: astro-cloudflare

Required Secrets

Set these in your Cloudflare Pages dashboard or GitHub repository:

Secret	Purpose
CF_API_TOKEN	Cloudflare API token for deployments
CF_ACCOUNT_ID	Your Cloudflare account ID
SITE_URL	Canonical URL of your site
CLEANUP_SECRET	Bearer token guarding the R2 cleanup endpoint (only if you use R2)

R2 Media (optional)

The R2_MEDIA binding in wrangler.jsonc connects to a Cloudflare R2 bucket for larger media assets. The secret-guarded functions/api/cleanup.ts worker can prune orphaned objects. Remove the binding and worker if you don’t need R2.

Branch Configuration

• main — Production builds
• Feature branches — Preview builds triggered from pull requests