CRUD generator for Hono with Zod validation and OpenAPI generation
npm install hono-crud
A powerful CRUD generator for Hono with Zod validation and automatic OpenAPI documentation.
- Full CRUD Operations - Automatically generate Create, Read, Update, Delete endpoints
- OpenAPI/Swagger - Auto-generated API documentation with Swagger UI and Scalar support
- Database Adapters - Built-in support for Prisma, Drizzle ORM, and in-memory storage
- Zod Validation - Type-safe request/response validation
- TypeScript First - Full type inference and autocompletion
- Edge Ready - Works with Cloudflare Workers, Deno, Bun, and Node.js
- Customizable - Override any generated route or add custom middleware
``bashnpm
npm install hono-crud
Quick Start
typescript
import { Hono } from "hono";
import { HonoCrud } from "hono-crud";
import { MemoryAdapter } from "hono-crud/adapters/memory";
import { z } from "zod";const app = new Hono();
// Define your schema
const UserSchema = z.object({
id: z.string(),
name: z.string(),
email: z.string().email(),
});
// Create CRUD instance
const crud = new HonoCrud({
adapter: new MemoryAdapter(),
});
// Register resource
crud.resource("users", {
schema: UserSchema,
});
// Mount to your app
app.route("/api", crud.routes());
export default app;
`Database Adapters
$3
Perfect for prototyping and testing:
typescript
import { MemoryAdapter } from "hono-crud/adapters/memory";const adapter = new MemoryAdapter();
`$3
For production use with Drizzle ORM:
typescript
import { DrizzleAdapter } from "hono-crud/adapters/drizzle";
import { db } from "./db";
import { users } from "./schema";const adapter = new DrizzleAdapter(db, {
users: users,
});
`$3
For production use with Prisma:
typescript
import { PrismaAdapter } from "hono-crud/adapters/prisma";
import { PrismaClient } from "@prisma/client";const prisma = new PrismaClient();
const adapter = new PrismaAdapter(prisma);
`API Documentation
OpenAPI documentation is automatically generated. Access it at:
- Swagger UI:
- Scalar:
- OpenAPI JSON: Authentication with better-auth
hono-crud integrates seamlessly with better-auth for comprehensive authentication.
$3
1. Mount better-auth handler for authentication routes:
typescript
import { Hono } from "hono";
import { auth } from "./auth"; // your better-auth instance
import { cors } from "hono/cors";const app = new Hono<{
Variables: {
user: typeof auth.$Infer.Session.user | null;
session: typeof auth.$Infer.Session.session | null;
};
}>();
// CORS (must be before routes)
app.use("/api/auth/*", cors({
origin: "http://localhost:3000",
credentials: true,
}));
// Mount better-auth
app.on(["POST", "GET"], "/api/auth/*", (c) => auth.handler(c.req.raw));
`2. Add session middleware to inject user into context:
typescript
app.use("*", async (c, next) => {
const session = await auth.api.getSession({ headers: c.req.raw.headers });
c.set("user", session?.user || null);
c.set("session", session?.session || null);
await next();
});
`3. Protect CRUD routes with hono-crud guards:
typescript
import { registerCrud, requireAuth, requireRoles } from "hono-crud";registerCrud(app, "/api/users", {
list: UserList,
read: UserRead,
update: UserUpdate,
delete: UserDelete,
}, {
middlewares: [requireAuth()],
endpointMiddlewares: {
delete: [requireRoles(["admin"])],
},
});
`$3
Request → CORS → Session MW → Auth Guards → CRUD Endpoint
↓
better-auth
(validates session)
- better-auth handles: login, signup, OAuth, 2FA, session management
- hono-crud handles: CRUD operations with authorization guards
Check out the examples directory for complete working examples:
- Memory Adapter Examples
- Drizzle Examples
- Prisma Examples
- Node.js >= 18.0.0
- TypeScript >= 5.0 (recommended)
MIT - Kauan Guesser