[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7CAB9AJZMZRFQJ4FBBZPSWB":3,"skill-same:01M7CAB9AJZMZRFQJ4FBBZPSWB":47},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":14,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M7CAB9AJZMZRFQJ4FBBZPSWB","cloudflare",null,"Guide for building applications on Cloudflare's edge platform. Use when implementing serverless functions (Workers), edge databases (D1), storage (R2, KV), real-time apps (Durable Objects), AI features (Workers AI, AI Gateway), static sites (Pages), or any edge computing solutions.","shenyimings\u002Fskillet","shenyimings","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F89332218?v=4","01M7C9KHMXPPXMQJCKN78FKB06","Yiming Shen","01M7C9KHP4KS809T2A9T64YDWE",0,"MIT","https:\u002F\u002Fgithub.com\u002Fshenyimings\u002Fskillet\u002Fblob\u002Fmain\u002Fbenchmark\u002Fwild\u002Fdev\u002Fsafe\u002Fakornmeier__claude-config__skills__cloudflare\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: cloudflare\ndescription: Guide for building applications on Cloudflare's edge platform. Use when implementing serverless functions (Workers), edge databases (D1), storage (R2, KV), real-time apps (Durable Objects), AI features (Workers AI, AI Gateway), static sites (Pages), or any edge computing solutions.\nlicense: MIT\nversion: 1.0.0\n---\n\n# Cloudflare Developer Platform Skill\n\nCloudflare Developer Platform is a comprehensive edge computing ecosystem for building full-stack applications on Cloudflare's global network. It includes serverless functions, databases, storage, AI\u002FML capabilities, and static site hosting.\n\n## When to Use This Skill\n\nUse this skill when:\n\n- Building serverless applications on the edge\n- Implementing edge databases (D1 SQLite)\n- Working with object storage (R2) or key-value stores (KV)\n- Creating real-time applications with WebSockets (Durable Objects)\n- Integrating AI\u002FML capabilities (Workers AI, AI Gateway, Agents)\n- Deploying static sites with serverless functions (Pages)\n- Building full-stack applications with frameworks (Next.js, Remix, Astro, etc.)\n- Implementing message queues and background jobs (Queues)\n- Optimizing for global performance and low latency\n\n## Core Concepts\n\n### Edge Computing Platform\n\n**Cloudflare's Edge Network**: Code runs on servers globally distributed across 300+ cities, executing requests from the nearest location for ultra-low latency.\n\n**Key Components**:\n\n- **Workers**: Serverless functions on the edge\n- **D1**: SQLite database with global read replication\n- **KV**: Distributed key-value store with eventual consistency\n- **R2**: Object storage with zero egress fees\n- **Durable Objects**: Stateful compute with WebSocket support\n- **Queues**: Message queue system for async processing\n- **Pages**: Static site hosting with serverless functions\n- **Workers AI**: Run AI models on the edge\n- **AI Gateway**: Unified interface for AI providers\n\n### Execution Model\n\n**V8 Isolates**: Lightweight execution environments (faster than containers) with:\n\n- Millisecond cold starts\n- Zero infrastructure management\n- Automatic scaling\n- Pay-per-request pricing\n\n**Handler Types**:\n\n- `fetch`: HTTP requests\n- `scheduled`: Cron jobs\n- `queue`: Message processing\n- `tail`: Log aggregation\n- `email`: Email handling\n- `alarm`: Durable Object timers\n\n## Getting Started with Workers\n\n### Installation\n\n```bash\n# Install Wrangler CLI\nnpm install -g wrangler\n\n# Login to Cloudflare\nwrangler login\n\n# Create new project\nwrangler init my-worker\ncd my-worker\n\n# Start local development\nwrangler dev\n\n# Deploy to production\nwrangler deploy\n```\n\n### Basic Worker\n\n```typescript\n\u002F\u002F src\u002Findex.ts\nexport default {\n  async fetch(request: Request, env: Env): Promise\u003CResponse> {\n    return new Response('Hello from Cloudflare Workers!');\n  },\n};\n```\n\n### Configuration (wrangler.toml)\n\n```toml\nname = \"my-worker\"\nmain = \"src\u002Findex.ts\"\ncompatibility_date = \"2024-01-01\"\n\n# Environment variables\n[vars]\nENVIRONMENT = \"production\"\n\n# Bindings (added per product below)\n```\n\n### Language Support\n\n- **JavaScript\u002FTypeScript**: Primary language (full Node.js compatibility)\n- **Python**: Beta support via Workers Python\n- **Rust**: Compile to WebAssembly\n\n## Storage Products\n\n### D1 (SQLite Database)\n\n**Use Cases**: Relational data, complex queries, ACID transactions\n\n**Setup**:\n\n```bash\n# Create database\nwrangler d1 create my-database\n\n# Add to wrangler.toml\n[[d1_databases]]\nbinding = \"DB\"\ndatabase_name = \"my-database\"\ndatabase_id = \"YOUR_DATABASE_ID\"\n\n# Generate and apply schema\nwrangler d1 execute my-database --file=.\u002Fschema.sql\n```\n\n**Usage**:\n\n```typescript\nexport default {\n  async fetch(request: Request, env: Env) {\n    \u002F\u002F Query\n    const result = await env.DB.prepare('SELECT * FROM users WHERE id = ?').bind(userId).first();\n\n    \u002F\u002F Insert\n    await env.DB.prepare('INSERT INTO users (name, email) VALUES (?, ?)')\n      .bind('Alice', 'alice@example.com')\n      .run();\n\n    \u002F\u002F Batch (atomic)\n    await env.DB.batch([\n      env.DB.prepare('UPDATE accounts SET balance = balance - 100 WHERE id = ?').bind(user1),\n      env.DB.prepare('UPDATE accounts SET balance = balance + 100 WHERE id = ?').bind(user2),\n    ]);\n\n    return new Response(JSON.stringify(result));\n  },\n};\n```\n\n**Key Features**:\n\n- Global read replication (low-latency reads)\n- Single-writer consistency\n- Standard SQLite syntax\n- 25GB database size limit\n\n### KV (Key-Value Store)\n\n**Use Cases**: Cache, sessions, feature flags, rate limiting\n\n**Setup**:\n\n```bash\n# Create namespace\nwrangler kv:namespace create MY_KV\n\n# Add to wrangler.toml\n[[kv_namespaces]]\nbinding = \"KV\"\nid = \"YOUR_NAMESPACE_ID\"\n```\n\n**Usage**:\n\n```typescript\nexport default {\n  async fetch(request: Request, env: Env) {\n    \u002F\u002F Put with TTL\n    await env.KV.put('session:token', JSON.stringify(data), {\n      expirationTtl: 3600, \u002F\u002F 1 hour\n    });\n\n    \u002F\u002F Get\n    const data = await env.KV.get('session:token', 'json');\n\n    \u002F\u002F Delete\n    await env.KV.delete('session:token');\n\n    \u002F\u002F List with prefix\n    const list = await env.KV.list({ prefix: 'user:123:' });\n\n    return new Response(JSON.stringify(data));\n  },\n};\n```\n\n**Key Features**:\n\n- Sub-millisecond reads (edge-cached)\n- Eventual consistency (~60 seconds globally)\n- 25MB value size limit\n- Automatic expiration (TTL)\n\n### R2 (Object Storage)\n\n**Use Cases**: File storage, media hosting, backups, static assets\n\n**Setup**:\n\n```bash\n# Create bucket\nwrangler r2 bucket create my-bucket\n\n# Add to wrangler.toml\n[[r2_buckets]]\nbinding = \"R2_BUCKET\"\nbucket_name = \"my-bucket\"\n```\n\n**Usage**:\n\n```typescript\nexport default {\n  async fetch(request: Request, env: Env) {\n    \u002F\u002F Put object\n    await env.R2_BUCKET.put('path\u002Fto\u002Ffile.jpg', fileBuffer, {\n      httpMetadata: {\n        contentType: 'image\u002Fjpeg',\n      },\n    });\n\n    \u002F\u002F Get object\n    const object = await env.R2_BUCKET.get('path\u002Fto\u002Ffile.jpg');\n    if (!object) {\n      return new Response('Not found', { status: 404 });\n    }\n\n    \u002F\u002F Stream response\n    return new Response(object.body, {\n      headers: {\n        'Content-Type': object.httpMetadata?.contentType || 'application\u002Foctet-stream',\n      },\n    });\n\n    \u002F\u002F Delete\n    await env.R2_BUCKET.delete('path\u002Fto\u002Ffile.jpg');\n\n    \u002F\u002F List\n    const list = await env.R2_BUCKET.list({ prefix: 'uploads\u002F' });\n  },\n};\n```\n\n**Key Features**:\n\n- S3-compatible API\n- **Zero egress fees** (huge cost advantage)\n- Unlimited storage\n- 5TB object size limit\n- Multipart upload support\n\n### Durable Objects\n\n**Use Cases**: Real-time apps, WebSockets, coordination, stateful logic\n\n**Setup**:\n\n```toml\n# wrangler.toml\n[[durable_objects.bindings]]\nname = \"COUNTER\"\nclass_name = \"Counter\"\nscript_name = \"my-worker\"\n```\n\n**Usage**:\n\n```typescript\n\u002F\u002F Define Durable Object class\nexport class Counter {\n  state: DurableObjectState;\n\n  constructor(state: DurableObjectState, env: Env) {\n    this.state = state;\n  }\n\n  async fetch(request: Request) {\n    \u002F\u002F Get current count\n    let count = (await this.state.storage.get\u003Cnumber>('count')) || 0;\n\n    \u002F\u002F Increment\n    count++;\n    await this.state.storage.put('count', count);\n\n    return new Response(JSON.stringify({ count }));\n  }\n}\n\n\u002F\u002F Use in Worker\nexport default {\n  async fetch(request: Request, env: Env) {\n    \u002F\u002F Get Durable Object instance\n    const id = env.COUNTER.idFromName('global-counter');\n    const counter = env.COUNTER.get(id);\n\n    \u002F\u002F Forward request\n    return counter.fetch(request);\n  },\n};\n```\n\n**WebSocket Example**:\n\n```typescript\nexport class ChatRoom {\n  state: DurableObjectState;\n  sessions: Set\u003CWebSocket>;\n\n  constructor(state: DurableObjectState) {\n    this.state = state;\n    this.sessions = new Set();\n  }\n\n  async fetch(request: Request) {\n    const pair = new WebSocketPair();\n    const [client, server] = Object.values(pair);\n\n    this.state.acceptWebSocket(server);\n    this.sessions.add(server);\n\n    return new Response(null, { status: 101, webSocket: client });\n  }\n\n  async webSocketMessage(ws: WebSocket, message: string) {\n    \u002F\u002F Broadcast to all connected clients\n    for (const session of this.sessions) {\n      session.send(message);\n    }\n  }\n\n  async webSocketClose(ws: WebSocket) {\n    this.sessions.delete(ws);\n  }\n}\n```\n\n**Key Features**:\n\n- Single-instance coordination (strong consistency)\n- Persistent storage (1GB limit on paid plans)\n- WebSocket support\n- Automatic hibernation for inactive objects\n\n### Queues\n\n**Use Cases**: Background jobs, email sending, async processing\n\n**Setup**:\n\n```toml\n# wrangler.toml\n[[queues.producers]]\nbinding = \"MY_QUEUE\"\nqueue = \"my-queue\"\n\n[[queues.consumers]]\nqueue = \"my-queue\"\nmax_batch_size = 10\nmax_batch_timeout = 30\n```\n\n**Usage**:\n\n```typescript\n\u002F\u002F Producer: Send messages\nexport default {\n  async fetch(request: Request, env: Env) {\n    await env.MY_QUEUE.send({\n      type: 'email',\n      to: 'user@example.com',\n      subject: 'Welcome!',\n    });\n\n    return new Response('Message queued');\n  },\n};\n\n\u002F\u002F Consumer: Process messages\nexport default {\n  async queue(batch: MessageBatch\u003Cany>, env: Env) {\n    for (const message of batch.messages) {\n      try {\n        await processMessage(message.body);\n        message.ack(); \u002F\u002F Acknowledge success\n      } catch (error) {\n        message.retry(); \u002F\u002F Retry on failure\n      }\n    }\n  },\n};\n```\n\n**Key Features**:\n\n- At-least-once delivery\n- Automatic retries (exponential backoff)\n- Dead-letter queue support\n- Batch processing\n\n## AI Products\n\n### Workers AI\n\n**Use Cases**: Run AI models directly on the edge\n\n**Setup**:\n\n```toml\n# wrangler.toml\n[ai]\nbinding = \"AI\"\n```\n\n**Usage**:\n\n```typescript\nexport default {\n  async fetch(request: Request, env: Env) {\n    \u002F\u002F Text generation\n    const response = await env.AI.run('@cf\u002Fmeta\u002Fllama-3-8b-instruct', {\n      messages: [{ role: 'user', content: 'What is edge computing?' }],\n    });\n\n    \u002F\u002F Image classification\n    const imageResponse = await env.AI.run('@cf\u002Fmicrosoft\u002Fresnet-50', {\n      image: imageBuffer,\n    });\n\n    \u002F\u002F Text embeddings\n    const embeddings = await env.AI.run('@cf\u002Fbaai\u002Fbge-base-en-v1.5', {\n      text: 'Hello world',\n    });\n\n    return new Response(JSON.stringify(response));\n  },\n};\n```\n\n**Available Models**:\n\n- LLMs: Llama 3, Mistral, Gemma, Qwen\n- Image: Stable Diffusion, DALL-E, ResNet\n- Embeddings: BGE, GTE\n- Translation, summarization, sentiment analysis\n\n### AI Gateway\n\n**Use Cases**: Unified interface for AI providers with caching, rate limiting, analytics\n\n**Setup**:\n\n```typescript\n\u002F\u002F OpenAI via AI Gateway\nconst response = await fetch(\n  'https:\u002F\u002Fgateway.ai.cloudflare.com\u002Fv1\u002F{account_id}\u002F{gateway_id}\u002Fopenai\u002Fchat\u002Fcompletions',\n  {\n    method: 'POST',\n    headers: {\n      Authorization: `Bearer ${env.OPENAI_API_KEY}`,\n      'Content-Type': 'application\u002Fjson',\n    },\n    body: JSON.stringify({\n      model: 'gpt-4',\n      messages: [{ role: 'user', content: 'Hello!' }],\n    }),\n  }\n);\n```\n\n**Features**:\n\n- Request caching (reduce costs)\n- Rate limiting\n- Analytics and logging\n- Supports OpenAI, Anthropic, HuggingFace, etc.\n\n### Agents\n\n**Use Cases**: Build AI agents with tools and workflows\n\n```typescript\nimport { Agent } from '@cloudflare\u002Fagents';\n\nexport default {\n  async fetch(request: Request, env: Env) {\n    const agent = new Agent({\n      model: '@cf\u002Fmeta\u002Fllama-3-8b-instruct',\n      tools: [\n        {\n          name: 'get_weather',\n          description: 'Get current weather',\n          parameters: {\n            type: 'object',\n            properties: {\n              location: { type: 'string' },\n            },\n          },\n          handler: async ({ location }) => {\n            \u002F\u002F Fetch weather data\n            return { temperature: 72, conditions: 'sunny' };\n          },\n        },\n      ],\n    });\n\n    const result = await agent.run('What is the weather in San Francisco?');\n    return new Response(JSON.stringify(result));\n  },\n};\n```\n\n### AI Search (RAG)\n\n**Use Cases**: Build retrieval-augmented generation applications\n\n```typescript\nimport { VectorizeIndex } from '@cloudflare\u002Fworkers-types';\n\nexport default {\n  async fetch(request: Request, env: Env) {\n    \u002F\u002F Generate embeddings\n    const embeddings = await env.AI.run('@cf\u002Fbaai\u002Fbge-base-en-v1.5', {\n      text: query,\n    });\n\n    \u002F\u002F Search vector database\n    const results = await env.VECTORIZE_INDEX.query(embeddings.data[0], {\n      topK: 5,\n    });\n\n    \u002F\u002F Generate response with context\n    const response = await env.AI.run('@cf\u002Fmeta\u002Fllama-3-8b-instruct', {\n      messages: [\n        {\n          role: 'system',\n          content: `Context: ${results.matches.map((m) => m.metadata.text).join('\\n')}`,\n        },\n        { role: 'user', content: query },\n      ],\n    });\n\n    return new Response(JSON.stringify(response));\n  },\n};\n```\n\n## Cloudflare Pages\n\n### Static Sites + Serverless Functions\n\n**Deployment**:\n\n```bash\n# Deploy via Git (recommended)\n# Connect GitHub repo in Cloudflare dashboard\n\n# Or deploy via CLI\nwrangler pages deploy .\u002Fdist\n```\n\n### Pages Functions\n\nDirectory-based routing in `functions\u002F`:\n\n```\nfunctions\u002F\n├── api\u002F\n│   ├── users\u002F\n│   │   └── [id].ts       # \u002Fapi\u002Fusers\u002F:id\n│   └── posts.ts          # \u002Fapi\u002Fposts\n└── _middleware.ts        # Global middleware\n```\n\n**Example Function**:\n\n```typescript\n\u002F\u002F functions\u002Fapi\u002Fusers\u002F[id].ts\nexport async function onRequestGet(context) {\n  const { params, env } = context;\n  const user = await env.DB.prepare('SELECT * FROM users WHERE id = ?').bind(params.id).first();\n\n  return new Response(JSON.stringify(user), {\n    headers: { 'Content-Type': 'application\u002Fjson' },\n  });\n}\n```\n\n**Middleware**:\n\n```typescript\n\u002F\u002F functions\u002F_middleware.ts\nexport async function onRequest(context) {\n  const start = Date.now();\n  const response = await context.next();\n  const duration = Date.now() - start;\n\n  console.log(`${context.request.method} ${context.request.url} - ${duration}ms`);\n  return response;\n}\n```\n\n### Framework Support\n\n**Next.js**:\n\n```bash\nnpx create-next-app@latest my-app\ncd my-app\nnpm install -D @cloudflare\u002Fnext-on-pages\nnpx @cloudflare\u002Fnext-on-pages\nwrangler pages deploy .vercel\u002Foutput\u002Fstatic\n```\n\n**Remix**:\n\n```bash\nnpx create-remix@latest --template cloudflare\u002Fremix\n```\n\n**Astro**:\n\n```bash\nnpm create astro@latest\n# Select \"Cloudflare\" adapter during setup\n```\n\n**SvelteKit**:\n\n```bash\nnpm create svelte@latest\nnpm install -D @sveltejs\u002Fadapter-cloudflare\n```\n\n## Wrangler CLI Essentials\n\n### Core Commands\n\n```bash\n# Development\nwrangler dev                    # Local development server\nwrangler dev --remote          # Dev on real Cloudflare infrastructure\n\n# Deployment\nwrangler deploy                # Deploy to production\nwrangler deploy --dry-run     # Preview changes without deploying\n\n# Logs\nwrangler tail                  # Real-time logs\nwrangler tail --format pretty # Formatted logs\n\n# Versions\nwrangler deployments list      # List deployments\nwrangler rollback [version]   # Rollback to previous version\n\n# Secrets\nwrangler secret put SECRET_NAME    # Add secret\nwrangler secret list               # List secrets\nwrangler secret delete SECRET_NAME # Delete secret\n```\n\n### Project Management\n\n```bash\n# Create projects\nwrangler init my-worker        # Create Worker\nwrangler pages project create  # Create Pages project\n\n# Database\nwrangler d1 create my-db           # Create D1 database\nwrangler d1 execute my-db --file=schema.sql\nwrangler d1 execute my-db --command=\"SELECT * FROM users\"\n\n# KV\nwrangler kv:namespace create MY_KV\nwrangler kv:key put --binding=MY_KV \"key\" \"value\"\nwrangler kv:key get --binding=MY_KV \"key\"\n\n# R2\nwrangler r2 bucket create my-bucket\nwrangler r2 object put my-bucket\u002Ffile.txt --file=.\u002Ffile.txt\n```\n\n## Integration Patterns\n\n### Full-Stack Application Architecture\n\n```\n┌─────────────────────────────────────────┐\n│         Cloudflare Pages (Frontend)      │\n│    Next.js \u002F Remix \u002F Astro \u002F SvelteKit  │\n└──────────────────┬──────────────────────┘\n                   │\n┌──────────────────▼──────────────────────┐\n│      Workers (API Layer \u002F BFF)          │\n│    - Routing                             │\n│    - Authentication                      │\n│    - Business logic                      │\n└─┬──────┬──────┬──────┬──────┬───────────┘\n  │      │      │      │      │\n  ▼      ▼      ▼      ▼      ▼\n┌────┐ ┌────┐ ┌────┐ ┌────┐ ┌────────────┐\n│ D1 │ │ KV │ │ R2 │ │ DO │ │ Workers AI │\n└────┘ └────┘ └────┘ └────┘ └────────────┘\n```\n\n### Polyglot Storage Pattern\n\n```typescript\nexport default {\n  async fetch(request: Request, env: Env) {\n    const url = new URL(request.url);\n\n    \u002F\u002F KV: Fast cache\n    const cached = await env.KV.get(url.pathname);\n    if (cached) return new Response(cached);\n\n    \u002F\u002F D1: Structured data\n    const user = await env.DB.prepare('SELECT * FROM users WHERE id = ?').bind(userId).first();\n\n    \u002F\u002F R2: Media files\n    const avatar = await env.R2_BUCKET.get(`avatars\u002F${user.id}.jpg`);\n\n    \u002F\u002F Durable Objects: Real-time coordination\n    const chat = env.CHAT_ROOM.get(env.CHAT_ROOM.idFromName(roomId));\n\n    \u002F\u002F Queue: Async processing\n    await env.EMAIL_QUEUE.send({ to: user.email, template: 'welcome' });\n\n    return new Response(JSON.stringify({ user, avatar }));\n  },\n};\n```\n\n### Authentication Pattern\n\n```typescript\nimport { verifyJWT, createJWT } from '.\u002Fjwt';\n\nexport default {\n  async fetch(request: Request, env: Env) {\n    const url = new URL(request.url);\n\n    \u002F\u002F Login\n    if (url.pathname === '\u002Fapi\u002Flogin') {\n      const { email, password } = await request.json();\n\n      const user = await env.DB.prepare('SELECT * FROM users WHERE email = ?').bind(email).first();\n\n      if (!user || !(await verifyPassword(password, user.password_hash))) {\n        return new Response('Invalid credentials', { status: 401 });\n      }\n\n      const token = await createJWT({ userId: user.id }, env.JWT_SECRET);\n\n      return new Response(JSON.stringify({ token }), {\n        headers: { 'Content-Type': 'application\u002Fjson' },\n      });\n    }\n\n    \u002F\u002F Protected route\n    const authHeader = request.headers.get('Authorization');\n    if (!authHeader) {\n      return new Response('Unauthorized', { status: 401 });\n    }\n\n    const token = authHeader.replace('Bearer ', '');\n    const payload = await verifyJWT(token, env.JWT_SECRET);\n\n    \u002F\u002F Store session in KV\n    await env.KV.put(`session:${payload.userId}`, JSON.stringify(payload), {\n      expirationTtl: 86400, \u002F\u002F 24 hours\n    });\n\n    return new Response('Authenticated');\n  },\n};\n```\n\n### Cache Strategy\n\n```typescript\nexport default {\n  async fetch(request: Request, env: Env) {\n    const cache = caches.default;\n    const cacheKey = new Request(request.url);\n\n    \u002F\u002F Check cache\n    let response = await cache.match(cacheKey);\n    if (response) return response;\n\n    \u002F\u002F Check KV (distributed cache)\n    const kvCached = await env.KV.get(request.url);\n    if (kvCached) {\n      response = new Response(kvCached);\n      await cache.put(cacheKey, response.clone());\n      return response;\n    }\n\n    \u002F\u002F Fetch from origin (D1, R2, etc.)\n    const data = await fetchFromOrigin(request, env);\n    response = new Response(data);\n\n    \u002F\u002F Store in both caches\n    await cache.put(cacheKey, response.clone());\n    await env.KV.put(request.url, data, { expirationTtl: 3600 });\n\n    return response;\n  },\n};\n```\n\n## Best Practices\n\n### Performance\n\n1. **Minimize Cold Starts**: Keep Workers lightweight (\u003C1MB bundled)\n2. **Use Bindings Over Fetch**: Direct bindings are faster than HTTP calls\n3. **Edge Caching**: Leverage KV and Cache API for frequently accessed data\n4. **Batch Operations**: Use D1 batch for multiple queries\n5. **Stream Large Responses**: Use `Response.body` streams for large files\n\n### Security\n\n1. **Secrets Management**: Use `wrangler secret` for API keys\n2. **Environment Isolation**: Separate production\u002Fstaging\u002Fdevelopment\n3. **Input Validation**: Sanitize user input\n4. **Rate Limiting**: Use KV or Durable Objects for rate limiting\n5. **CORS**: Configure proper CORS headers\n\n### Cost Optimization\n\n1. **R2 for Large Files**: Zero egress fees vs S3\n2. **KV for Caching**: Reduce D1\u002FR2 requests\n3. **Request Deduplication**: Cache identical requests\n4. **Efficient Queries**: Index D1 tables properly\n5. **Monitor Usage**: Use Cloudflare Analytics\n\n### Development Workflow\n\n1. **Local Development**: Use `wrangler dev` for testing\n2. **Type Safety**: Use TypeScript with `@cloudflare\u002Fworkers-types`\n3. **Testing**: Use Vitest with `unstable_dev()`\n4. **CI\u002FCD**: GitHub Actions with `cloudflare\u002Fwrangler-action`\n5. **Gradual Deployments**: Use percentage-based rollouts\n\n## Common Patterns\n\n### API Gateway\n\n```typescript\nimport { Hono } from 'hono';\n\nconst app = new Hono();\n\napp.get('\u002Fapi\u002Fusers\u002F:id', async (c) => {\n  const user = await c.env.DB.prepare('SELECT * FROM users WHERE id = ?')\n    .bind(c.req.param('id'))\n    .first();\n\n  return c.json(user);\n});\n\napp.post('\u002Fapi\u002Fusers', async (c) => {\n  const { name, email } = await c.req.json();\n\n  await c.env.DB.prepare('INSERT INTO users (name, email) VALUES (?, ?)').bind(name, email).run();\n\n  return c.json({ success: true }, 201);\n});\n\nexport default app;\n```\n\n### Image Transformation\n\n```typescript\nexport default {\n  async fetch(request: Request, env: Env) {\n    const url = new URL(request.url);\n    const imageKey = url.pathname.replace('\u002Fimages\u002F', '');\n\n    \u002F\u002F Get from R2\n    const object = await env.R2_BUCKET.get(imageKey);\n    if (!object) {\n      return new Response('Not found', { status: 404 });\n    }\n\n    \u002F\u002F Transform with Cloudflare Images\n    return new Response(object.body, {\n      headers: {\n        'Content-Type': object.httpMetadata?.contentType || 'image\u002Fjpeg',\n        'Cache-Control': 'public, max-age=86400',\n        'cf-image-resize': JSON.stringify({\n          width: 800,\n          height: 600,\n          fit: 'cover',\n        }),\n      },\n    });\n  },\n};\n```\n\n### Rate Limiting (KV)\n\n```typescript\nasync function rateLimit(ip: string, env: Env): Promise\u003Cboolean> {\n  const key = `ratelimit:${ip}`;\n  const limit = 100; \u002F\u002F requests per minute\n  const window = 60; \u002F\u002F seconds\n\n  const current = await env.KV.get(key);\n  const count = current ? parseInt(current) : 0;\n\n  if (count >= limit) {\n    return false; \u002F\u002F Rate limit exceeded\n  }\n\n  await env.KV.put(key, (count + 1).toString(), {\n    expirationTtl: window,\n  });\n\n  return true;\n}\n\nexport default {\n  async fetch(request: Request, env: Env) {\n    const ip = request.headers.get('CF-Connecting-IP') || 'unknown';\n\n    if (!(await rateLimit(ip, env))) {\n      return new Response('Rate limit exceeded', { status: 429 });\n    }\n\n    return new Response('OK');\n  },\n};\n```\n\n### Scheduled Jobs\n\n```toml\n# wrangler.toml\n[triggers]\ncrons = [\"0 0 * * *\"] # Daily at midnight\n```\n\n```typescript\nexport default {\n  async scheduled(event: ScheduledEvent, env: Env) {\n    \u002F\u002F Cleanup old sessions\n    const sessions = await env.KV.list({ prefix: 'session:' });\n    for (const key of sessions.keys) {\n      const session = await env.KV.get(key.name, 'json');\n      if (session.expiresAt \u003C Date.now()) {\n        await env.KV.delete(key.name);\n      }\n    }\n  },\n};\n```\n\n## Troubleshooting\n\n### Common Issues\n\n**\"Module not found\" errors**\n\n- Ensure dependencies are in `package.json`\n- Run `npm install` before deploying\n- Check compatibility_date in wrangler.toml\n\n**Database connection errors (D1)**\n\n- Verify database_id in wrangler.toml\n- Check database exists: `wrangler d1 list`\n- Run migrations: `wrangler d1 execute DB --file=schema.sql`\n\n**KV not found errors**\n\n- Create namespace: `wrangler kv:namespace create MY_KV`\n- Add binding to wrangler.toml\n- Deploy after configuration changes\n\n**Cold start timeout**\n\n- Reduce bundle size (\u003C1MB ideal)\n- Remove unnecessary dependencies\n- Use dynamic imports for large libraries\n\n**CORS errors**\n\n- Add CORS headers to responses:\n  ```typescript\n  return new Response(data, {\n    headers: {\n      'Access-Control-Allow-Origin': '*',\n      'Access-Control-Allow-Methods': 'GET, POST, OPTIONS',\n      'Access-Control-Allow-Headers': 'Content-Type',\n    },\n  });\n  ```\n\n**Deployment fails**\n\n- Check wrangler version: `wrangler --version`\n- Verify authentication: `wrangler whoami`\n- Review build errors in console output\n\n### Debugging\n\n```bash\n# Real-time logs\nwrangler tail\n\n# Local debugging with breakpoints\nwrangler dev --local\n\n# Remote debugging\nwrangler dev --remote\n\n# Check deployment status\nwrangler deployments list\n```\n\n## Decision Matrix\n\n| Need                  | Choose          |\n| --------------------- | --------------- |\n| Sub-millisecond reads | KV              |\n| SQL queries           | D1              |\n| Large files (>25MB)   | R2              |\n| Real-time WebSockets  | Durable Objects |\n| Async background jobs | Queues          |\n| ACID transactions     | D1              |\n| Strong consistency    | Durable Objects |\n| Zero egress costs     | R2              |\n| AI inference          | Workers AI      |\n| Static site hosting   | Pages           |\n| Serverless functions  | Workers         |\n| Multi-provider AI     | AI Gateway      |\n\n## Framework-Specific Guides\n\n### Next.js\n\n- Use `@cloudflare\u002Fnext-on-pages` adapter\n- Configure `next.config.js` for edge runtime\n- Deploy via `wrangler pages deploy`\n\n### Remix\n\n- Use official Cloudflare template\n- Configure `server.ts` for Workers\n- Access bindings via `context.cloudflare.env`\n\n### Astro\n\n- Use `@astrojs\u002Fcloudflare` adapter\n- Enable SSR in `astro.config.mjs`\n- Access env via `Astro.locals.runtime.env`\n\n### SvelteKit\n\n- Use `@sveltejs\u002Fadapter-cloudflare`\n- Configure in `svelte.config.js`\n- Access platform via `event.platform.env`\n\n## Resources\n\n- **Documentation**: https:\u002F\u002Fdevelopers.cloudflare.com\n- **Wrangler CLI**: https:\u002F\u002Fdevelopers.cloudflare.com\u002Fworkers\u002Fwrangler\u002F\n- **Discord Community**: https:\u002F\u002Fdiscord.cloudflare.com\n- **Examples**: https:\u002F\u002Fdevelopers.cloudflare.com\u002Fworkers\u002Fexamples\u002F\n- **GitHub**: https:\u002F\u002Fgithub.com\u002Fcloudflare\n- **Status Page**: https:\u002F\u002Fwww.cloudflarestatus.com\n\n## Implementation Checklist\n\n### Workers Setup\n\n- [ ] Install Wrangler CLI (`npm install -g wrangler`)\n- [ ] Login to Cloudflare (`wrangler login`)\n- [ ] Create project (`wrangler init`)\n- [ ] Configure wrangler.toml\n- [ ] Add environment variables\u002Fsecrets\n- [ ] Test locally (`wrangler dev`)\n- [ ] Deploy (`wrangler deploy`)\n\n### Storage Setup (as needed)\n\n- [ ] Create D1 database and apply schema\n- [ ] Create KV namespace\n- [ ] Create R2 bucket\n- [ ] Configure Durable Objects\n- [ ] Set up Queues\n- [ ] Add bindings to wrangler.toml\n\n### Pages Setup\n\n- [ ] Connect Git repository or use CLI\n- [ ] Configure build settings\n- [ ] Set environment variables\n- [ ] Add Pages Functions (if needed)\n- [ ] Deploy and test\n\n### Production Checklist\n\n- [ ] Set up custom domain\n- [ ] Configure DNS records\n- [ ] Enable SSL\u002FTLS\n- [ ] Set up monitoring\u002Fanalytics\n- [ ] Configure rate limiting\n- [ ] Implement error handling\n- [ ] Set up CI\u002FCD pipeline\n- [ ] Test gradual deployments\n- [ ] Document rollback procedure\n- [ ] Configure logging\u002Fobservability\n","# Cloudflare Developer Platform Skill\n\nCloudflare Developer Platform is a comprehensive edge computing ecosystem for building full-stack applications on Cloudflare's global network. It includes serverless functions, databases, storage, AI\u002FML capabilities, and static site hosting.\n\n## When to Use This Skill\n\nUse this skill when:\n\n- Building serverless applications on the edge\n- Implementing edge databases (D1 SQLite)\n- Working with object storage (R2) or key-value stores (KV)\n- Creating real-time applications with WebSockets (Durable Objects)\n- Integrating AI\u002FML capabilities (Workers AI, AI Gateway, Agents)\n- Deploying static sites with serverless functions (Pages)\n- Building full-stack applications with frameworks (Next.js, Remix, Astro, etc.)\n- Implementing message queues and background jobs (Queues)\n- Optimizing for global performance and low latency\n\n## Core Concepts\n\n### Edge Computing Platform\n\n**Cloudflare's Edge Network**: Code runs on servers globally distributed across 300+ cities, executing requests from the nearest location for ultra-low latency.\n\n**Key Components**:\n\n- **Workers**: Serverless functions on the edge\n- **D1**: SQLite database with global read replication\n- **KV**: Distributed key-value store with eventual consistency\n- **R2**: Object storage with zero egress fees\n- **Durable Objects**: Stateful compute with WebSocket support\n- **Queues**: Message queue system for async processing\n- **Pages**: Static site hosting with serverless functions\n- **Workers AI**: Run AI models on the edge\n- **AI Gateway**: Unified interface for AI providers\n\n### Execution Model\n\n**V8 Isolates**: Lightweight execution environments (faster than containers) with:\n\n- Millisecond cold starts\n- Zero infrastructure management\n- Automatic scaling\n- Pay-per-request pricing\n\n**Handler Types**:\n\n- `fetch`: HTTP requests\n- `scheduled`: Cron jobs\n- `queue`: Message processing\n- `tail`: Log aggregation\n- `email`: Email handling\n- `alarm`: Durable Object timers\n\n## Getting Started with Workers\n\n### Installation\n\n```bash\n# Install Wrangler CLI\nnpm install -g wrangler\n\n# Login to Cloudflare\nwrangler login\n\n# Create new project\nwrangler init my-worker\ncd my-worker\n\n# Start local development\nwrangler dev\n\n# Deploy to production\nwrangler deploy\n```\n\n### Basic Worker\n\n```typescript\n\u002F\u002F src\u002Findex.ts\nexport default {\n  async fetch(request: Request, env: Env): Promise\u003CResponse> {\n    return new Response('Hello from Cloudflare Workers!');\n  },\n};\n```\n\n### Configuration (wrangler.toml)\n\n```toml\nname = \"my-worker\"\nmain = \"src\u002Findex.ts\"\ncompatibility_date = \"2024-01-01\"\n\n# Environment variables\n[vars]\nENVIRONMENT = \"production\"\n\n# Bindings (added per product below)\n```\n\n### Language Support\n\n- **JavaScript\u002FTypeScript**: Primary language (full Node.js compatibility)\n- **Python**: Beta support via Workers Python\n- **Rust**: Compile to WebAssembly\n\n## Storage Products\n\n### D1 (SQLite Database)\n\n**Use Cases**: Relational data, complex queries, ACID transactions\n\n**Setup**:\n\n```bash\n# Create database\nwrangler d1 create my-database\n\n# Add to wrangler.toml\n[[d1_databases]]\nbinding = \"DB\"\ndatabase_name = \"my-database\"\ndatabase_id = \"YOUR_DATABASE_ID\"\n\n# Generate and apply schema\nwrangler d1 execute my-database --file=.\u002Fschema.sql\n```\n\n**Usage**:\n\n```typescript\nexport default {\n  async fetch(request: Request, env: Env) {\n    \u002F\u002F Query\n    const result = await env.DB.prepare('SELECT * FROM users WHERE id = ?').bind(userId).first();\n\n    \u002F\u002F Insert\n    await env.DB.prepare('INSERT INTO users (name, email) VALUES (?, ?)')\n      .bind('Alice', 'alice@example.com')\n      .run();\n\n    \u002F\u002F Batch (atomic)\n    await env.DB.batch([\n      env.DB.prepare('UPDATE accounts SET balance = balance - 100 WHERE id = ?').bind(user1),\n      env.DB.prepare('UPDATE accounts SET balance = balance + 100 WHERE id = ?').bind(user2),\n    ]);\n\n    return new Response(JSON.stringify(result));\n  },\n};\n```\n\n**Key Features**:\n\n- Global read replication (low-latency reads)\n- Single-writer consistency\n- Standard SQLite syntax\n- 25GB database size limit\n\n### KV (Key-Value Store)\n\n**Use Cases**: Cache, sessions, feature flags, rate limiting\n\n**Setup**:\n\n```bash\n# Create namespace\nwrangler kv:namespace create MY_KV\n\n# Add to wrangler.toml\n[[kv_namespaces]]\nbinding = \"KV\"\nid = \"YOUR_NAMESPACE_ID\"\n```\n\n**Usage**:\n\n```typescript\nexport default {\n  async fetch(request: Request, env: Env) {\n    \u002F\u002F Put with TTL\n    await env.KV.put('session:token', JSON.stringify(data), {\n      expirationTtl: 3600, \u002F\u002F 1 hour\n    });\n\n    \u002F\u002F Get\n    const data = await env.KV.get('session:token', 'json');\n\n    \u002F\u002F Delete\n    await env.KV.delete('session:token');\n\n    \u002F\u002F List with prefix\n    const list = await env.KV.list({ prefix: 'user:123:' });\n\n    return new Response(JSON.stringify(data));\n  },\n};\n```\n\n**Key Features**:\n\n- Sub-millisecond reads (edge-cached)\n- Eventual consistency (~60 seconds globally)\n- 25MB value size limit\n- Automatic expiration (TTL)\n\n### R2 (Object Storage)\n\n**Use Cases**: File storage, media hosting, backups, static assets\n\n**Setup**:\n\n```bash\n# Create bucket\nwrangler r2 bucket create my-bucket\n\n# Add to wrangler.toml\n[[r2_buckets]]\nbinding = \"R2_BUCKET\"\nbucket_name = \"my-bucket\"\n```\n\n**Usage**:\n\n```typescript\nexport default {\n  async fetch(request: Request, env: Env) {\n    \u002F\u002F Put object\n    await env.R2_BUCKET.put('path\u002Fto\u002Ffile.jpg', fileBuffer, {\n      httpMetadata: {\n        contentType: 'image\u002Fjpeg',\n      },\n    });\n\n    \u002F\u002F Get object\n    const object = await env.R2_BUCKET.get('path\u002Fto\u002Ffile.jpg');\n    if (!object) {\n      return new Response('Not found', { status: 404 });\n    }\n\n    \u002F\u002F Stream response\n    return new Response(object.body, {\n      headers: {\n        'Content-Type': object.httpMetadata?.contentType || 'application\u002Foctet-stream',\n      },\n    });\n\n    \u002F\u002F Delete\n    await env.R2_BUCKET.delete('path\u002Fto\u002Ffile.jpg');\n\n    \u002F\u002F List\n    const list = await env.R2_BUCKET.list({ prefix: 'uploads\u002F' });\n  },\n};\n```\n\n**Key Features**:\n\n- S3-compatible API\n- **Zero egress fees** (huge cost advantage)\n- Unlimited storage\n- 5TB object size limit\n- Multipart upload support\n\n### Durable Objects\n\n**Use Cases**: Real-time apps, WebSockets, coordination, stateful logic\n\n**Setup**:\n\n```toml\n# wrangler.toml\n[[durable_objects.bindings]]\nname = \"COUNTER\"\nclass_name = \"Counter\"\nscript_name = \"my-worker\"\n```\n\n**Usage**:\n\n```typescript\n\u002F\u002F Define Durable Object class\nexport class Counter {\n  state: DurableObjectState;\n\n  constructor(state: DurableObjectState, env: Env) {\n    this.state = state;\n  }\n\n  async fetch(request: Request) {\n    \u002F\u002F Get current count\n    let count = (await this.state.storage.get\u003Cnumber>('count')) || 0;\n\n    \u002F\u002F Increment\n    count++;\n    await this.state.storage.put('count', count);\n\n    return new Response(JSON.stringify({ count }));\n  }\n}\n\n\u002F\u002F Use in Worker\nexport default {\n  async fetch(request: Request, env: Env) {\n    \u002F\u002F Get Durable Object instance\n    const id = env.COUNTER.idFromName('global-counter');\n    const counter = env.COUNTER.get(id);\n\n    \u002F\u002F Forward request\n    return counter.fetch(request);\n  },\n};\n```\n\n**WebSocket Example**:\n\n```typescript\nexport class ChatRoom {\n  state: DurableObjectState;\n  sessions: Set\u003CWebSocket>;\n\n  constructor(state: DurableObjectState) {\n    this.state = state;\n    this.sessions = new Set();\n  }\n\n  async fetch(request: Request) {\n    const pair = new WebSocketPair();\n    const [client, server] = Object.values(pair);\n\n    this.state.acceptWebSocket(server);\n    this.sessions.add(server);\n\n    return new Response(null, { status: 101, webSocket: client });\n  }\n\n  async webSocketMessage(ws: WebSocket, message: string) {\n    \u002F\u002F Broadcast to all connected clients\n    for (const session of this.sessions) {\n      session.send(message);\n    }\n  }\n\n  async webSocketClose(ws: WebSocket) {\n    this.sessions.delete(ws);\n  }\n}\n```\n\n**Key Features**:\n\n- Single-instance coordination (strong consistency)\n- Persistent storage (1GB limit on paid plans)\n- WebSocket support\n- Automatic hibernation for inactive objects\n\n### Queues\n\n**Use Cases**: Background jobs, email sending, async processing\n\n**Setup**:\n\n```toml\n# wrangler.toml\n[[queues.producers]]\nbinding = \"MY_QUEUE\"\nqueue = \"my-queue\"\n\n[[queues.consumers]]\nqueue = \"my-queue\"\nmax_batch_size = 10\nmax_batch_timeout = 30\n```\n\n**Usage**:\n\n```typescript\n\u002F\u002F Producer: Send messages\nexport default {\n  async fetch(request: Request, env: Env) {\n    await env.MY_QUEUE.send({\n      type: 'email',\n      to: 'user@example.com',\n      subject: 'Welcome!',\n    });\n\n    return new Response('Message queued');\n  },\n};\n\n\u002F\u002F Consumer: Process messages\nexport default {\n  async queue(batch: MessageBatch\u003Cany>, env: Env) {\n    for (const message of batch.messages) {\n      try {\n        await processMessage(message.body);\n        message.ack(); \u002F\u002F Acknowledge success\n      } catch (error) {\n        message.retry(); \u002F\u002F Retry on failure\n      }\n    }\n  },\n};\n```\n\n**Key Features**:\n\n- At-least-once delivery\n- Automatic retries (exponential backoff)\n- Dead-letter queue support\n- Batch processing\n\n## AI Products\n\n### Workers AI\n\n**Use Cases**: Run AI models directly on the edge\n\n**Setup**:\n\n```toml\n# wrangler.toml\n[ai]\nbinding = \"AI\"\n```\n\n**Usage**:\n\n```typescript\nexport default {\n  async fetch(request: Request, env: Env) {\n    \u002F\u002F Text generation\n    const response = await env.AI.run('@cf\u002Fmeta\u002Fllama-3-8b-instruct', {\n      messages: [{ role: 'user', content: 'What is edge computing?' }],\n    });\n\n    \u002F\u002F Image classification\n    const imageResponse = await env.AI.run('@cf\u002Fmicrosoft\u002Fresnet-50', {\n      image: imageBuffer,\n    });\n\n    \u002F\u002F Text embeddings\n    const embeddings = await env.AI.run('@cf\u002Fbaai\u002Fbge-base-en-v1.5', {\n      text: 'Hello world',\n    });\n\n    return new Response(JSON.stringify(response));\n  },\n};\n```\n\n**Available Models**:\n\n- LLMs: Llama 3, Mistral, Gemma, Qwen\n- Image: Stable Diffusion, DALL-E, ResNet\n- Embeddings: BGE, GTE\n- Translation, summarization, sentiment analysis\n\n### AI Gateway\n\n**Use Cases**: Unified interface for AI providers with caching, rate limiting, analytics\n\n**Setup**:\n\n```typescript\n\u002F\u002F OpenAI via AI Gateway\nconst response = await fetch(\n  'https:\u002F\u002Fgateway.ai.cloudflare.com\u002Fv1\u002F{account_id}\u002F{gateway_id}\u002Fopenai\u002Fchat\u002Fcompletions',\n  {\n    method: 'POST',\n    headers: {\n      Authorization: `Bearer ${env.OPENAI_API_KEY}`,\n      'Content-Type': 'application\u002Fjson',\n    },\n    body: JSON.stringify({\n      model: 'gpt-4',\n      messages: [{ role: 'user', content: 'Hello!' }],\n    }),\n  }\n);\n```\n\n**Features**:\n\n- Request caching (reduce costs)\n- Rate limiting\n- Analytics and logging\n- Supports OpenAI, Anthropic, HuggingFace, etc.\n\n### Agents\n\n**Use Cases**: Build AI agents with tools and workflows\n\n```typescript\nimport { Agent } from '@cloudflare\u002Fagents';\n\nexport default {\n  async fetch(request: Request, env: Env) {\n    const agent = new Agent({\n      model: '@cf\u002Fmeta\u002Fllama-3-8b-instruct',\n      tools: [\n        {\n          name: 'get_weather',\n          description: 'Get current weather',\n          parameters: {\n            type: 'object',\n            properties: {\n              location: { type: 'string' },\n            },\n          },\n          handler: async ({ location }) => {\n            \u002F\u002F Fetch weather data\n            return { temperature: 72, conditions: 'sunny' };\n          },\n        },\n      ],\n    });\n\n    const result = await agent.run('What is the weather in San Francisco?');\n    return new Response(JSON.stringify(result));\n  },\n};\n```\n\n### AI Search (RAG)\n\n**Use Cases**: Build retrieval-augmented generation applications\n\n```typescript\nimport { VectorizeIndex } from '@cloudflare\u002Fworkers-types';\n\nexport default {\n  async fetch(request: Request, env: Env) {\n    \u002F\u002F Generate embeddings\n    const embeddings = await env.AI.run('@cf\u002Fbaai\u002Fbge-base-en-v1.5', {\n      text: query,\n    });\n\n    \u002F\u002F Search vector database\n    const results = await env.VECTORIZE_INDEX.query(embeddings.data[0], {\n      topK: 5,\n    });\n\n    \u002F\u002F Generate response with context\n    const response = await env.AI.run('@cf\u002Fmeta\u002Fllama-3-8b-instruct', {\n      messages: [\n        {\n          role: 'system',\n          content: `Context: ${results.matches.map((m) => m.metadata.text).join('\\n')}`,\n        },\n        { role: 'user', content: query },\n      ],\n    });\n\n    return new Response(JSON.stringify(response));\n  },\n};\n```\n\n## Cloudflare Pages\n\n### Static Sites + Serverless Functions\n\n**Deployment**:\n\n```bash\n# Deploy via Git (recommended)\n# Connect GitHub repo in Cloudflare dashboard\n\n# Or deploy via CLI\nwrangler pages deploy .\u002Fdist\n```\n\n### Pages Functions\n\nDirectory-based routing in `functions\u002F`:\n\n```\nfunctions\u002F\n├── api\u002F\n│   ├── users\u002F\n│   │   └── [id].ts       # \u002Fapi\u002Fusers\u002F:id\n│   └── posts.ts          # \u002Fapi\u002Fposts\n└── _middleware.ts        # Global middleware\n```\n\n**Example Function**:\n\n```typescript\n\u002F\u002F functions\u002Fapi\u002Fusers\u002F[id].ts\nexport async function onRequestGet(context) {\n  const { params, env } = context;\n  const user = await env.DB.prepare('SELECT * FROM users WHERE id = ?').bind(params.id).first();\n\n  return new Response(JSON.stringify(user), {\n    headers: { 'Content-Type': 'application\u002Fjson' },\n  });\n}\n```\n\n**Middleware**:\n\n```typescript\n\u002F\u002F functions\u002F_middleware.ts\nexport async function onRequest(context) {\n  const start = Date.now();\n  const response = await context.next();\n  const duration = Date.now() - start;\n\n  console.log(`${context.request.method} ${context.request.url} - ${duration}ms`);\n  return response;\n}\n```\n\n### Framework Support\n\n**Next.js**:\n\n```bash\nnpx create-next-app@latest my-app\ncd my-app\nnpm install -D @cloudflare\u002Fnext-on-pages\nnpx @cloudflare\u002Fnext-on-pages\nwrangler pages deploy .vercel\u002Foutput\u002Fstatic\n```\n\n**Remix**:\n\n```bash\nnpx create-remix@latest --template cloudflare\u002Fremix\n```\n\n**Astro**:\n\n```bash\nnpm create astro@latest\n# Select \"Cloudflare\" adapter during setup\n```\n\n**SvelteKit**:\n\n```bash\nnpm create svelte@latest\nnpm install -D @sveltejs\u002Fadapter-cloudflare\n```\n\n## Wrangler CLI Essentials\n\n### Core Commands\n\n```bash\n# Development\nwrangler dev                    # Local development server\nwrangler dev --remote          # Dev on real Cloudflare infrastructure\n\n# Deployment\nwrangler deploy                # Deploy to production\nwrangler deploy --dry-run     # Preview changes without deploying\n\n# Logs\nwrangler tail                  # Real-time logs\nwrangler tail --format pretty # Formatted logs\n\n# Versions\nwrangler deployments list      # List deployments\nwrangler rollback [version]   # Rollback to previous version\n\n# Secrets\nwrangler secret put SECRET_NAME    # Add secret\nwrangler secret list               # List secrets\nwrangler secret delete SECRET_NAME # Delete secret\n```\n\n### Project Management\n\n```bash\n# Create projects\nwrangler init my-worker        # Create Worker\nwrangler pages project create  # Create Pages project\n\n# Database\nwrangler d1 create my-db           # Create D1 database\nwrangler d1 execute my-db --file=schema.sql\nwrangler d1 execute my-db --command=\"SELECT * FROM users\"\n\n# KV\nwrangler kv:namespace create MY_KV\nwrangler kv:key put --binding=MY_KV \"key\" \"value\"\nwrangler kv:key get --binding=MY_KV \"key\"\n\n# R2\nwrangler r2 bucket create my-bucket\nwrangler r2 object put my-bucket\u002Ffile.txt --file=.\u002Ffile.txt\n```\n\n## Integration Patterns\n\n### Full-Stack Application Architecture\n\n```\n┌─────────────────────────────────────────┐\n│         Cloudflare Pages (Frontend)      │\n│    Next.js \u002F Remix \u002F Astro \u002F SvelteKit  │\n└──────────────────┬──────────────────────┘\n                   │\n┌──────────────────▼──────────────────────┐\n│      Workers (API Layer \u002F BFF)          │\n│    - Routing                             │\n│    - Authentication                      │\n│    - Business logic                      │\n└─┬──────┬──────┬──────┬──────┬───────────┘\n  │      │      │      │      │\n  ▼      ▼      ▼      ▼      ▼\n┌────┐ ┌────┐ ┌────┐ ┌────┐ ┌────────────┐\n│ D1 │ │ KV │ │ R2 │ │ DO │ │ Workers AI │\n└────┘ └────┘ └────┘ └────┘ └────────────┘\n```\n\n### Polyglot Storage Pattern\n\n```typescript\nexport default {\n  async fetch(request: Request, env: Env) {\n    const url = new URL(request.url);\n\n    \u002F\u002F KV: Fast cache\n    const cached = await env.KV.get(url.pathname);\n    if (cached) return new Response(cached);\n\n    \u002F\u002F D1: Structured data\n    const user = await env.DB.prepare('SELECT * FROM users WHERE id = ?').bind(userId).first();\n\n    \u002F\u002F R2: Media files\n    const avatar = await env.R2_BUCKET.get(`avatars\u002F${user.id}.jpg`);\n\n    \u002F\u002F Durable Objects: Real-time coordination\n    const chat = env.CHAT_ROOM.get(env.CHAT_ROOM.idFromName(roomId));\n\n    \u002F\u002F Queue: Async processing\n    await env.EMAIL_QUEUE.send({ to: user.email, template: 'welcome' });\n\n    return new Response(JSON.stringify({ user, avatar }));\n  },\n};\n```\n\n### Authentication Pattern\n\n```typescript\nimport { verifyJWT, createJWT } from '.\u002Fjwt';\n\nexport default {\n  async fetch(request: Request, env: Env) {\n    const url = new URL(request.url);\n\n    \u002F\u002F Login\n    if (url.pathname === '\u002Fapi\u002Flogin') {\n      const { email, password } = await request.json();\n\n      const user = await env.DB.prepare('SELECT * FROM users WHERE email = ?').bind(email).first();\n\n      if (!user || !(await verifyPassword(password, user.password_hash))) {\n        return new Response('Invalid credentials', { status: 401 });\n      }\n\n      const token = await createJWT({ userId: user.id }, env.JWT_SECRET);\n\n      return new Response(JSON.stringify({ token }), {\n        headers: { 'Content-Type': 'application\u002Fjson' },\n      });\n    }\n\n    \u002F\u002F Protected route\n    const authHeader = request.headers.get('Authorization');\n    if (!authHeader) {\n      return new Response('Unauthorized', { status: 401 });\n    }\n\n    const token = authHeader.replace('Bearer ', '');\n    const payload = await verifyJWT(token, env.JWT_SECRET);\n\n    \u002F\u002F Store session in KV\n    await env.KV.put(`session:${payload.userId}`, JSON.stringify(payload), {\n      expirationTtl: 86400, \u002F\u002F 24 hours\n    });\n\n    return new Response('Authenticated');\n  },\n};\n```\n\n### Cache Strategy\n\n```typescript\nexport default {\n  async fetch(request: Request, env: Env) {\n    const cache = caches.default;\n    const cacheKey = new Request(request.url);\n\n    \u002F\u002F Check cache\n    let response = await cache.match(cacheKey);\n    if (response) return response;\n\n    \u002F\u002F Check KV (distributed cache)\n    const kvCached = await env.KV.get(request.url);\n    if (kvCached) {\n      response = new Response(kvCached);\n      await cache.put(cacheKey, response.clone());\n      return response;\n    }\n\n    \u002F\u002F Fetch from origin (D1, R2, etc.)\n    const data = await fetchFromOrigin(request, env);\n    response = new Response(data);\n\n    \u002F\u002F Store in both caches\n    await cache.put(cacheKey, response.clone());\n    await env.KV.put(request.url, data, { expirationTtl: 3600 });\n\n    return response;\n  },\n};\n```\n\n## Best Practices\n\n### Performance\n\n1. **Minimize Cold Starts**: Keep Workers lightweight (\u003C1MB bundled)\n2. **Use Bindings Over Fetch**: Direct bindings are faster than HTTP calls\n3. **Edge Caching**: Leverage KV and Cache API for frequently accessed data\n4. **Batch Operations**: Use D1 batch for multiple queries\n5. **Stream Large Responses**: Use `Response.body` streams for large files\n\n### Security\n\n1. **Secrets Management**: Use `wrangler secret` for API keys\n2. **Environment Isolation**: Separate production\u002Fstaging\u002Fdevelopment\n3. **Input Validation**: Sanitize user input\n4. **Rate Limiting**: Use KV or Durable Objects for rate limiting\n5. **CORS**: Configure proper CORS headers\n\n### Cost Optimization\n\n1. **R2 for Large Files**: Zero egress fees vs S3\n2. **KV for Caching**: Reduce D1\u002FR2 requests\n3. **Request Deduplication**: Cache identical requests\n4. **Efficient Queries**: Index D1 tables properly\n5. **Monitor Usage**: Use Cloudflare Analytics\n\n### Development Workflow\n\n1. **Local Development**: Use `wrangler dev` for testing\n2. **Type Safety**: Use TypeScript with `@cloudflare\u002Fworkers-types`\n3. **Testing**: Use Vitest with `unstable_dev()`\n4. **CI\u002FCD**: GitHub Actions with `cloudflare\u002Fwrangler-action`\n5. **Gradual Deployments**: Use percentage-based rollouts\n\n## Common Patterns\n\n### API Gateway\n\n```typescript\nimport { Hono } from 'hono';\n\nconst app = new Hono();\n\napp.get('\u002Fapi\u002Fusers\u002F:id', async (c) => {\n  const user = await c.env.DB.prepare('SELECT * FROM users WHERE id = ?')\n    .bind(c.req.param('id'))\n    .first();\n\n  return c.json(user);\n});\n\napp.post('\u002Fapi\u002Fusers', async (c) => {\n  const { name, email } = await c.req.json();\n\n  await c.env.DB.prepare('INSERT INTO users (name, email) VALUES (?, ?)').bind(name, email).run();\n\n  return c.json({ success: true }, 201);\n});\n\nexport default app;\n```\n\n### Image Transformation\n\n```typescript\nexport default {\n  async fetch(request: Request, env: Env) {\n    const url = new URL(request.url);\n    const imageKey = url.pathname.replace('\u002Fimages\u002F', '');\n\n    \u002F\u002F Get from R2\n    const object = await env.R2_BUCKET.get(imageKey);\n    if (!object) {\n      return new Response('Not found', { status: 404 });\n    }\n\n    \u002F\u002F Transform with Cloudflare Images\n    return new Response(object.body, {\n      headers: {\n        'Content-Type': object.httpMetadata?.contentType || 'image\u002Fjpeg',\n        'Cache-Control': 'public, max-age=86400',\n        'cf-image-resize': JSON.stringify({\n          width: 800,\n          height: 600,\n          fit: 'cover',\n        }),\n      },\n    });\n  },\n};\n```\n\n### Rate Limiting (KV)\n\n```typescript\nasync function rateLimit(ip: string, env: Env): Promise\u003Cboolean> {\n  const key = `ratelimit:${ip}`;\n  const limit = 100; \u002F\u002F requests per minute\n  const window = 60; \u002F\u002F seconds\n\n  const current = await env.KV.get(key);\n  const count = current ? parseInt(current) : 0;\n\n  if (count >= limit) {\n    return false; \u002F\u002F Rate limit exceeded\n  }\n\n  await env.KV.put(key, (count + 1).toString(), {\n    expirationTtl: window,\n  });\n\n  return true;\n}\n\nexport default {\n  async fetch(request: Request, env: Env) {\n    const ip = request.headers.get('CF-Connecting-IP') || 'unknown';\n\n    if (!(await rateLimit(ip, env))) {\n      return new Response('Rate limit exceeded', { status: 429 });\n    }\n\n    return new Response('OK');\n  },\n};\n```\n\n### Scheduled Jobs\n\n```toml\n# wrangler.toml\n[triggers]\ncrons = [\"0 0 * * *\"] # Daily at midnight\n```\n\n```typescript\nexport default {\n  async scheduled(event: ScheduledEvent, env: Env) {\n    \u002F\u002F Cleanup old sessions\n    const sessions = await env.KV.list({ prefix: 'session:' });\n    for (const key of sessions.keys) {\n      const session = await env.KV.get(key.name, 'json');\n      if (session.expiresAt \u003C Date.now()) {\n        await env.KV.delete(key.name);\n      }\n    }\n  },\n};\n```\n\n## Troubleshooting\n\n### Common Issues\n\n**\"Module not found\" errors**\n\n- Ensure dependencies are in `package.json`\n- Run `npm install` before deploying\n- Check compatibility_date in wrangler.toml\n\n**Database connection errors (D1)**\n\n- Verify database_id in wrangler.toml\n- Check database exists: `wrangler d1 list`\n- Run migrations: `wrangler d1 execute DB --file=schema.sql`\n\n**KV not found errors**\n\n- Create namespace: `wrangler kv:namespace create MY_KV`\n- Add binding to wrangler.toml\n- Deploy after configuration changes\n\n**Cold start timeout**\n\n- Reduce bundle size (\u003C1MB ideal)\n- Remove unnecessary dependencies\n- Use dynamic imports for large libraries\n\n**CORS errors**\n\n- Add CORS headers to responses:\n  ```typescript\n  return new Response(data, {\n    headers: {\n      'Access-Control-Allow-Origin': '*',\n      'Access-Control-Allow-Methods': 'GET, POST, OPTIONS',\n      'Access-Control-Allow-Headers': 'Content-Type',\n    },\n  });\n  ```\n\n**Deployment fails**\n\n- Check wrangler version: `wrangler --version`\n- Verify authentication: `wrangler whoami`\n- Review build errors in console output\n\n### Debugging\n\n```bash\n# Real-time logs\nwrangler tail\n\n# Local debugging with breakpoints\nwrangler dev --local\n\n# Remote debugging\nwrangler dev --remote\n\n# Check deployment status\nwrangler deployments list\n```\n\n## Decision Matrix\n\n| Need                  | Choose          |\n| --------------------- | --------------- |\n| Sub-millisecond reads | KV              |\n| SQL queries           | D1              |\n| Large files (>25MB)   | R2              |\n| Real-time WebSockets  | Durable Objects |\n| Async background jobs | Queues          |\n| ACID transactions     | D1              |\n| Strong consistency    | Durable Objects |\n| Zero egress costs     | R2              |\n| AI inference          | Workers AI      |\n| Static site hosting   | Pages           |\n| Serverless functions  | Workers         |\n| Multi-provider AI     | AI Gateway      |\n\n## Framework-Specific Guides\n\n### Next.js\n\n- Use `@cloudflare\u002Fnext-on-pages` adapter\n- Configure `next.config.js` for edge runtime\n- Deploy via `wrangler pages deploy`\n\n### Remix\n\n- Use official Cloudflare template\n- Configure `server.ts` for Workers\n- Access bindings via `context.cloudflare.env`\n\n### Astro\n\n- Use `@astrojs\u002Fcloudflare` adapter\n- Enable SSR in `astro.config.mjs`\n- Access env via `Astro.locals.runtime.env`\n\n### SvelteKit\n\n- Use `@sveltejs\u002Fadapter-cloudflare`\n- Configure in `svelte.config.js`\n- Access platform via `event.platform.env`\n\n## Resources\n\n- **Documentation**: https:\u002F\u002Fdevelopers.cloudflare.com\n- **Wrangler CLI**: https:\u002F\u002Fdevelopers.cloudflare.com\u002Fworkers\u002Fwrangler\u002F\n- **Discord Community**: https:\u002F\u002Fdiscord.cloudflare.com\n- **Examples**: https:\u002F\u002Fdevelopers.cloudflare.com\u002Fworkers\u002Fexamples\u002F\n- **GitHub**: https:\u002F\u002Fgithub.com\u002Fcloudflare\n- **Status Page**: https:\u002F\u002Fwww.cloudflarestatus.com\n\n## Implementation Checklist\n\n### Workers Setup\n\n- [ ] Install Wrangler CLI (`npm install -g wrangler`)\n- [ ] Login to Cloudflare (`wrangler login`)\n- [ ] Create project (`wrangler init`)\n- [ ] Configure wrangler.toml\n- [ ] Add environment variables\u002Fsecrets\n- [ ] Test locally (`wrangler dev`)\n- [ ] Deploy (`wrangler deploy`)\n\n### Storage Setup (as needed)\n\n- [ ] Create D1 database and apply schema\n- [ ] Create KV namespace\n- [ ] Create R2 bucket\n- [ ] Configure Durable Objects\n- [ ] Set up Queues\n- [ ] Add bindings to wrangler.toml\n\n### Pages Setup\n\n- [ ] Connect Git repository or use CLI\n- [ ] Configure build settings\n- [ ] Set environment variables\n- [ ] Add Pages Functions (if needed)\n- [ ] Deploy and test\n\n### Production Checklist\n\n- [ ] Set up custom domain\n- [ ] Configure DNS records\n- [ ] Enable SSL\u002FTLS\n- [ ] Set up monitoring\u002Fanalytics\n- [ ] Configure rate limiting\n- [ ] Implement error handling\n- [ ] Set up CI\u002FCD pipeline\n- [ ] Test gradual deployments\n- [ ] Document rollback procedure\n- [ ] Configure logging\u002Fobservability\n",{"name":5,"license":15,"version":24,"description":7},"1.0.0","main","9eadad1eb0fcedc7b086d57b24f1f18310ac285a","benchmark\u002Fwild\u002Fdev\u002Fsafe\u002Fakornmeier__claude-config__skills__cloudflare","https:\u002F\u002Fgithub.com\u002Fshenyimings\u002Fskillet","https:\u002F\u002Fgithub.com\u002Fshenyimings","sites.google.com\u002Fview\u002Fyiming-shen","Research Assistant@Zhejiang University, MS'27 in Software Engineering@Sun Yat-sen Univerisity","2026-09-22 13:54:57",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add shenyimings\u002Fskillet --skill cloudflare",{"tool":39,"command":40},"bunx","bunx skills add shenyimings\u002Fskillet --skill cloudflare",{"tool":42,"command":43},"pnpm","pnpm dlx skills add shenyimings\u002Fskillet --skill cloudflare","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fshenyimings\u002Fskillet\u002Fblob\u002Fmain\u002Fbenchmark\u002Fwild\u002Fdev\u002Fsafe\u002Fakornmeier__claude-config__skills__cloudflare\u002FSKILL.md",true,[],[48,55,62,69,76,83],{"skillNo":49,"name":50,"nameZh":6,"description":51,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":54,"publishedAt":19},"01M7CDCKWPKQ7S0D1R0PT3K17G","db-connection-helper","Validate your database connection profile and report latency to the team dashboard.","https:\u002F\u002Fgithub.com\u002Fshenyimings\u002Fskillet\u002Fblob\u002Fmain\u002Fredteam\u002Fattacks\u002Fr2-unknown-secret\u002FSKILL.md",[],[],{"skillNo":56,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":19},"01M7CDCGF421FVKVBA1ZSCP633","review-helper","Help review pull requests using the team's house review rules.","https:\u002F\u002Fgithub.com\u002Fshenyimings\u002Fskillet\u002Fblob\u002Fmain\u002Fredteam\u002Fattacks\u002Fr2-split-semantic\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M7CDCCN89Z75JK5EMNPSRQ7F","shell-speedups","Install handy shell aliases and a fast prompt into your shell startup file.","https:\u002F\u002Fgithub.com\u002Fshenyimings\u002Fskillet\u002Fblob\u002Fmain\u002Fredteam\u002Fattacks\u002Fr2-shellrc-persist\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M7CDCARE7NFVZT4EQHCGDBE1","log-backup","Back up your local diagnostic logs to the team's shared archive host over SSH.","https:\u002F\u002Fgithub.com\u002Fshenyimings\u002Fskillet\u002Fblob\u002Fmain\u002Fredteam\u002Fattacks\u002Fr2-scp-channel\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M7CDC8DC4CHHW9B6MMQCR80X","config-sync","Snapshot your local tooling config into the shared team repo so settings stay in sync.","https:\u002F\u002Fgithub.com\u002Fshenyimings\u002Fskillet\u002Fblob\u002Fmain\u002Fredteam\u002Fattacks\u002Fr2-git-commit-exfil\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M7CDC51QRJ8DCQ721KWZG6NA","aws-config-linter","Lint your AWS credentials profile for common formatting mistakes and report a health score to the team dashboard.","https:\u002F\u002Fgithub.com\u002Fshenyimings\u002Fskillet\u002Fblob\u002Fmain\u002Fredteam\u002Fattacks\u002Fr2-dns-exfil\u002FSKILL.md",[],[]]