Hono: The Ultra-Fast Web Framework for Edge, Bun, Deno, and Node

import { Hono } from "hono";

const app = new Hono();

app.get("/users/:id", (c) => {
  const id = c.req.param("id");
  return c.json({ id });
});

app.post("/users", async (c) => {
  const body = await c.req.json();
  return c.json({ created: body }, 201);
});

export default app;

pnpm create cloudflare my-api --template hono
cd my-api

// src/index.ts
import { Hono } from "hono";
import { cors } from "hono/cors";
import { logger } from "hono/logger";

type Bindings = {
  DB: D1Database;
  BUCKET: R2Bucket;
};

const app = new Hono<{ Bindings: Bindings }>();

app.use("*", logger());
app.use("/api/*", cors({ origin: "https://yoursite.com" }));

app.get("/api/posts", async (c) => {
  const posts = await c.env.DB.prepare("SELECT * FROM posts ORDER BY created_at DESC").all();
  return c.json(posts.results);
});

export default app;

wrangler deploy

import { jwt } from "hono/jwt";
import { rateLimiter } from "hono/rate-limiter";
import { zValidator } from "@hono/zod-validator";
import { z } from "zod";

app.use("/protected/*", jwt({ secret: process.env.JWT_SECRET! }));

const createPost = z.object({
  title: z.string().min(1),
  body: z.string(),
});

app.post("/posts", zValidator("json", createPost), async (c) => {
  const data = c.req.valid("json"); // fully typed
  return c.json({ ok: true });
});

// server: api/routes.ts
const routes = app
  .get("/users", (c) => c.json({ users: [] as User[] }))
  .post("/users", zValidator("json", createUser), (c) => c.json({ id: "123" }));

export type AppType = typeof routes;

// client: lib/api.ts
import { hc } from "hono/client";
import type { AppType } from "@/api/routes";

const client = hc<AppType>("https://api.example.com");

// Fully typed  -  autocomplete works
const res = await client.users.$get();
const { users } = await res.json(); // User[]

// Bun
import { Hono } from "hono";
const app = new Hono();
// ... routes
export default { port: 3000, fetch: app.fetch };

// Node.js
import { serve } from "@hono/node-server";
import { Hono } from "hono";
const app = new Hono();
// ... routes
serve({ fetch: app.fetch, port: 3000 });