Estamos em estágio inicial — fale conosco!
Licença MIT • Open Source • Multi-Cloud

O framework backoffice opinionated para equipas sérias, arquitetos de software, CTOs visionários

Primebrick v3 é um framework open-source que define infraestrutura, arquitetura e regras de codificação segundo as melhores práticas. Licença MIT: use em projetos comerciais, sem amarras.

Licença MIT
6+ destinos
Zero vendor lock-in

From schema to production

Everything is an entity — not just your domain models, but settings, configurations, and metadata too. Define your entities, and Primebrick handles the rest: database migrations, API endpoints, RBAC, backoffice UI, tests — all generated following your conventions.

1 Define your entity schema
2 AI generates migration, CRUD API, UI, tests
3 Review, approve, deploy
primebrick@dev: ~ Schema Declaration
# Describe your entity
$ primebrick generate entity Customer
name: string (required)
email: string (unique)
status: enum [active, inactive]
phone: string (optional)
createdAt: timestamp (auto)
# AI generates everything...
✓ Database migration created
→ 00000000000003_create_customers_table.sql
✓ API CRUD endpoints (6 routes)
→ GET /api/v1/customers
→ POST /api/v1/customers
→ PUT /api/v1/customers/:id
→ DELETE /api/v1/customers/:id
✓ RBAC permissions configured
→ customers.read.* (guest, collaborator)
→ customers.* (administrator)
# Review the generated code
$ primebrick review --diff
14 files changed, 847 insertions(+), 0 deletions(-)
✓ Backoffice UI pages generated
→ /admin/customers (list, detail, form)
✓ Test scaffolding (12 tests)
→ unit: 4 | integration: 6 | e2e: 2
✓ OpenAPI spec updated
→ /api/v1/openapi/aggregated.json
# Deploy to production
$ primebrick deploy --env production
Building TypeScript...
Running tests... 12/12 passed ✓
Migrating database...
Registering microservice...
Deploying to Cloudflare Workers...
Health check passed...
🚀 Live at https://api.primebrick.dev/v1/customers
# Verify the deployment
$ curl https://api.primebrick.dev/v1/customers | jq .
status: 200 OK
count: 42 customers
response time: 18ms
$

Multi-cloud, a sério.

A sua infrastrutura, as suas regras. Sem vendor lock-in: Primebrick corre igual do laptop ao datacenter empresarial, do cluster K8s à nuvem pública mais próxima dos utilizadores.

AWS
Azure
Google Cloud
Alibaba Cloud
Docker
Kubernetes
Self-hosted
Executa na tua própria infraestrutura
Cloud-hosted
Deploy em qualquer nuvem pública
On-Premise
Deploy no datacenter empresarial
AI-Nativo

IA que entrega funcionalidades em minutos, não dias.

Primebrick integra IA diretamente no fluxo de desenvolvimento. Descreve uma funcionalidade em linguagem natural e a IA gera o schema, os endpoints API, as páginas UI e os testes — tudo seguindo as convenções do framework. O que antes levava dias de boilerplate agora leva minutos.

De schema a página em minutos

Descreve a tua entidade, obténs a migração de base de dados, CRUD API, permissões RBAC e UI de backoffice gerados automaticamente.

Conhece as convenções

A IA conhece os padrões do Primebrick: gera código que segue a tua arquitetura, não boilerplate genérico.

Testes incluídos

Cada funcionalidade gerada inclui scaffolding de testes. Entrega com confiança, não com esperança.

Desenvolvimento Agentic

Duas formas de construir. Ambas first-class.

Primebrick suporta todo o espetro de fluxos de desenvolvimento. Usa o teu IDE preferido para codificação profunda e hands-on. Ou deixa que os agentes IA construam funcionalidades diretamente da app web — sem ambiente local.

// AI-POWERED

Modo Agentic

Agentes IA no navegador

Descreve o que queres, aprova o plano, e os agentes IA constroem-no diretamente na app web. Sem setup local, sem config de ambiente. Da ideia à funcionalidade deployada sem sair do navegador.

🔒 primebrick.dev/agent/cowork
Customer Entity — Session #42
Create a Customer entity with name, email, and status fields
🤖 AI Agent
I'll create the Customer entity. Here's my plan:
1. Schema: name, email, status
2. Migration: 00004_create_customers
3. API: 6 CRUD endpoints
4. RBAC: customers.* permissions
5. UI: list, detail, form pages
6. Tests: 12 scaffolds
Plan ready — 14 files to create/modify:
Ask the agent to build something...Send
// TRADITIONAL

Modo IDE

VS Code, Cursor, Windsurf

Clona, executa localmente, depura com breakpoints, controlo total. A experiência de desenvolvedor tradicional com todas as convenções do framework aplicadas pelo tooling.

entity.schema.ts — Primebrick IDE — Visual Studio Code
entity.schema.ts
router.ts
1// Entity definition
2export const Customer = entity({
3name: string().required(),
4email: string().unique(),
5status: enum(['active']),
6});
7
8// AI generated:
9✓ Migration + API + RBAC + UI + Tests
✓ No problemsUTF-8TypeScriptLn 9, Col 1
Design-Free

O teu frontend. Os teus componentes. As nossas convenções.

Primebrick é opinionated sobre arquitetura mas design-free sobre UI. Usa qualquer biblioteca de componentes — vanilla, Svelte, ou a nossa própria Primebrick UI Library. A arquitetura de micro-frontend permite-te construir qualquer página com qualquer componente, enquanto o framework aplica as melhores práticas.

