Introduction
What is Primebrick?
Primebrick is an opinionated, open-source backoffice framework for building business applications. It is licensed under the MIT license and is designed to run on any cloud or on-premises — no vendor lock-in.
The framework provides a complete, production-ready foundation so teams can focus on business logic instead of reinventing infrastructure: authentication, authorization, multi-tenant data access, messaging, service registry, and an admin frontend are all included out of the box.
Tech stack
| Layer | Technology |
|---|---|
| Backend API | TypeScript, Express, Node.js |
| Frontend | SvelteKit |
| Database | PostgreSQL |
| Identity | Casdoor (OIDC / OAuth2) |
| Messaging | NATS |
| Shared libraries | @primebrick/dal, @primebrick/sdk |
Who is it for?
- Developers who want a fast, consistent starting point for backoffice applications without assembling dozens of libraries themselves.
- CTOs and tech leaders who need a maintainable, multi-cloud architecture with no vendor lock-in and a clear upgrade path.
- Teams that value convention over configuration and want best practices enforced by the framework rather than policed in code review.
Philosophy
We start from best practices and enforce them through the framework.
Primebrick is deliberately opinionated. Instead of offering every possible option and leaving teams to choose, the framework picks sensible defaults and bakes them into the codebase:
- Consistent API design — every service follows the same OpenAPI-first standard.
- Uniform error handling — RFC 7807 Problem Details everywhere, no ad-hoc error shapes.
- Standardized auth — Casdoor IDP with JWT tokens, refresh cookies, and API keys.
- Predictable RBAC — wildcard-based permissions that are easy to reason about.
- Service registry — microservices self-register and are discoverable automatically.
The goal is to reduce decision fatigue and code-review overhead so teams can ship business features faster.
License
Primebrick is released under the MIT License — one of the most permissive open-source licenses. You can use it in commercial projects, modify it, and distribute it freely.
Next steps
- Quick Start — get Primebrick running locally in minutes.
- Architecture — understand the layered design.