CMS + Admin + Public Site

Recipe

This is the highest-value full product path: one package-owned runtime with an admin interface and a public website layered on top.

Target Outcome

• One backend runtime created with createSystem()
• One admin/editor frontend built on client metadata exports
• One public site built on site metadata, sections, and theme contracts

Recommended Composition

1. Bootstrap a single system runtime on the server.
2. Expose admin APIs through your host framework using system.cms, system.auth, and system.delivery.
3. Build the admin UI on cms-client, auth-client, delivery-client, and packages/ui-contracts.
4. Build the public site on site-client, theme, and sections.
5. Keep import-export, compliance, editorial workflows, and media processing on the CMS runtime.

Install

npm install @system-core/core zod @prisma/client
npm install bcryptjs jsonwebtoken nodemailer

Add frontend or infrastructure peers only where the product needs them:

• Nuxt/Nitro host: npm install h3
• Express/Fastify host: npm install express fastify
• Redis-backed limits or queues: npm install ioredis
• S3 media storage: npm install @aws-sdk/client-s3 @aws-sdk/s3-request-presigner

Ownership Split

Layer	Package surface
Runtime bootstrap	@system-core/core
Editorial server features	@system-core/core/cms
Admin/editor metadata	@system-core/core/cms-client
Website metadata	@system-core/core/site-client
Theme and sections	@system-core/core/theme, @system-core/core/sections
Shared render contracts	@system-core/core/packages/ui-contracts

Minimal Flow

const system = await createSystem({ prisma, media })

const adminSchema = buildAdminSchema({
  cms: cmsClient,
  auth: authClient,
  delivery: deliveryClient
})

const publicPage = await system.cms.getPublishedPage('/about')

Operational Defaults

• Release package and docs through CI/CD.
• Snapshot docs by minor line with npm run version:minor inside docs-site.
• Keep public AI-facing links pointed at the docs homepage or the main agent guide.

Follow With

• cms
• cms-client
• Reference