Repo brief: honojs/hono

Generated by RepoPilot · document generated 2026-09-16 · concise human review Evidence snapshot · analyzed 2026-09-16T18:29:30.345Z · commit eebdf7be39ab

Verdict

Healthy — Strong maintenance signals

• In RepoPilot's curated trusted-corpus (29 projects)
• Last commit 1d ago
• 27+ active contributors
• Distributed ownership (top contributor 36% of recent commits)
• 3 more receipts on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against dependency CVEs from deps.dev and OpenSSF Scorecard

What it is

Hono is a lightweight, multi-runtime web framework built on Web Standards that runs on Cloudflare Workers, Deno, Bun, AWS Lambda, Node.js, and other JavaScript environments. It prioritizes speed (RegExpRouter pattern), tiny bundle size (hono/tiny under 12kB), and zero dependencies while providing first-class TypeScript support and built-in middleware. Monorepo structure: src/adapter/ contains runtime-specific adapters (aws-lambda/, cloudflare-workers/, deno/, bun/, netlify/, service-worker/) each with handler.ts, conninfo.ts, and websocket.ts files following a consistent pattern. Core framework logic is at src/ root level. Build output goes to dist/ (both ESM and CommonJS). Runtime tests…

Start here

Read these in order:

• src/router.ts — Foundation: doesn't import anything internally and is imported by 15 other files. Read first to learn the vocabulary.
• src/jsx/constants.ts — Foundation: imported by 13, no internal dependencies of its own.
• src/http-exception.ts — Built on the foundation; imported by 12 downstream files.
• src/helper/html/index.ts — Built on the foundation; imported by 9 downstream files.
• src/utils/buffer.ts — Layer 2 — composes lower-level code into reusable abstractions (imported 4×).

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/honojs/hono.git
cd hono
bun install
bun run test

Verify Node.js/Bun are installed, then consult package.json scripts for runtime-specific setup (test:deno requires Deno, test:bun requires Bun, etc.).

Daily commands:

bun run test              # Unit tests across adapters
bun run test:watch       # Watch mode
bun run test:deno        # Deno runtime tests
bun run test:bun         # Bun runtime tests
bun run test:node        # Node.js runtime tests
bun run test:all         # Full suite (Node + Deno + Bun)
bun run build            # Compile TypeScript to dist/

Key cautions & unknowns

• Scorecard: default branch unprotected (0/10)
• Each runtime adapter may have different WebSocket, connection-info (conninfo.ts), and static-file-serving implementations — code relying on these features must be tested in the target runtime. TypeScript compilation…
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.