Siamo in fase iniziale — contattaci!
Licenza MIT • Open Source • Multi-Cloud

Il framework backoffice opinionato per team seri, architetti software, CTO visionari

Primebrick v3 è un framework open-source che definisce infrastruttura, architettura e regole di codifica secondo le best practice. Licenza MIT: usalo in progetti commerciali, senza vincoli.

Scopri l'architettura
Licenza MIT
6+ destinazioni
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, davvero.

La tua infrastruttura, le tue regole. Nessun vendor lock-in: Primebrick gira identico dal tuo laptop al datacenter aziendale, dal cluster K8s al cloud pubblico più vicino ai tuoi utenti.

AWS
Azure
Google Cloud
Alibaba Cloud
Docker
Kubernetes
Self-hosted
Esegui sulla tua infrastruttura
Cloud-hosted
Deploy su qualsiasi cloud pubblico
On-Premise
Deploy nel datacenter aziendale
AI-Native

AI che distribuisce funzionalità in minuti, non giorni.

Primebrick integra l'AI direttamente nel flusso di sviluppo. Descrivi una funzionalità in linguaggio naturale e l'AI genera lo schema, gli endpoint API, le pagine UI e i test — tutto seguendo le convenzioni del framework. Ciò che prima richiedeva giorni di boilerplate ora richiede minuti.

Da schema a pagina in minuti

Descrivi la tua entità, ottieni la migrazione del database, il CRUD API, i permessi RBAC e l'UI backoffice generati automaticamente.

Conosce le convenzioni

L'AI conosce i pattern di Primebrick: genera codice che segue la tua architettura, non boilerplate generico.

Test inclusi

Ogni funzionalità generata include lo scaffolding dei test. Distribuisci con fiducia, non con speranza.

Sviluppo Agentic

Due modi per costruire. Entrambi first-class.

Primebrick supporta l'intero spettro dei flussi di sviluppo. Usa il tuo IDE preferito per codifica approfondita e hands-on. Oppure lascia che gli agenti AI costruiscano funzionalità direttamente dall'app web — senza ambiente locale.

// AI-POWERED

Modalità Agentic

Agenti AI nel browser

Descrivi cosa vuoi, approva il piano, e gli agenti AI lo costruiscono direttamente nell'app web. Nessun setup locale, nessuna config di ambiente. Dall'idea alla funzionalità deployata senza lasciare il browser.

🔒 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

Modalità IDE

VS Code, Cursor, Windsurf

Clona, esegui localmente, debug con breakpoint, pieno controllo. L'esperienza sviluppatore tradizionale con tutte le convenzioni del framework applicate dal 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

Il tuo frontend. I tuoi componenti. Le nostre convenzioni.

Primebrick è opinionato sull'architettura ma design-free sull'UI. Usa qualsiasi libreria di componenti — vanilla, Svelte, o la nostra Primebrick UI Library. L'architettura a micro-frontend ti permette di costruire qualsiasi pagina con qualsiasi componente, mentre il framework applica le best practice.

1

Tutto è un'entità

Impostazioni, configurazioni, metadati — tutto entità. Gli stessi pattern CRUD, RBAC e validazione si applicano ovunque.

2

Opinionato ma design-free

Best practice applicate dal framework. Ma scegli tu l'UI: HTML vanilla, Svelte, o la nostra Primebrick UI Library.

3

Primebrick UI Library

La nostra libreria di componenti con best practice integrate. Usala direttamente o come riferimento per i tuoi componenti.

4

Architettura a micro-frontend

Come i microservizi, ma per il frontend. Ogni pagina è indipendente, deployable, e può usare stack di componenti diversi.

Un backoffice che inizia con le proprie regole.

Ogni backoffice inizia bene e finisce nel caos. Primebrick v3 ribalta la prospettiva: partiamo dalle best practice e le applichiamo tramite il framework.

1

Infrastructure as Code

