Kide CMS

A code-first CMS that lives inside your Astro project, not beside it.

Instead of importing a CMS package, create-kide-app clones this repo as your project. All ~3k lines of the CMS runtime, admin UI, and routes sit in src/cms/ where you can read, debug, and modify them. No external package boundary, no version pinning against someone else's breaking change, no abstraction you can't open up.

• Live demo
• Docs

Quick Start

pnpx create-kide-app my-project

You'll be asked for a project name, deploy target (Node.js or Cloudflare), and whether to seed demo content. The CLI clones this repo, installs, initializes git, and (for Cloudflare) provisions D1 + R2 and deploys. You end up with a running app.

How It Works

Define collections in src/cms/collections/:

// src/cms/collections/posts.ts

export default defineCollection({
  slug: "posts",
  labels: { singular: "Post", plural: "Posts" },
  drafts: true,
  fields: {
    title: fields.text({ required: true, translatable: true }),
    body: fields.richText({ translatable: true }),
    author: fields.relation({ collection: "authors", admin: { position: "sidebar" } }),
  },
});

One config generates everything: Drizzle tables, TypeScript types, a Zod validator, and the runtime admin UI.

Query through the typed local API anywhere in server code:

import { cms } from "./cms/.generated/api";

const posts = await cms.posts.find({ status: "published" });
const post = await cms.posts.create({ title: "Hello" });

Hook into the lifecycle to transform, validate, or invalidate cache:

posts: {
  afterPublish(doc, context) {
    context.cache?.invalidate({ tags: ["posts", `post:${doc._id}`] });
  },
}

Features

• 13 field types including blocks, repeaters, and relations
• Drafts, publishing, scheduling, versioning
• Per-field i18n via translation tables
• Asset management with folders, focal points, on-demand optimization
• Tiptap rich text, block editor, real-time cross-tab live preview
• Hierarchical taxonomies and menus
• Role-based access control
• Tag-based cache invalidation (Astro 6 route caching)
• Optional AI assistant (alt text, SEO, translations)

Deploy Targets

• Node.js: SQLite via better-sqlite3, local filesystem storage.
• Cloudflare Workers: D1 for the database, R2 for assets.

Both are wired up by create-kide-app. The Cloudflare overlay lives in adapters/cloudflare/ and is consumed by the CLI at scaffold time. If you clone this repo directly (not via create-kide-app), that folder is scaffolding source and can be deleted.

Stack

Astro 6, React 19, Drizzle ORM, SQLite/D1, Zod, Tiptap, shadcn/ui, Tailwind CSS v4