Skip to content
Alchemy
GitHubXDiscord

Redwood

This guide shows how to initialize and deploy a RedwoodJS application to Cloudflare using Alchemy.

Init

Section titled “Init”

Start by creating a new Redwood project with Alchemy:

Terminal window
bunx alchemy create my-redwood-app --template=rwsdk
cd my-redwood-app

Login

Section titled “Login”

Authenticate once with your Cloudflare account:

Terminal window
bun wrangler login

Deploy

Section titled “Deploy”

Run the deploy script generated by the template:

Terminal window
bun run deploy

You’ll get the live URL of your Redwood application:

Terminal window
{
  url: "https://website.<your-account>.workers.dev",
}

Local Development

Section titled “Local Development”

Work locally using the dev script:

Terminal window
bun run dev

Destroy

Section titled “Destroy”

Clean up all Cloudflare resources created by this stack:

Terminal window
bun run destroy

What files are created

Section titled “What files are created”

.env

Section titled “.env”

Alchemy requires a locally set password to encrypt Secrets that are stored in state. Be sure to change this.

ALCHEMY_PASSWORD=change-me

alchemy.run.ts

Section titled “alchemy.run.ts”
/// <reference types="@types/node" />
import alchemy from "alchemy";
import {
  D1Database,
  DurableObjectNamespace,
  Redwood,
} from "alchemy/cloudflare";


const app = await alchemy("my-redwood-app");


const database = await D1Database("database", {
  name: "my-redwood-app-db",
  migrationsDir: "drizzle",
});


export const worker = await Redwood("website", {
  name: "my-redwood-app-website",
  command: "bun run build",
  bindings: {
    AUTH_SECRET_KEY: alchemy.secret(process.env.AUTH_SECRET_KEY),
    DB: database,
    SESSION_DURABLE_OBJECT: new DurableObjectNamespace("session", {
      className: "SessionDurableObject",
    }),
  },
});


console.log({
  url: worker.url,
});


await app.finalize();

types/env.d.ts

Section titled “types/env.d.ts”
// Auto-generated Cloudflare binding types.
// @see https://alchemy.run/concepts/bindings/#type-safe-bindings


import type { worker } from "../alchemy.run.ts";


export type CloudflareEnv = typeof worker.Env;


declare global {
  type Env = CloudflareEnv;
}


declare module "cloudflare:workers" {
  namespace Cloudflare {
    export interface Env extends CloudflareEnv {}
  }
}

tsconfig.json

Section titled “tsconfig.json”

The CLI updated the tsconfig.json to include alchemy.run.ts and register @cloudflare/workers-types + types/env.d.ts globally

{
  "compilerOptions": {
    "target": "ES2022",
    "lib": ["ES2022"],
    "module": "ES2022",
    "moduleResolution": "bundler",
    "strict": true,
    "skipLibCheck": true,
    "types": ["@cloudflare/workers-types", "./types/env.d.ts"]
  },
  "include": ["types/**/*.ts", "alchemy.run.ts", "src/**/*.ts"]
}