Cloudflare Deploy

Option A: Git Integration (Recommended)

Connect a GitHub repo to Pages — auto-deploys on every push:

# Create via dashboard or API. Once connected:
# - Push to main → production deploy
# - Push to branches → preview deploys
# - URL: https://<project>.pages.dev

Option B: Direct Upload via CLI

# Deploy a directory of static files
wrangler pages deploy ./dist --project-name=my-site

# First deploy creates the project automatically
# Subsequent deploys update it

wrangler.toml for Pages (optional)

name = "my-site"
pages_build_output_dir = "./dist"

# If using Pages Functions (server-side)
# Place functions in ./functions/ directory

Build Commands (common frameworks)

Cloudflare Workers (Serverless APIs)

Create a Worker

# Scaffold a new Worker project
npm create cloudflare@latest my-api

# Or manually create wrangler.toml + src/index.ts

wrangler.toml for Workers

name = "my-api"
main = "src/index.ts"  # or index.js
compatibility_date = "2024-01-01"

# Optional bindings
# [vars]
# API_KEY = "..."

# KV namespace
# [[kv_namespaces]]
# binding = "MY_KV"
# id = "abc123"

# R2 bucket
# [[r2_buckets]]
# binding = "MY_BUCKET"
# bucket_name = "my-bucket"

# D1 database
# [[d1_databases]]
# binding = "DB"
# database_name = "my-db"
# database_id = "xxx"

Minimal Worker (TypeScript)

export default {
  async fetch(request: Request, env: Env): Promise<Response> {
    const url = new URL(request.url);
    
    if (url.pathname === "/api/hello") {
      return Response.json({ message: "Hello from Workers!" });
    }
    
    return new Response("Not Found", { status: 404 });
  },
};

Deploy

# Deploy to production
wrangler deploy

# Deploy to staging (route based)
wrangler deploy --env staging

# Dev mode (local)
wrangler dev

Free Tier Limits (Important!)

Pages

• 100 projects per account
• 500 builds/month
• 20,000 files per project
• 25 MB per file
• Unlimited bandwidth (no transfer fees)
• Custom domains: 100 per project
• Default URL: https://<project>.pages.dev

Workers

• 100,000 requests/day
• 10ms CPU time per request (wall time is unlimited — waiting on fetch/KV doesn't count)
• 100 Workers per account
• 3 MB script size
• 5 Cron Triggers per account
• 128 MB memory

R2 (Object Storage)

• 10 GB storage
• 1M writes/month, 10M reads/month
• Zero egress fees (this is the killer feature)

KV

• 1 GB storage
• 100K reads/day, 1K writes/day

D1 (SQLite)

• 5 GB storage
• 5M reads/day, 100K writes/day

Common Patterns

Static Site + API

my-project/
├── site/           → Cloudflare Pages (static)
│   ├── index.html
│   └── assets/
├── api/            → Cloudflare Workers (dynamic)
│   ├── src/index.ts
│   └── wrangler.toml
└── .github/
    └── workflows/
        └── deploy.yml  → GitHub Actions builds both

GitHub Actions → Cloudflare Deploy

# .github/workflows/deploy.yml