For Developers

A Headless CMS That Respects Your Craft

Clean API. TypeScript-native SDK. Self-hosting on any stack. Schema-as-code. Open source under the AGPLv3. b10cks is the CMS you'd build yourself—except it already exists.

Built by Developers. For Developers.

No black boxes. No vendor magic. Just a well-built system.

b10cks doesn't ask you to trust the platform — it invites you to read it. The entire codebase is public. Every API endpoint is documented. Every architectural decision is visible and reasoned.

Developer trust is earned through transparency, not marketing copy. We know that.

The Stack

Familiar technology. Familiar patterns.

Backend: Laravel — battle-tested, well-documented, security-focused. If you've ever worked with a Laravel app, you can extend b10cks.

Frontend: Vue.js 3 with TanStack Query, Tailwind CSS, and Shadcn UI. TypeScript throughout.

Database: MySQL, MariaDB, or SQLite. Your choice, your infrastructure.

Storage: Local filesystem, Amazon S3, Google Cloud Storage, or any S3-compatible provider (MinIO, Backblaze B2, Cloudflare R2).

Real-time: Laravel Echo + Pusher-compatible server — or your own WebSocket server.

Search: MySQL fulltext or OpenSearch, switchable per space, same API surface either way.

No proprietary infrastructure. No hosted-only requirements. Software that runs where you tell it to.

The API

REST, documented, predictable, versioned.

API characteristics:

  • Versioned endpoints: v1 is stable; breaking changes come with migration guides and grace periods
  • OpenAPI specification: import into Postman, Insomnia, or generate a client in any language
  • Cursor-based pagination for large datasets
  • Draft and published version querying via query params
  • Reference resolution control: resolve nested blocks eagerly or lazily
  • Rate limit headers: X-RateLimit-Remaining and X-RateLimit-Reset, always visible

Schema as Code

Your content model belongs in your repository.

Define block schemas in TypeScript, version in Git, deploy through CI/CD. Schema changes propagate to the canvas, the editor, and the API automatically. No manual sync.

Self-Hosting

Your servers. Your rules. Your data.

That's a running CMS. Add your domain and SSL and you're in production.

Deployment targets: AWS · GCP · Azure · DigitalOcean · Hetzner · Fly.io · Kubernetes (Helm chart available) · any VPS

Self-hosting gives you: data residency, custom domain, infrastructure cost control, no upstream dependency on b10cks for your content delivery.

Webhooks

React to content changes — your way.

Webhooks fire on any content lifecycle event: publish, unpublish, draft save, locale update, block schema change.

HMAC signature verification, delivery logging, and exponential backoff retry are all included.

Use webhooks to trigger ISR invalidation, update search indexes, kick off static site builds, and sync to downstream data stores.