createCMS

A composable, block-based, Git-like headless CMS for TypeScript — powered by Drizzle ORM (Postgres) with a fully type-safe API.

⚠️ Work in progress — not production-ready. createCMS is pre-1.0, under active development, and has not been tested in production. Expect breaking changes, rough edges, and bugs (including possible data-loss edge cases). Use it for prototyping and exploration — not for production workloads. Pin an exact version.

Upgrading? BREAKING-CHANGES.md lists every break since 0.2.0, with the migration for each one.

• 🌿 Database-native versioning — branches, copy-on-write drafts, diff & merge APIs (bring your own diff UI)
• 🧱 Composable blocks — nested pages, reusable blocks, type-safe block trees
• 🔌 Plugins — multi-tenant, i18n, A/B testing, consent, media optimization
• ⚡️ Type-safe end to end — collections → API → client, fully inferred
• 🧰 createcms CLI — scaffold config + generate the Drizzle schema

bun add @createcms/core
# or: npm install @createcms/core

Quickstart

import { createCMS } from '@createcms/core';

export const cms = createCMS({
  db, // your Drizzle client
  collections: { pages }, // your collection definitions
  // S3-compatible storage (dummy values for local dev)
  media: {
    provider: 'custom',
    hostname: process.env.S3_HOSTNAME ?? 'localhost',
    region: process.env.S3_REGION ?? 'us-east-1',
    accessKeyId: process.env.S3_ACCESS_KEY_ID ?? 'dummy',
    secretAccessKey: process.env.S3_SECRET_ACCESS_KEY ?? 'dummy',
    bucketName: process.env.S3_BUCKET ?? 'dummy',
    publicUrl: process.env.S3_PUBLIC_URL ?? 'https://cdn.example.com',
  },
});

Put this in lib/cms.ts (or src/lib/cms.ts / cms.ts) so bunx createcms generate finds it; or pass a path: createcms generate ./path/to/cms.ts.

Generate the database schema, then run your migrations:

bunx createcms generate

Then mount the CMS HTTP router on a catch-all route — see the Next.js integration guide.

See the docs — start with quickstart and installation, then the reference for collections, branches, publishing, and plugins.

The docs site lives under apps/docs and renders locally with bun run --filter=docs dev. A hosted URL will be linked here once the site is deployed.

Repository

This is a bun + turbo monorepo:

• packages/cms — @createcms/core, the composable headless CMS
• packages/schema — @createcms/schema, the shared type vocabulary (types only, private; inlined into core and react)
• packages/react — @createcms/react, headless editor primitives
• apps/docs — the documentation site + landing page (Fumadocs)
• examples/ — runnable example apps

Development

bun install
bun run build        # turbo build (bunchee)
bun run check-types  # tsc --noEmit
bun run test         # vitest (PGlite-backed)
bun run --filter=@createcms/react test:browser  # Chromium via Playwright

See CONTRIBUTING.md.

License

MIT