Developer Guide

Repository layout

apps/api/            API Worker (Hono, D1, R2)
apps/admin/          Admin SPA (React, Vite)
packages/database/   Drizzle schema, migrations
packages/contracts/  Shared Zod API contract (published to npm)
packages/create/     @kenresoft-cms/create CLI
integrations/astro/  @kenresoft-cms/astro
examples/astro-site/ Reference Astro site
docs/                Repository design docs
wrangler.toml        Root Worker config

Local development

pnpm install
cp .dev.vars.example .dev.vars          # set the local Better Auth secret
cp apps/admin/.env.example apps/admin/.env
pnpm --filter @kenresoft-cms/database migrate:local
pnpm dev

API:   http://localhost:8787
Admin: http://localhost:5173

Run either alone with pnpm --filter @kenresoft-cms/api dev or pnpm --filter @kenresoft-cms/admin dev.

Work on the develop branch or a feature/* branch; main is reserved for release promotion.

Deeper design documents live in the repository’s docs/ folder (ARCHITECTURE.md, PLUGINS.md, SITE_BUILDER.md). Plugins and the plugin SDK are documented there and are not yet covered on this site.