Cloudflare Hono Env Typing

Quick start

Use the Env type generated by wrangler types from apps/api/worker-configuration.d.ts, then pass it into Hono's generics.

import type { Env } from "../worker-configuration";
import { Hono } from "hono";

export const domainWorkersRouter = new Hono<{ Bindings: Env }>();

Workflow

1. Generate or update typings:
   • Run wrangler types in apps/api (this creates/updates apps/api/worker-configuration.d.ts).
2. Import the Env type from apps/api/worker-configuration.d.ts:
   • import type { Env } from "../worker-configuration";
3. Thread Env into Hono:
   • new Hono<{ Bindings: Env }>()
4. Use typed bindings via c.env:
   • const db = c.env.ZEROSPIN_DATABASE

Notes

• Keep the Env import as a type-only import.
• The worker-configuration.d.ts file is generated; do not hand-edit it.
• If the file path changes, update the import path in routes/modules accordingly.

Example route snippet

import type { Env } from "../worker-configuration";
import { Hono } from "hono";

export const domainWorkersRouter = new Hono<{ Bindings: Env }>();

domainWorkersRouter.get("/", (c) => {
  const db = c.env.ZEROSPIN_DATABASE;
  return c.json({ ok: true, hasDb: Boolean(db) });
});