Built with Basalt
Basalt grew out of real products, not the other way round. Four applications in four different domains run on it today. Each one found gaps that went back into the framework as fixes and new packages.
| App | Domain | Tenancy | Basalt packages |
|---|---|---|---|
| Mukanda | Document management and process digitisation | Central + one PostgreSQL schema per company | 43 |
| Corredor | B2B logistics | Central + one PostgreSQL schema per tenant | 28 |
| lexfirma | Practice management for law firms | One PostgreSQL schema per firm | 47 |
| producer-basalt | Backend for an agricultural mobile app | Single tenant, MySQL | 21 |
The package count includes each app's web frontend (web/) and the dev-only tools (generator, testing, ai-mcp, deploy).
Mukanda
Document management and process digitisation for companies. A central schema holds the companies, their plans and the staff; each company gets its own PostgreSQL schema with its own Prisma client — the two planes pattern.
- Documents:
fileswithfiles-prisma, S3 storage, and the cloud drives (Dropbox, Google Drive, OneDrive). - Work around them:
notifications,webhooks,realtime, spreadsheet exports, andauditwith its viewer. - Background work: BullMQ queues and the scheduler.
- Billing and access:
subscriptions,teams,permissions,auth. - Operations: an MCP server, and deploys with
@basaltkit/deploy.
Mukanda is the app that pushed Basalt the hardest. It kept a written list of every framework gap it hit (BK-025 to BK-087), and the whole list shipped as framework releases in Basalt 1.13.
Corredor
A B2B logistics platform. It tracks the whole flow — order, load, carrier, vehicle, driver, operation, delivery, proof of delivery — with live updates per tenant over Server-Sent Events.
- Tenancy: a central database (the tenant registry, subscriptions, counters) and one PostgreSQL schema per tenant, with two Prisma clients.
- Live updates: realtime, one stream per tenant.
- Integration:
webhooks,events,audit, S3 storage, and an MCP server. - Billing:
subscriptionswith Prisma.
lexfirma
Practice management for law firms in Angola: contacts, clients, cases, deadlines, hearings, documents, communications, fees and invoicing, and a portal where clients follow their own cases.
- Isolation: each firm is a tenant with its own PostgreSQL schema, not a column that separates rows.
- Payments: reference payments through ProxyPay, on top of
subscriptions. - Finding things: PostgreSQL full-text search.
- Accountability:
activity,audit,notifications, and PostgreSQL backups. - Frontend: the admin console is built from
admin,admin-reactandadmin-shadcn, withdashboard,realtime-clientand the typed SDK.
producer-basalt
The backend of an agricultural mobile app, rebuilt on Basalt. The old backend had its own hand-rolled framework. The rebuild replaced it completely while keeping the mobile app's offline sync (WatermelonDB) algorithm byte for byte and the same /v1 API contract. The mobile app did not have to change.
- HTTP:
createAppwith the security, metrics and OpenAPI plugins, on Fastify. - Data: the existing MySQL schema through
prisma, unchanged. - Auth:
authover the existing users table, compatible with the old password hashes and the old/v1/authroutes. - Uploads:
storageon S3-compatible storage. - Background work: queues on BullMQ and RabbitMQ.
- AI tooling: an MCP server with data tools scoped by role and audited.
It shows a path the other three do not: moving an existing production backend onto Basalt without breaking the clients that depend on it.
What they have in common
- The same building blocks, very different products.
core,http,auth,prismaandfastifyare in all four. Everything else is chosen per app. - Domain code in the app, cross-cutting code in the framework. When an app needed something generic, it went into Basalt as a package or a fix, not into a local patch.
- One deploy path. Three of the four deploy with
@basaltkit/deployto a plain Linux server.
See also
- Basalt vs other frameworks — where Basalt fits, and where the others are stronger.
- Build a notes SaaS — the same journey these apps took, from an empty folder to a server.