cf-edge

```bash

# Verify CLI tools

wrangler --version # Workers, Pages, D1, KV, R2

cloudflared --version # Tunnels

# If missing:

npm install -g wrangler

# cloudflared:

brew install cloudflare/cloudflare/cloudflared

```

Static Site (Pages)

```bash

wrangler pages project create

wrangler pages deploy ./dist # or ./build, ./out, ./public

# Result: .pages.dev — unlimited bandwidth

```

Serverless API (Workers)

```bash

wrangler init && cd

wrangler dev # local: localhost:8787

wrangler deploy # live: ..workers.dev

```

SQL Database (D1)

```bash

wrangler d1 create

wrangler d1 execute --command "CREATE TABLE ..."

# Add to wrangler.toml: [[d1_databases]] binding/name/id

```

Key-Value Store (KV)

```bash

wrangler kv:namespace create

# Add to wrangler.toml: [[kv_namespaces]] binding/id

```

Object Storage (R2) — requires credit card, won't charge under limits

```bash

wrangler r2 bucket create

wrangler r2 object put /path --file ./file

```

Expose Localhost (Tunnel)

```bash

cloudflared tunnel --url http://localhost:3000 # instant public URL

```

| Service | Limit | Reset |

|---------|-------|-------|

| Workers | 100K req/day, 10ms CPU/req | Daily UTC |

| Pages | Unlimited bandwidth, 500 builds/mo | Monthly |

| D1 | 5 GB storage, 5M reads/day, 100K writes/day | Daily UTC |

| KV | 1 GB storage, 100K reads/day, 1K writes/day | Daily UTC |

| R2 | 10 GB storage, $0 egress | Monthly |

| Durable Objects | 100K req/day, 5 GB storage | Daily UTC |

| Workers AI | 10K neurons/day (~500 LLM queries) | Daily UTC |

| Tunnels | Unlimited | — |

See [references/limits.md](references/limits.md) for detailed breakdown.

```toml

name = "my-app"

main = "src/index.js" # or index.ts

compatibility_date = "2024-01-01"

# D1 Database

[[d1_databases]]

binding = "DB"

database_name = "my-db"

database_id = ""

# KV Namespace

[[kv_namespaces]]

binding = "KV"

id = ""

# R2 Bucket

[[r2_buckets]]

binding = "BUCKET"

bucket_name = "my-bucket"

# Environment Variables

[vars]

ENVIRONMENT = "production"

```

Basic API Router

```javascript

export default {

async fetch(request, env) {

const url = new URL(request.url);

if (url.pathname === '/api/data') {

const data = await env.DB.prepare('SELECT * FROM items').all();

return Response.json(data.results);

}

return new Response('Not Found', { status: 404 });

}

};

```

With D1 + KV

```javascript

export default {

async fetch(request, env) {

// KV: fast reads, eventual consistency

const cached = await env.KV.get('key', 'json');

if (cached) return Response.json(cached);

// D1: SQL queries

const { results } = await env.DB.prepare('SELECT * FROM users WHERE id = ?').bind(1).all();

// Cache result

await env.KV.put('key', JSON.stringify(results), { expirationTtl: 3600 });

return Response.json(results);

}

};

```

Workers AI

```javascript

export default {

async fetch(request, env) {

const response = await env.AI.run('@cf/meta/llama-3.2-1b-instruct', {

prompt: 'Hello, how are you?'

});

return Response.json(response);

}

};

// Add to wrangler.toml: [ai] binding = "AI"

```

```bash

cloudflared tunnel login

cloudflared tunnel create

cloudflared tunnel route dns subdomain.yourdomain.com

# Create ~/.cloudflared/config.yml:

cat << EOF > ~/.cloudflared/config.yml

tunnel:

credentials-file: ~/.cloudflared/.json

ingress:

- hostname: subdomain.yourdomain.com

service: http://localhost:3000

- service: http_status:404

EOF

cloudflared tunnel run

```

1. Before deploying: Estimate daily requests — stay under 100K/day for Workers
2. Use caching: KV for read-heavy data reduces D1 reads
3. Optimize queries: Add indexes to D1, avoid full table scans
4. Static over dynamic: Serve static assets from Pages (unlimited) not Workers
5. Monitor usage: wrangler d1 info or check dashboard

• Don't use CDN primarily for video streaming or large media distribution
• Don't proxy traffic for other sites (reverse proxy abuse)
• Don't run crypto mining or similar compute-heavy workloads
• Don't exceed 10ms CPU per Worker request consistently

```bash

my-project/

├── wrangler.toml

├── package.json

├── src/

│ └── index.js # Worker entry

├── public/ # Static assets (if using Pages)

└── migrations/ # D1 schema migrations

└── 0001_init.sql

```

```bash

# Development

wrangler dev # Local dev server

wrangler dev --remote # Dev against real services

# Deployment

wrangler deploy # Deploy Worker

wrangler pages deploy ./dist # Deploy Pages

# Database

wrangler d1 execute --file ./migrations/001.sql

wrangler d1 execute --command "SELECT * FROM users"

# Debugging

wrangler tail # Live logs

wrangler tail --format pretty # Formatted logs

# Info

wrangler whoami # Check auth

wrangler d1 info # DB stats

```

• [references/limits.md](references/limits.md) — Detailed free tier limits and calculations
• [references/services.md](references/services.md) — Full service configurations and patterns