1

Tudo é uma entidade

Definições, configurações, metadados — tudo entidades. Os mesmos padrões CRUD, RBAC e validação aplicam-se em todo o lado.

2

Opinionated mas design-free

Melhores práticas aplicadas pelo framework. Mas tu escolhes a UI: HTML vanilla, Svelte, ou a nossa Primebrick UI Library.

3

Primebrick UI Library

A nossa própria biblioteca de componentes com melhores práticas integradas. Usa-a diretamente ou como referência para os teus componentes.

4

Arquitetura de micro-frontend

Como microserviços, mas para o frontend. Cada página é independente, deployable, e pode usar stacks de componentes diferentes.

Um backoffice que começa com as suas próprias regras.

Todo backoffice começa bem e acaba em caos. Primebrick v3 inverte a perspetiva: começamos pelas melhores práticas e aplicamo-las através do framework.

1

Infrastructure as Code

Manifestos K8s, charts Helm, templates Terraform prontos para staging e produção.

2

Arquitetura em camadas

Separação limpa entre domínio, aplicação, infraestrutura e UI. Testável por construção.

3

Regras de codificação opinionated

Linting, tipos estritos, padrões obrigatórios: a dívida técnica é prevenida, não paga depois.

4

Observabilidade nativa

OpenTelemetry, logging estruturado, health-checks integrados desde o primeiro commit.

Tudo o que precisa. Nada que não.

Tomámos as decisões difíceis uma vez, para que as suas equipas não as tomem a cada sprint. Cada brick é testado, integrado e documentado.

/ AUTH

Identidade & RBAC

OIDC, gestão de roles, permissões granulares ao nível de schema.

/ DATA

Camada de persistência

PostgreSQL: servidor BD AND servidor vector para IA generativa. Soft-delete, campos de auditoria, operações bulk.

/ UI

Motor de backoffice

CRUD, tabelas, formulários, filtros gerados a partir de schemas de domínio.

/ OBS

Observabilidade completa

OpenTelemetry integrado, tracing, métricas, logs correlacionados.

/ MULTI

Multi-tenant ready

Isolamento lógico e físico para milhares de organizações.

/ SDK

SDK type-safe

Clientes TypeScript gerados a partir de endpoints, type safety end-to-end.

DB + Vector Server

PostgreSQL: a tua base de dados E o teu servidor vectorial.

Primebrick usa PostgreSQL não apenas como base de dados, mas como servidor vectorial para IA generativa. Sem base de dados vectorial separada para gerir. Em breve mais suporte de bases de dados.

Em breve mais suporte de bases de dados
Pesquisa de similaridade vectorial
-- Encontrar clientes similares usando embeddings vectoriais
SELECT name, email,
embedding <=> $1 AS distance
FROM customers
WHERE status = 'active'
ORDER BY embedding <=> $1
LIMIT 5;
$
Infraestrutura

Cada componente, mapeado.

Do navegador à base de dados — portas, protocolos e fluxo de dados claros. Dockerizado para desenvolvimento local, pronto com Terraform para produção.

HTTPHTTP /api/v1/OAuth2SQL via DALNATSSQL via DALproxy /ws/:codeBrowserAdmin UI / API ClientsSvelteKitport 5173BackendExpress · port 3001Auth · RBAC · Proxy · RegistryCasdoorOAuth2 · port 8000NATSport 4222 · pub/subMSdynamic@primebrick/sdkregistration · NATS · healthPostgreSQLport 5432 + pgvectorsingle data store@primebrick/dalpool · repository · typesDocker
Arquitetura

Estratificado por design.

Frontend, Backend, Microserviços, Bibliotecas, Dados — cada camada tem uma responsabilidade clara e comunica através de protocolos definidos.

1

Frontend

SvelteKit Admin UI — comunica apenas com a API do Backend

2

Backend

Express API — Auth, RBAC, Service Registry, Proxy

3

Microserviços

Serviços Docker independentes — auto-registo via NATS

4

Bibliotecas

@primebrick/sdk + @primebrick/dal-pg — partilhadas

5

Dados

PostgreSQL — único armazen de dados, acesso via DAL

Menos boilerplate, mais valor.

Estrutura clara, regras de codificação objetivas, DX desenhada para velocidade. Clona, executa, e já estás num ambiente de melhores práticas — CI/CD, linting, tipos, testes, observabilidade.

  • Onboarding em horas, não semanas
  • Zero discussões sobre "como fazemos as coisas aqui"
  • Stack moderno, tipado, testado

Seleção de software sem risco.

Licença MIT, código aberto e inspeccionável, deploy onde decides. Reduz o time-to-market e a dívida técnica desde o minuto zero. Sem vendor lock-in, sem surpresas contratuais.

  • Uso comercial gratuito (MIT)
  • Hospeda onde precisar: cloud ou on-prem
  • Padrões verificáveis, não promessas

Open source. Mesmo para uso comercial.

Primebrick v3 é publicado sob licença MIT: podes usar, modificar, redistribuir e integrar em produtos comerciais sem royalties. O código é público no GitHub.

Constrói o teu próximo backoffice com as regras certas.

Clona o repo, segue o quick-start, e estás em produção com uma arquitetura pela qual os teus futuros desenvolvedores te agradecerão.

Ler a arquitetura