Skip to main content

Introduction

Honocube is a lightweight, type-safe resource framework built on top of Hono and Drizzle ORM. It allows you to rapidly build robust RESTful APIs with minimal boilerplate while maintaining full control over your business logic.

Motivation​

Building APIs often involves repetitive tasks: setting up CRUD endpoints, handling pagination, filtering, searching, file uploads, and permissions. Honocube abstracts these patterns into a declarative "Resource" model, allowing you to focus on what makes your application unique.

Key Features​

  • 🔋 Battery-included CRUD: Automatic list, detail, create, update, and delete endpoints.
  • 🛡️ Type Safety: End-to-end TypeScript support with Zod validation.
  • 🔌 Adapter Architecture: Currently optimized for Drizzle ORM, with a flexible base for other adapters.
  • 📁 Integrated Uploads: Seamlessly handle file uploads and associate them with your records.
  • 🔐 Granular Auth: Declarative permission strings and functional Row-Level Security (RLS).
  • 🚀 Performance: Built on Hono, the fastest web framework for the edge.
  • 📦 Relations & Pivots: First-class support for one-to-one, one-to-many, and many-to-many (pivot) relationships.
  • 🔍 Advanced Querying: Built-in support for search, filtering, and pagination.

Architecture at a Glance​

Honocube operates on three main levels:

  1. App Config (createApp): Define global behaviors like database adapters, storage providers, authentication logic, and global middleware.
  2. Resources (defineResource): Define a single entity (e.g., "Users", "Posts") with its schema, validators, hooks, and relationships.
  3. API Gateway (defineApi): Group multiple resources into a versioned API.

Ready to jump in? Get started with the installation.