Skip to content

fcakyon/claude-codex-settings / plugins/cloudflare-skills/skills/cloudflare-deploy

cloudflare-deploy

Verified

Discover and choose Cloudflare products for apps, APIs, AI agents, storage, networking, and security. Use for architecture and product selection, including when the user describes a need without naming a Cloudflare product; then find the relevant skill or documentation.

FileKindSize
SKILL.mdskill md26.7 KB
references/ai-gateway/README.mdmarkdown1.9 KB
references/ai-gateway/configuration.mdmarkdown2.2 KB
references/ai-gateway/dynamic-routing.mdmarkdown1.9 KB
references/ai-gateway/features.mdmarkdown2.6 KB
references/ai-gateway/sdk-integration.mdmarkdown2.2 KB
references/ai-gateway/troubleshooting.mdmarkdown2.5 KB
references/ai-search/README.mdmarkdown1.8 KB
references/ai-search/api.mdmarkdown1.3 KB
references/ai-search/configuration.mdmarkdown1.8 KB
references/ai-search/gotchas.mdmarkdown1.6 KB
references/ai-search/patterns.mdmarkdown1.7 KB
references/bindings/README.mdmarkdown1.3 KB
references/bindings/api.mdmarkdown2.4 KB
references/bindings/configuration.mdmarkdown2.5 KB
references/bindings/gotchas.mdmarkdown3.0 KB
references/bindings/patterns.mdmarkdown2.4 KB
references/browser-rendering/README.mdmarkdown1.2 KB
references/browser-rendering/api.mdmarkdown1.2 KB
references/browser-rendering/configuration.mdmarkdown1.3 KB
references/browser-rendering/gotchas.mdmarkdown1.9 KB
references/browser-rendering/patterns.mdmarkdown1.5 KB
references/c3/README.mdmarkdown3.6 KB
references/c3/api.mdmarkdown2.2 KB
references/c3/configuration.mdmarkdown1.6 KB
references/c3/gotchas.mdmarkdown2.3 KB
references/c3/patterns.mdmarkdown2.1 KB
references/containers/README.mdmarkdown1.9 KB
references/containers/api.mdmarkdown1.6 KB
references/containers/configuration.mdmarkdown1.8 KB
references/containers/gotchas.mdmarkdown2.4 KB
references/containers/patterns.mdmarkdown2.5 KB
references/cron-triggers/README.mdmarkdown1.5 KB
references/cron-triggers/api.mdmarkdown1.7 KB
references/cron-triggers/configuration.mdmarkdown1.7 KB
references/cron-triggers/gotchas.mdmarkdown2.3 KB
references/cron-triggers/patterns.mdmarkdown2.0 KB
references/d1/README.mdmarkdown1.4 KB
references/d1/api.mdmarkdown1.9 KB
references/d1/configuration.mdmarkdown1.9 KB
references/d1/gotchas.mdmarkdown2.2 KB
references/d1/patterns.mdmarkdown2.2 KB
references/hyperdrive/README.mdmarkdown2.1 KB
references/hyperdrive/api.mdmarkdown3.1 KB
references/hyperdrive/configuration.mdmarkdown3.2 KB
references/hyperdrive/gotchas.mdmarkdown3.4 KB
references/hyperdrive/patterns.mdmarkdown2.7 KB
references/images/README.mdmarkdown983 B
references/images/api.mdmarkdown1.6 KB
references/images/configuration.mdmarkdown2.1 KB
references/images/gotchas.mdmarkdown2.2 KB
references/images/patterns.mdmarkdown1.8 KB
references/kv/README.mdmarkdown1.5 KB
references/kv/api.mdmarkdown1.8 KB
references/kv/configuration.mdmarkdown1.7 KB
references/kv/gotchas.mdmarkdown2.4 KB
references/kv/patterns.mdmarkdown2.9 KB
references/miniflare/README.mdmarkdown1.6 KB
references/miniflare/api.mdmarkdown1.8 KB
references/miniflare/configuration.mdmarkdown2.1 KB
references/miniflare/gotchas.mdmarkdown2.3 KB
references/miniflare/patterns.mdmarkdown2.2 KB
references/observability/README.mdmarkdown2.5 KB
references/observability/api.mdmarkdown2.2 KB
references/observability/configuration.mdmarkdown2.5 KB
references/observability/gotchas.mdmarkdown3.7 KB
references/observability/patterns.mdmarkdown3.0 KB
references/pages-functions/README.mdmarkdown1.3 KB
references/pages-functions/api.mdmarkdown1.1 KB
references/pages-functions/configuration.mdmarkdown1.3 KB
references/pages-functions/gotchas.mdmarkdown1.6 KB
references/pages-functions/patterns.mdmarkdown1.4 KB
references/pages/README.mdmarkdown1.5 KB
references/pages/api.mdmarkdown1.1 KB
references/pages/configuration.mdmarkdown1.5 KB
references/pages/gotchas.mdmarkdown1.7 KB
references/pages/patterns.mdmarkdown1.2 KB
references/queues/README.mdmarkdown1.8 KB
references/queues/api.mdmarkdown1.8 KB
references/queues/configuration.mdmarkdown2.3 KB
references/queues/gotchas.mdmarkdown2.8 KB
references/queues/patterns.mdmarkdown2.6 KB
references/r2/README.mdmarkdown1.7 KB
references/r2/api.mdmarkdown1.7 KB
references/r2/configuration.mdmarkdown2.2 KB
references/r2/gotchas.mdmarkdown3.3 KB
references/r2/patterns.mdmarkdown2.2 KB
references/secrets-store/README.mdmarkdown1.8 KB
references/secrets-store/api.mdmarkdown1.9 KB
references/secrets-store/configuration.mdmarkdown2.4 KB
references/secrets-store/gotchas.mdmarkdown2.8 KB
references/secrets-store/patterns.mdmarkdown3.0 KB
references/skill-feedback.mdmarkdown2.7 KB
references/smart-placement/README.mdmarkdown5.0 KB
references/smart-placement/api.mdmarkdown5.4 KB
references/smart-placement/configuration.mdmarkdown6.0 KB
references/smart-placement/gotchas.mdmarkdown5.5 KB
references/smart-placement/patterns.mdmarkdown5.6 KB
references/static-assets/README.mdmarkdown1.7 KB
references/static-assets/api.mdmarkdown1.7 KB
references/static-assets/configuration.mdmarkdown2.1 KB
references/static-assets/gotchas.mdmarkdown2.7 KB
references/static-assets/patterns.mdmarkdown2.2 KB
references/stream/README.mdmarkdown1.8 KB
references/stream/api-live.mdmarkdown2.1 KB
references/stream/api.mdmarkdown2.4 KB
references/stream/configuration.mdmarkdown2.0 KB
references/stream/gotchas.mdmarkdown2.3 KB
references/stream/patterns.mdmarkdown2.3 KB
references/tail-workers/README.mdmarkdown1.4 KB
references/tail-workers/api.mdmarkdown1.4 KB
references/tail-workers/configuration.mdmarkdown1.4 KB
references/tail-workers/gotchas.mdmarkdown1.6 KB
references/tail-workers/patterns.mdmarkdown1.5 KB
references/tunnel/README.mdmarkdown1.5 KB
references/tunnel/api.mdmarkdown1.3 KB
references/tunnel/configuration.mdmarkdown1.3 KB
references/tunnel/gotchas.mdmarkdown1.5 KB
references/tunnel/networking.mdmarkdown1.5 KB
references/tunnel/patterns.mdmarkdown1.5 KB
references/vectorize/README.mdmarkdown2.1 KB
references/vectorize/api.mdmarkdown2.1 KB
references/vectorize/configuration.mdmarkdown2.1 KB
references/vectorize/gotchas.mdmarkdown2.4 KB
references/vectorize/patterns.mdmarkdown2.6 KB
references/waf/README.mdmarkdown1.6 KB
references/waf/api.mdmarkdown2.0 KB
references/waf/configuration.mdmarkdown1.9 KB
references/waf/gotchas.mdmarkdown2.3 KB
references/waf/patterns.mdmarkdown1.9 KB
references/workers-ai/README.mdmarkdown1.8 KB
references/workers-ai/api.mdmarkdown1.3 KB
references/workers-ai/configuration.mdmarkdown1.6 KB
references/workers-ai/gotchas.mdmarkdown1.9 KB
references/workers-ai/patterns.mdmarkdown1.7 KB
references/workflows/README.mdmarkdown1.8 KB
references/workflows/api.mdmarkdown1.8 KB
references/workflows/configuration.mdmarkdown2.0 KB
references/workflows/gotchas.mdmarkdown2.8 KB
references/workflows/patterns.mdmarkdown2.7 KB

