Cloudflare provider

Deploy Workers, Durable Objects, databases, and edge infrastructure on Cloudflare

The Cloudflare provider enables you to deploy and manage Cloudflare Workers, Durable Objects, databases, storage, and other edge infrastructure using TypeScript.

Installation

The Cloudflare provider is included in the main alchemy package:

npm

npm install alchemy

Credentials

Set up your Cloudflare credentials as environment variables:

export CLOUDFLARE_API_TOKEN="your-api-token"
export CLOUDFLARE_ACCOUNT_ID="your-account-id"

Create an API token at dash.cloudflare.com/profile/api-tokens with the Edit Cloudflare Workers template.

Available resources

Compute

• Worker - Deploy JavaScript/TypeScript Workers
• DurableObjectNamespace - Stateful compute with strong consistency
• Workflow - Orchestrate long-running tasks
• Container - Deploy containerized applications

Storage

• R2Bucket - Object storage compatible with S3
• KVNamespace - Low-latency key-value storage
• D1Database - Serverless SQLite databases
• Vectorize - Vector database for AI applications

Messaging & Queues

• Queue - Message queues for async processing
• DispatchNamespace - RPC between Workers

AI & ML

• AiSearch - RAG and semantic search
• Ai - Access Cloudflare AI models

Networking

• CustomDomain - Custom domains for Workers
• Hyperdrive - Database connection pooling
• Tunnel - Secure tunnels to your origin
• Route - HTTP routing rules

Security

• ApiShield - API security and validation
• RateLimit - Rate limiting rules

Example usage

Here’s a complete example deploying a Worker with Durable Objects, R2 storage, and a Queue:

import alchemy from "alchemy";
import {
  Worker,
  DurableObjectNamespace,
  R2Bucket,
  Queue,
  D1Database,
} from "alchemy/cloudflare";

const app = await alchemy("cloudflare-app");

// Storage
const bucket = await R2Bucket("storage", {
  name: `${app.name}-${app.stage}-storage`,
});

const db = await D1Database("db", {
  name: `${app.name}-${app.stage}-db`,
});

// Queue for async processing
const queue = await Queue<{ userId: string; action: string }>("tasks", {
  name: `${app.name}-${app.stage}-tasks`,
});

// Durable Object for stateful compute
const sessions = await DurableObjectNamespace("sessions", {
  className: "SessionManager",
  script: "./src/durable-objects.ts",
});

// Worker
const worker = await Worker("api", {
  name: `${app.name}-${app.stage}-api`,
  entrypoint: "./src/worker.ts",
  bindings: {
    BUCKET: bucket,
    DB: db,
    QUEUE: queue,
    SESSIONS: sessions,
  },
  url: true, // Enable workers.dev subdomain
  eventSources: [
    {
      queue,
      settings: {
        batchSize: 10,
        maxWaitTimeMs: 5000,
      },
    },
  ],
});

console.log(`Worker URL: ${worker.url}`);

await app.finalize();

Local development

Cloudflare resources support local development mode using Miniflare:

const app = await alchemy("my-app", {
  local: true, // Enable local mode
});

// Resources run locally with Miniflare
const worker = await Worker("worker", {
  entrypoint: "./src/index.ts",
  bindings: {
    // Local bindings work the same way
  },
});

// Access via localhost
console.log(`Local URL: http://localhost:${worker.port}`);

See the Local Development guide for more details.

Framework integrations

Alchemy provides plugins for popular web frameworks:

• Vite - Deploy Vite applications
• Astro - Deploy Astro sites
• Next.js - Deploy Next.js applications
• Nuxt - Deploy Nuxt applications
• SvelteKit - Deploy SvelteKit apps
• React Router - Deploy React Router v7
• RedwoodJS - Deploy Redwood applications
• TanStack Start - Deploy TanStack Start apps

Next steps

Worker API

Deploy Cloudflare Workers

Durable Objects

Stateful serverless compute

Examples

Browse Cloudflare examples

Framework integrations

Deploy web frameworks