Manifest K8s, chart Helm, template Terraform pronti per staging e produzione.

2

Architettura a strati

Separazione pulita tra dominio, applicazione, infrastruttura e UI. Testabile per costruzione.

3

Regole di codifica opinionate

Linting, tipi strict, pattern obbligatori: il debito tecnico è prevenuto, non pagato dopo.

4

Osservabilità nativa

OpenTelemetry, logging strutturato, health-check integrati dal primo commit.

Tutto ciò che serve. Niente di più.

Abbiamo preso le decisioni difficili una volta, così i tuoi team non le prendono ogni sprint. Ogni brick è testato, integrato e documentato.

/ AUTH

Identità & RBAC

OIDC, gestione ruoli, permessi granulari a livello di schema.

/ DATA

Layer di persistenza

PostgreSQL: server DB AND server vector per AI generativa. Soft-delete, campi di audit, operazioni bulk.

/ UI

Motore backoffice

CRUD, tabelle, form, filtri generati dagli schemi di dominio.

/ OBS

Osservabilità completa

OpenTelemetry integrato, tracing, metriche, log correlati.

/ MULTI

Multi-tenant ready

Isolamento logico e fisico per migliaia di organizzazioni.

/ SDK

SDK type-safe

Client TypeScript generati dagli endpoint, type safety end-to-end.

DB + Vector Server

PostgreSQL: il tuo database E il tuo vector server.

Primebrick usa PostgreSQL non solo come database, ma come vector server per l'AI generativa. Nessun database vettoriale separato da gestire. Presto supporto per altri database.

Presto supporto per altri database
Ricerca di similarità vettoriale
-- Trova clienti simili usando embeddings vettoriali
SELECT name, email,
embedding <=> $1 AS distance
FROM customers
WHERE status = 'active'
ORDER BY embedding <=> $1
LIMIT 5;
$
Infrastruttura

Ogni componente, mappato.

Dal browser al database — porte, protocolli e flusso dei dati chiari. Dockerizzato per lo sviluppo locale, pronto con Terraform per la produzione.

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
Architettura

Stratificato per design.

Frontend, Backend, Microservizi, Librerie, Dati — ogni livello ha una responsabilità chiara e comunica tramite protocolli definiti.

1

Frontend

SvelteKit Admin UI — comunica solo con l'API Backend

2

Backend

Express API — Auth, RBAC, Service Registry, Proxy

3

Microservizi

Servizi Docker indipendenti — auto-registrazione via NATS

4

Librerie

@primebrick/sdk + @primebrick/dal-pg — condivise tra tutti i servizi

5

Dati

PostgreSQL — unico data store, accessibile via DAL

Meno boilerplate, più valore.

Struttura chiara, regole di codifica oggettive, DX progettata per la velocità. Clona, esegui, e sei già in un ambiente di best practice — CI/CD, linting, tipi, test, osservabilità pronti.

  • Onboarding in ore, non settimane
  • Zero discussioni su "come facciamo le cose qui"
  • Stack moderno, tipizzato, testato

Selezione software senza rischio.

Licenza MIT, codice aperto e ispezionabile, deploy dove decidi tu. Riduci il time-to-market e il debito tecnico dal minuto zero. Nessun vendor lock-in, nessuna sorpresa contrattuale.

  • Uso commerciale gratuito (MIT)
  • Host dove serve: cloud o on-prem
  • Standard verificabili, non promesse

Open source. Anche per uso commerciale.

Primebrick v3 è rilasciato sotto licenza MIT: puoi usare, modificare, ridistribuire e integrare in prodotti commerciali senza royalty. Il codice è pubblico su GitHub, le decisioni di design sono documentate, i contributi sono benvenuti.

Costruisci il tuo prossimo backoffice con le regole giuste.

Clona il repo, segui il quick-start, e sei in produzione con un'architettura per cui i tuoi futuri sviluppatori ti ringrazieranno.

Leggi l'architettura