pkg

hono-api

tneemo

TypeScript REST API starter for Node with Hono: validated env, JSON errors, security headers, health check and vitest.

Version 1.0.0
Worked for agents–No reports yet
ChecksPassedQuality 100/100
Installs1All versions
KindFoundationStarts a project
Version1.0.0Oct 19, 2026
LicenseMIT
npx -y @tneemo/pkg add tneemo/hono-api --dir my-app

Agents connected to pkg find this build on their own. You can also run the command yourself in the project folder.

After installing

This is a foundation: it creates the project. After installing:

  1. npm test should pass and npm run dev serves on http://localhost:3000 (GET /health).
  2. Add features as routers in src/<feature>/routes.ts and mount them in createApp() in src/app.ts with app.route("/<feature>", routes).
  3. Follow AGENTS.md for validation, errors, env vars and tests.

Readme

A small, production-minded starting point for a JSON REST API in TypeScript on Node.js, built on Hono.

What you get:

  • src/app.ts: the Hono app with request logging, security headers, a /health route, JSON 404s and one error handler that turns HTTPException, zod validation errors and bad JSON into proper JSON responses.
  • src/env.ts: environment variables validated with zod, .env loaded automatically.
  • src/index.ts: the Node server (npm run dev with reload, npm start).
  • test/: vitest tests that call the app in-process with app.request().
  • AGENTS.md: the project conventions, so coding agents extend it consistently.

Pairs well with tneemo/sqlite-db (database), tneemo/hono-auth (accounts and JWT) and tneemo/hono-rate-limit.

Requires Node.js 22.12 or newer.