What it is: A TypeScript framework for multi-tenant business apps with a built-in audit trail and a configurable feature model.
What you get:
- Public GitHub repo at
github.com/kumiko-framework/kumiko— full source, all tests, all examples - NPM packages (
@cosmicdrift/kumiko-framework,@cosmicdrift/kumiko-bundled-features,@cosmicdrift/kumiko-dev-server, …) — free to use - CLI (
yarn kumiko dev | test | build | migrate | …) - License: BSL-1.1 — free for everything except commercial hosting that competes with kumiko.so. Every release automatically becomes Apache-2.0 after 2 years. As long as we keep developing, you always have 2 years of protection on the current state. Older releases belong to the community
What you do yourself:
- Hosting (Docker on Coolify / Hetzner / Kubernetes / bare-metal)
- Repo maintenance (your code, your audit trail)
- AI integration (BYOK — Anthropic, OpenAI or local model via Ollama)
Who uses this:
- Engineering teams that want full control and run their own hosting
- European mid-market with sysadmin teams and on-prem requirements
- Software shops that want a unified stack across multiple customer projects
Stack
| Layer | Tech |
|---|---|
| Runtime | Bun |
| API | Hono |
| DB | Postgres + Drizzle ORM |
| Auth | jose (JWT) |
| Validation | Zod |
| Search | Meilisearch (adapter interface) |
| UI | React + Expo (Web + Mobile) |
| Realtime | SSE via Redis Pub/Sub |
| Testing | Vitest |
No Kafka. No EventStoreDB. No NATS. Postgres is event store, read model and source of truth at once. Fewer moving parts, less ops load.
What bundled-features brings (optional)
@cosmicdrift/kumiko-bundled-features/auth-email-password— login, reset, verification@cosmicdrift/kumiko-bundled-features/sessions— revocation, JWT-jti, cleanup@cosmicdrift/kumiko-bundled-features/tenant+/user— multi-tenant master data@cosmicdrift/kumiko-bundled-features/delivery+channel-{in-app,email,push}— notifications@cosmicdrift/kumiko-bundled-features/jobs— BullMQ wrapper@cosmicdrift/kumiko-bundled-features/feature-toggles— tech toggles per tenant@cosmicdrift/kumiko-bundled-features/audit— automatic audit trail@cosmicdrift/kumiko-bundled-features/secrets— encrypted KV@cosmicdrift/kumiko-bundled-features/files-provider-s3— S3/MinIO storage
All optional. Hello-World comes without them.
Relationship to the platform
kumiko.so itself runs on the framework. What lands in the framework becomes available on the platform automatically — not the other way round. Platform-specific features (Designer UI, AI-builder frontend, tenant provisioning, billing) live in a private repo and are not part of the open-source release. Self-hosting the platform is only possible under enterprise terms.
See plattform.
Next step
→ Explore the repo: github.com/kumiko-framework/kumiko (public launch in preparation)
→ Pilot program for European mid-market: hello@kumiko.so