Deploy to Cloudflare

This walkthrough takes a better-router app from vite dev to a Cloudflare Worker with bindings on env.

1. Point Wrangler at the build

wrangler.jsonc

{
  "name": "my-app",
  "compatibility_date": "2026-09-01",
  "compatibility_flags": ["nodejs_compat"],
  "main": "./dist/server/index.js",
  "assets": {
    "directory": "./dist/client"
  }
}

nodejs_compat is required for getEnv(). Static files from dist/client are served in front of the Worker. The plugin sees Wrangler and sets target: "cloudflare".

2. Bindings

Add whatever Cloudflare products you need. They show up on getEnv() / c.env during fetch.

wrangler.jsonc

{
  "vars": {
    "APP_URL": "https://example.com"
  },
  "d1_databases": [
    { "binding": "DB", "database_name": "app", "database_id": "<id>" }
  ]
}

src/env.d.ts

declare module "better-router" {
  interface AppBindings {
    DB: D1Database;
    APP_URL: string;
  }
}

src/routes/index.server.tsx

import { getEnv } from "better-router";

export async function loader() {
  const { DB, APP_URL } = getEnv();
  const { results } = await DB.prepare("select 1 as ok").all();
  return { appUrl: APP_URL, ok: results };
}

Secrets:

npx wrangler secret put STRIPE_SECRET

Local Wrangler secrets go in .dev.vars. Full list of binding kinds: Bindings.

3. Worker entrypoint

fetch is the Hono app. Add cron, queue, or inbound email in src/worker.ts:

src/worker.ts

import { defineWorker } from "better-router/worker";

export default defineWorker({
  async scheduled(event, env) {
    await (env.DB as D1Database)
      .prepare("insert into heartbeats (at) values (?)")
      .bind(event.scheduledTime)
      .run();
  },
});

List the same cron in Wrangler:

{
  "triggers": {
    "crons": ["*/5 * * * *"]
  }
}

Details: Worker entrypoint.

4. Deploy

npx vite build
npx wrangler deploy

After deploy:

/ is SSR HTML with /assets/client.js
/api/hello is JSON from Hono
getEnv().DB is the D1 binding on Worker requests
scheduled runs when Cloudflare fires the cron

vite dev serves HTTP only. Use wrangler dev after a build when you need Miniflare bindings. A complete D1 + queue + cron app is in examples/cloudflare.

Get started

Routing

Rendering

Deploy

Guides

Reference

1. Point Wrangler at the build

2. Bindings

3. Worker entrypoint

4. Deploy

​1. Point Wrangler at the build

​2. Bindings

​3. Worker entrypoint

​4. Deploy

1. Point Wrangler at the build

2. Bindings

3. Worker entrypoint

4. Deploy