references/smart-placement/configuration.md

View on GitHub
# Smart Placement Configuration

## wrangler.jsonc Setup

```jsonc
{
  "$schema": "./node_modules/wrangler/config-schema.json",
  "placement": {
    "mode": "smart"
  }
}
```

## Placement Mode Values

| Mode | Behavior |
|------|----------|
| `"smart"` | Enable Smart Placement - automatic optimization based on traffic analysis |
| `"off"` | Explicitly disable Smart Placement - always run at edge closest to user |
| Not specified | Default behavior - run at edge closest to user (same as `"off"`) |

**Note:** Smart Placement vs Explicit Placement are separate features. Smart Placement (`mode: "smart"`) uses automatic analysis. For manual placement control, see explicit placement options (`region`, `host`, `hostname` fields - not covered in this reference).

## Frontend + Backend Split Configuration

### Frontend Worker (No Smart Placement)

```jsonc
// frontend-worker/wrangler.jsonc
{
  "name": "frontend",
  "main": "frontend-worker.ts",
  // No "placement" - runs at edge
  "services": [
    {
      "binding": "BACKEND",
      "service": "backend-api"
    }
  ]
}
```

### Backend Worker (Smart Placement Enabled)

```jsonc
// backend-api/wrangler.jsonc
{
  "name": "backend-api",
  "main": "backend-worker.ts",
  "placement": {
    "mode": "smart"
  },
  "d1_databases": [
    {
      "binding": "DATABASE",
      "database_id": "xxx"
    }
  ]
}
```

