Deploy Cloudflare

Deploy to Cloudflare

Two modes — detect which applies:

• Cloudflare Pages: for static sites, SPAs (React/Vite), and SSR frameworks (Next.js, SvelteKit, Astro)
• Cloudflare Workers: for edge functions, serverless API handlers, or projects with wrangler.toml

Detect Mode

Use Pages if ANY of:

• No wrangler.toml exists AND project has frontend framework (React, Vite, Astro, SvelteKit)
• wrangler.toml has [pages] section

Use Workers if:

• wrangler.toml exists with main field pointing to a JS/TS entry file
• Project has edge function patterns (no HTML entry, pure JS handler)

Prerequisites

• wrangler CLI installed: wrangler --version (install: npm install -g wrangler)
• Logged in: wrangler whoami (run setup-auth if not)

Cloudflare Pages Deployment

1. Build the project

cd <frontend-dir>
npm run build   # or detected build command

2. Detect output directory

Check in order: dist/, build/, .next/, out/, .svelte-kit/output/client/, public/. Use first directory that exists.

3. Deploy to Pages

PROJECT_NAME=$(basename $(pwd) | tr '[:upper:]' '[:lower:]' | tr '_' '-')

wrangler pages deploy <output-dir> \
  --project-name "$PROJECT_NAME" \
  --commit-dirty=true
# First deploy: creates the project automatically

4. Set environment variables via Cloudflare API

wrangler CLI has limited env var support for Pages — use the API:

ACCOUNT_ID=$(wrangler whoami --json 2>/dev/null | python3 -c "
import sys,json
try: print(json.load(sys.stdin)['accounts'][0]['id'])
except: pass
")

# Use CLOUDFLARE_API_TOKEN env var (set by setup-auth or wrangler login)
CF_TOKEN="${CLOUDFLARE_API_TOKEN:-$(wrangler whoami --json 2>/dev/null | python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get('api_token',''))" 2>/dev/null)}"
if [ -z "$CF_TOKEN" ]; then
  echo "⚠ CLOUDFLARE_API_TOKEN not set. Set it in your environment or run: wrangler login"
  echo "  Then export CLOUDFLARE_API_TOKEN=<your-token>"
  exit 1
fi

curl -s -X PATCH \
  "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/pages/projects/$PROJECT_NAME" \
  -H "Authorization: Bearer $CF_TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"deployment_configs\":{\"production\":{\"env_vars\":{\"VITE_API_URL\":{\"value\":\"$BACKEND_URL\",\"type\":\"plain_text\"}}}}}"

5. Get deployed URL

CF_URL="https://$PROJECT_NAME.pages.dev"
echo "✓ Deployed: $CF_URL"

Cloudflare Workers Deployment

1. Ensure wrangler.toml exists

If not present, create a minimal one:

name = "<worker-name>"
main = "src/index.ts"
compatibility_date = "2024-01-01"

2. Set secrets (interactive)

wrangler secret put DATABASE_URL
# Prompts for value — tell user what to paste

3. Deploy

wrangler deploy

4. Get worker URL

CF_URL=$(wrangler deploy 2>&1 | grep -oP 'https://[^\s]+\.workers\.dev' | head -1)
if [ -z "$CF_URL" ]; then
  echo "⚠ Could not extract worker URL from deploy output. Check https://dash.cloudflare.com"
fi
echo "✓ Worker deployed: $CF_URL"

Save and Export

cat >> DEPLOYMENT_DOCS/DEPLOYED_ENV.md << EOF

## Cloudflare
CF_URL=$CF_URL
CF_PROJECT_NAME=$PROJECT_NAME
EOF
chmod 600 DEPLOYMENT_DOCS/DEPLOYED_ENV.md 2>/dev/null || true

Export: CF_URL for CI/CD setup and env var wiring.

Free Tier Notes

• Cloudflare Pages: unlimited requests, 500 builds/month
• Cloudflare Workers: 10 million requests/month, 10ms CPU time per request
• Both are genuinely free with no credit card required for these limits

On Failure

• Pages deploy fails: verify the output directory exists and has an index.html
• Workers deploy fails: check wrangler.toml syntax, verify main file exists
• API env var set fails: verify ACCOUNT_ID and CF_TOKEN are correct