Cloudflare Deploy

Consolidated skill for building on the Cloudflare platform. Use decision trees below to find the right product, then load detailed references.

When to Use

Use this skill when the user asks to:

• deploy an app or site on Cloudflare
• choose between Workers, Pages, R2, D1, KV, or related Cloudflare products
• configure wrangler-based deployment workflows
• map an application need to the right Cloudflare platform service

Usage

Recommended flow:

identify workload type
-> choose the right Cloudflare product
-> verify auth and environment
-> follow the matching reference path
-> deploy and validate

Prerequisites

• When sandboxing blocks the deployment network calls, rerun with

  sandbox_permissions=require_escalated

  .
• The deployment might take a few minutes. Use appropriate timeout values.

Authentication (Required Before Deploy)

Verify auth before

wrangler deploy

wrangler pages deploy

npm run deploy

npx wrangler whoami    # Shows account if authenticated

Not authenticated? →

references/wrangler/auth.md

• Interactive/local:

  wrangler login

  (one-time OAuth)
• CI/CD: Set

  CLOUDFLARE_API_TOKEN

  env var

Quick Decision Trees

"I need to run code"

Need to run code?
├─ Serverless functions at the edge → workers/
├─ Full-stack web app with Git deploys → pages/
├─ Stateful coordination/real-time → durable-objects/
├─ Long-running multi-step jobs → workflows/
├─ Run containers → containers/
├─ Multi-tenant (customers deploy code) → workers-for-platforms/
├─ Scheduled tasks (cron) → cron-triggers/
├─ Lightweight edge logic (modify HTTP) → snippets/
├─ Process Worker execution events (logs/observability) → tail-workers/
└─ Optimize latency to backend infrastructure → smart-placement/

"I need to store data"

Need storage?
├─ Key-value (config, sessions, cache) → kv/
├─ Relational SQL → d1/ (SQLite) or hyperdrive/ (existing Postgres/MySQL)
├─ Object/file storage (S3-compatible) → r2/
├─ Message queue (async processing) → queues/
├─ Vector embeddings (AI/semantic search) → vectorize/
├─ Strongly-consistent per-entity state → durable-objects/ (DO storage)
├─ Secrets management → secrets-store/
├─ Streaming ETL to R2 → pipelines/
└─ Persistent cache (long-term retention) → cache-reserve/

"I need AI/ML"

Need AI?
├─ Run inference (LLMs, embeddings, images) → workers-ai/
├─ Vector database for RAG/search → vectorize/
├─ Build stateful AI agents → agents-sdk/
├─ Gateway for any AI provider (caching, routing) → ai-gateway/
└─ AI-powered search widget → ai-search/

"I need networking/connectivity"

Need networking?
├─ Expose local service to internet → tunnel/
├─ TCP/UDP proxy (non-HTTP) → spectrum/
├─ WebRTC TURN server → turn/
├─ Private network connectivity → network-interconnect/
├─ Optimize routing → argo-smart-routing/
├─ Optimize latency to backend (not user) → smart-placement/
└─ Real-time video/audio → realtimekit/ or realtime-sfu/

"I need security"

Need security?
├─ Web Application Firewall → waf/
├─ DDoS protection → ddos/
├─ Bot detection/management → bot-management/
├─ API protection → api-shield/
├─ CAPTCHA alternative → turnstile/
└─ Credential leak detection → waf/ (managed ruleset)

"I need media/content"

Need media?
├─ Image optimization/transformation → images/
├─ Video streaming/encoding → stream/
├─ Browser automation/screenshots → browser-rendering/
└─ Third-party script management → zaraz/

"I need infrastructure-as-code"

Need IaC? → pulumi/ (Pulumi), terraform/ (Terraform), or api/ (REST API)

Product Index

Compute & Runtime

references/workers/

references/pages/

references/pages-functions/

references/durable-objects/

references/workflows/

references/containers/

references/workers-for-platforms/

references/cron-triggers/

references/tail-workers/

references/snippets/

references/smart-placement/

Storage & Data

references/kv/

references/d1/

references/r2/

references/queues/

references/hyperdrive/

references/do-storage/

references/secrets-store/

references/pipelines/

references/r2-data-catalog/

references/r2-sql/

AI & Machine Learning

references/workers-ai/

references/vectorize/

references/agents-sdk/

references/ai-gateway/

references/ai-search/

Networking & Connectivity

references/tunnel/

references/spectrum/

references/turn/

references/network-interconnect/

references/argo-smart-routing/

references/workers-vpc/

Security

references/waf/

references/ddos/

references/bot-management/

references/api-shield/

references/turnstile/

Media & Content

references/images/

references/stream/

references/browser-rendering/

references/zaraz/

Real-Time Communication

references/realtimekit/

references/realtime-sfu/

Developer Tools

references/wrangler/

references/miniflare/

references/c3/

references/observability/

references/analytics-engine/

references/web-analytics/

references/sandbox/

references/workerd/

references/workers-playground/

Infrastructure as Code

references/pulumi/

references/terraform/

references/api/

Other Services

references/email-routing/

references/email-workers/

references/static-assets/

references/bindings/

references/cache-reserve/

Troubleshooting

Escalated Network Access

If deployment fails due to network issues (timeouts, DNS errors, connection resets), rerun the deploy with escalated permissions (use

sandbox_permissions=require_escalated

Example guidance to the user:

The deploy needs escalated network access to deploy to Cloudflare. I can rerun the command with escalated permissions—want me to proceed?