## Requirements & Limitations

### Requirements
- **Wrangler version:** 2.20.0+
- **Analysis time:** Up to 15 minutes
- **Traffic requirements:** Consistent multi-location traffic
- **Workers plan:** All plans (Free, Paid, Enterprise)

### What Smart Placement Affects

**CRITICAL LIMITATION - Smart Placement ONLY Affects `fetch` Handlers:**

Smart Placement is fundamentally limited to Workers with default `fetch` handlers. This is a key architectural constraint.

- ✅ **Affects:** `fetch` event handlers ONLY (the default export's fetch method)
- ❌ **Does NOT affect:** 
  - RPC methods (Service Bindings with `WorkerEntrypoint` - see example below)
  - Named entrypoints (exports other than `default`)
  - Workers without `fetch` handlers
  - Queue consumers, scheduled handlers, or other event types

**Example - Smart Placement ONLY affects `fetch`:**
```typescript
// ✅ Smart Placement affects this:
export default {
  async fetch(request: Request, env: Env): Promise<Response> {
    // This runs close to backend when Smart Placement enabled
    const data = await env.DATABASE.prepare('SELECT * FROM users').all();
    return Response.json(data);
  }
}

// ❌ Smart Placement DOES NOT affect these:
export class MyRPC extends WorkerEntrypoint {
  async myMethod() { 
    // This ALWAYS runs at edge, Smart Placement has NO EFFECT
    const data = await this.env.DATABASE.prepare('SELECT * FROM users').all();
    return data;
  }
}

export async function scheduled(event: ScheduledEvent, env: Env) {
  // NOT affected by Smart Placement
}
```

**Consequence:** If your backend logic uses RPC methods (`WorkerEntrypoint`), Smart Placement cannot optimize those calls. You must use fetch-based patterns for Smart Placement to work.

**Solution:** Convert RPC methods to fetch endpoints, or use a wrapper Worker with `fetch` handler that calls your backend RPC (though this adds latency).

### Baseline Traffic
Smart Placement automatically routes 1% of requests WITHOUT optimization as baseline for performance comparison.

### Validation Rules

**Mutually exclusive fields:**
- `mode` cannot be used with explicit placement fields (`region`, `host`, `hostname`)
- Choose either Smart Placement OR explicit placement, not both

```jsonc
// ✅ Valid - Smart Placement
{ "placement": { "mode": "smart" } }

// ✅ Valid - Explicit Placement (different feature)
{ "placement": { "region": "us-east1" } }

// ❌ Invalid - Cannot combine
{ "placement": { "mode": "smart", "region": "us-east1" } }
```

## Dashboard Configuration

**Workers & Pages** → Select Worker → **Settings** → **General** → **Placement: Smart** → Wait 15min → Check **Metrics**

## TypeScript Types

```typescript
interface Env {
  BACKEND: Fetcher;
  DATABASE: D1Database;
}

export default {
  async fetch(request: Request, env: Env): Promise<Response> {
    const data = await env.DATABASE.prepare('SELECT * FROM table').all();
    return Response.json(data);
  }
} satisfies ExportedHandler<Env>;
```

## Cloudflare Pages/Assets Warning

**CRITICAL PERFORMANCE ISSUE:** Enabling Smart Placement with `assets.run_worker_first = true` in Pages projects **severely degrades asset serving performance**. This is one of the most common misconfigurations.

**Why this is bad:**
- Smart Placement routes ALL requests (including static assets) away from edge to remote locations
- Static assets (HTML, CSS, JS, images) should ALWAYS be served from edge closest to user
- Result: 2-5x slower asset loading times, poor user experience

**Problem:** Smart Placement routes asset requests away from edge, but static assets should always be served from edge closest to user.

**Solutions (in order of preference):**
1. **Recommended:** Split into separate Workers (frontend at edge + backend with Smart Placement)
2. Set `"mode": "off"` to explicitly disable Smart Placement for Pages/Assets Workers
3. Use `assets.run_worker_first = false` (serves assets first, bypasses Worker for static content)

```jsonc
// ❌ BAD - Degrades asset performance by 2-5x
{
  "name": "pages-app",
  "placement": { "mode": "smart" },
  "assets": { "run_worker_first": true }
}

// ✅ GOOD - Frontend at edge, backend optimized
// frontend-worker/wrangler.jsonc
{
  "name": "frontend",
  "assets": { "run_worker_first": true }
  // No placement - runs at edge
}

// backend-worker/wrangler.jsonc
{
  "name": "backend-api",
  "placement": { "mode": "smart" },
  "d1_databases": [{ "binding": "DB", "database_id": "xxx" }]
}
```

**Key takeaway:** Never enable Smart Placement on Workers that serve static assets with `run_worker_first = true`.

## Local Development

Smart Placement does NOT work in `wrangler dev` (local only). Test by deploying: `wrangler deploy --env staging`
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall