Per sviluppatori

Un CMS headless che rispetta il tuo mestiere

API pulita. SDK nativo per TypeScript. Self-hosting su qualsiasi stack. Schema come codice. Open source sotto AGPLv3. b10cks è il CMS che costruiresti tu — solo che esiste già.

Costruito da sviluppatori. Per sviluppatori.

Niente scatole nere. Niente magia del fornitore. Solo un sistema costruito bene.

b10cks non ti chiede di fidarti della piattaforma — ti invita a leggerla. L’intero codice sorgente è pubblico. Ogni endpoint API è documentato. Ogni scelta architetturale è visibile e motivata.

La fiducia degli sviluppatori si guadagna con la trasparenza, non con testi promozionali. Questo lo sappiamo bene.

Lo stack

Tecnologia familiare. Pattern familiari.

Backend: Laravel — collaudato sul campo, ben documentato, focalizzato sulla sicurezza. Se hai mai lavorato con un’app Laravel, puoi estendere b10cks.

Frontend: Vue.js 3 con TanStack Query, Tailwind CSS e Shadcn UI. TypeScript ovunque.

Database: MySQL, MariaDB o SQLite. La tua scelta, la tua infrastruttura.

Storage: file system locale, Amazon S3, Google Cloud Storage o qualsiasi provider compatibile con S3 (MinIO, Backblaze B2, Cloudflare R2).

Real-time: Laravel Echo + server compatibile con Pusher — oppure il tuo server WebSocket.

Search: fulltext MySQL o OpenSearch, selezionabile per ogni spazio, stessa API in entrambi i casi.

Niente infrastruttura proprietaria. Nessun requisito solo hosted. Software che gira dove dici tu.

L’API

REST, documentata, prevedibile, versionata.

Caratteristiche dell’API:

  • Endpoint versionati: v1 è stabile; le modifiche breaking arrivano con guide di migrazione e periodi di tolleranza
  • Specifica OpenAPI: importa in Postman, Insomnia o genera un client in qualsiasi linguaggio
  • Paginazione basata su cursor per dataset di grandi dimensioni
  • Query per versioni draft e pubblicate tramite parametri di query
  • Controllo della risoluzione dei riferimenti: risolvi i blocchi annidati in modo eager o lazy
  • Header di rate limit: X-RateLimit-Remaining e X-RateLimit-Reset, sempre visibili

Schema come codice

Il tuo modello di contenuti deve stare nel tuo repository.

Definisci gli schema dei blocchi in TypeScript, versionali in Git, distribuiscili tramite CI/CD. Le modifiche agli schema si propagano automaticamente al canvas, all’editor e all’API. Nessuna sincronizzazione manuale.

Self-hosting

I tuoi server. Le tue regole. I tuoi dati.

Questo è un CMS pronto all’uso. Aggiungi il tuo dominio e l’SSL e sei in produzione.

Destinazioni di deployment: AWS · GCP · Azure · DigitalOcean · Hetzner · Fly.io · Kubernetes (chart Helm disponibile) · qualsiasi VPS

Il self-hosting ti offre: residenza dei dati, dominio personalizzato, controllo dei costi dell’infrastruttura, nessuna dipendenza upstream da b10cks per la distribuzione dei tuoi contenuti.

Webhook

Reagisci ai cambiamenti dei contenuti — a modo tuo.

I webhook si attivano su qualsiasi evento del ciclo di vita dei contenuti: pubblicazione, annullamento della pubblicazione, salvataggio di una bozza, aggiornamento della lingua, modifica dello schema di un blocco.

La verifica della firma HMAC, il logging delle consegne e i retry con backoff esponenziale sono tutti inclusi.

Usa i webhook per attivare l’invalidazione ISR, aggiornare gli indici di ricerca, avviare build di siti statici e sincronizzare i dati verso archivi downstream.