Kumiko Documentation

New here?

Run the Quickstart first, scaffold, login on default chrome, re-skin with styles.css, then click Tasks. Come back here for the big picture. Not sure which route fits your goal? Start with the Learning paths.

Declare a feature in TypeScript, get a Postgres table, typed API, access control, and admin UI.

Kumiko is a code-first framework for building multi-tenant business apps : internal tools, SaaS back-offices, admin panels. You declare a feature, its data, its rules, its screens, in one TypeScript file, and Kumiko builds the database tables, the API, the access control, and a working admin UI from it.

You write the business logic. Auth, multi-tenancy, audit trails, and realtime updates come built in.

Stack: Bun · Hono · PostgreSQL · Redis · React.

How the magic happens

You write a defineFeature() block: entity fields, write handlers, screens. At boot, Kumiko validates the feature graph, checks the migration journal, registers handlers on the command bus, and mounts generated list/edit screens in the admin shell. In local development bun dev creates the tables for you. In production you apply checked-in migrations before the new image starts, and boot stops if the database has drifted (Upgrade Kumiko). Change a field in the entity, the table, API, forms, and labels follow. No separate ORM layer, no hand-written CRUD routes, no React form boilerplate.

→ Concepts: How Kumiko thinks for the full mental model.

What you get

• Declare data, get a UI, one entity definition produces a SQL table, a typed API, forms, lists, filters, and i18n labels. No glue code.
• Multi-tenant from day one, tenant isolation, roles, and audit are the default, not a six-month project.
• Auth without building screens, add the auth feature and get login, signup, password reset, and invites.
• Realtime by default, changes stream to the browser over SSE; concurrent edits are safe out of the box.
• Dozens of ready-made features, billing, files, notifications, GDPR tooling, background jobs, mount what you need.

→ See everything you get, the 90-second tour.

AI for the app you already built

Kumiko Enterprise adds AI at the application boundary, where your tenant rules, handlers, permissions, and audit trail already live. The current workflows cover:

• an in-app assistant that can search records and propose approved writes;
• feature generation and reviewable patches for the Designer;
• structured document extraction, message triage, and tenant-tuned AI pipelines with drafts, activation, rollback, and dry runs.

The open framework remains the foundation. Enterprise provides maintained compositions for these workflows, and you can build an application-specific alternative with the public extension points when you need a different shape.

→ Explore Enterprise AI · Follow the Enterprise AI path

What Kumiko is not

Not a no-code builder

Not Bubble or Webflow, code-first; the schema lives in your repo, not in a vendor’s visual builder.

Not a dashboard on someone else’s DB

Not Retool or Internal, Kumiko owns the database; it does not decorate someone else’s.

Not a CMS

Not a headless CMS, Kumiko builds apps with business logic, not content pipelines.

Where to start

If you want to…	Go to
Get your own app booting in three commands	Quickstart
Follow a route from first app to production concerns	Learning paths
Re-skin default chrome with styles.css	Quickstart → Make it yours
Build a full app (RSVP, subdomains, mail)	Show Pony tutorial
Customize the starter tasks feature	Tutorial
See what Kumiko can do, fast	What you get
Understand how Kumiko works underneath	Concepts
Solve a specific task (“I want to do X”)	Guides
Run a real app and see the generated UI	Examples

How this documentation is organised

Section	Content
Get started	Install, requirements, and a five-minute browser quickstart.
Learning paths	Goal-oriented routes through the existing tutorials, guides, concepts, and recipes.
Tutorial	Build your first feature end to end.
What you get	Every built-in capability, at a glance.
Concepts	The mental model. Why Kumiko works the way it does.
Guides	Task-oriented how-tos: “I want to do X, show me.”
Examples	Runnable sample apps and focused recipes.
Bundled features	Reference for each pre-built feature (auth, audit, files, …).
Platform	Deployment topologies (solo, Docker, k3s).
Reference	Auto-generated patterns, error codes, and sample READMEs.