Hono Basics

10 examples to build APIs with Hono on Node.js - 7 basic and 3 intermediate.

Prerequisites

mkdir hono-api && cd hono-api
npm init -y
npm pkg set type=module
npm install hono @hono/node-server
npm install -D typescript@5.6 tsx

For runtime portability decisions, see Hono on Node vs Edge.

Basic Examples

1. Hello World on Node

import { Hono } from "hono";
import { serve } from "@hono/node-server";
 
const app = new Hono();
 
app.get("/", (c) => c.text("Hello from Hono\n"

c is the Context object with helpers for response types
app.fetch is a Web Standard fetch handler
@hono/node-server bridges Hono to Node HTTP

2. JSON Response

import { Hono } from "hono";
 
const app = new Hono();
 
app.get("/users", (c) => {
  return c.json([{ id: 1, name: "Ada Lovelace" }]);
});

c.json() sets Content-Type: application/json
Return the Response directly from handlers

3. Route Parameters and Query

import { Hono } from "hono";
 
const app = new Hono();
 
app.get("/users/:id", (c) => {
  const id = c.req.param("id");
  const include

c.req.param() for path params
c.req.query() for query strings

4. POST with JSON Body

import { Hono } from "hono";
 
const app = new Hono();
 
app.post("/users", async (c) => {
  const body = await c.req.json<{ name:

c.req.json() parses body asynchronously
Status code as second argument to c.json()

5. Middleware

import { Hono } from "hono";
import { logger } from "hono/logger";
 
const app = new Hono();
 
app.use("*", logger());
app.use("/api/*", async (

app.use(path, middleware) for path-scoped middleware
await next() to continue the chain
Built-in logger() middleware for request logging

6. Route Groups

import { Hono } from "hono";
 
const users = new Hono();
users.get("/", (c) => c.json([]));
users.get("/:id", (c) => c.

app.route(prefix, subApp) mounts route groups
Each sub-app is an independent Hono instance

7. Error Handling

import { Hono } from "hono";
import { HTTPException } from "hono/http-exception";
 
const app = new Hono();
 
app.get("/users/:id", (c) => {
  const id = c.req.param

HTTPException for operational errors with status codes
app.onError() for centralized error handling

Intermediate Examples

8. Typed Context Variables

import { Hono } from "hono";
import { createMiddleware } from "hono/factory";
 
type Variables = { userId: string };
 
const app = new Hono<{ Variables: Variables }>();
 
const

Generic Variables type for c.set() / c.get()
createMiddleware for typed middleware factories

9. CORS and Security

import { Hono } from "hono";
import { cors } from "hono/cors";
import { secureHeaders } from "hono/secure-headers";
 
const app = new Hono();
app.use("*", cors({ origin: "https://app.example.com" }));

Built-in CORS and security headers middleware
No external helmet dependency needed

10. Validation with Zod

import { Hono } from "hono";
import { zValidator } from "@hono/zod-validator";
import { z } from "zod";
 
const app = new Hono();
 
const schema = z.object({
  name: z.string

@hono/zod-validator integrates Zod with Hono
c.req.valid("json") returns typed, validated data

FAQs

When should I choose Hono over Express or Fastify?

Hono for edge portability, tiny footprint, or Web Standards alignment. Express/Fastify for larger Node ecosystem. See Framework Selection Checklist.

Does Hono work on Node 24?

Yes via @hono/node-server. Same Hono code can deploy to Cloudflare Workers.

Is Hono production-ready?

Yes. Used in production on Cloudflare Workers and Node. Smaller ecosystem than Express/Fastify.

How does Hono compare in size?

~14KB minified vs Express ~200KB+ with middleware. Matters for edge cold starts.

Can I use Hono with TypeScript?

First-class TypeScript support with typed context, validators, and route params.

Hono on Node vs Edge - runtime ADR
Koa & Polka - other lightweight options
Express Basics - mainstream alternative
Framework Selection Checklist - decision matrix
Lightweight Frameworks Best Practices - section checklist

Stack versions: This page was written for Node.js 24.18.0 (Active LTS), npm 10+, TypeScript 5.6+, Express 5, Fastify 5, and NestJS 11.

Search Documentation

Hono Basics