@beechcms/cms 0.7.0 → 0.8.0

package/bin/cli.mjs

@@ -1,10 +1,6 @@
 #!/usr/bin/env node
 // @ts-check
 
-import { spawnSync } from 'node:child_process'
-import { existsSync } from 'node:fs'
-import { resolve } from 'node:path'
-import { pathToFileURL } from 'node:url'
 import pc from 'picocolors'
 
 let [,, command, ...args] = process.argv
@@ -13,6 +9,14 @@ if (command && args[0] && ['db', 'seed', 'schema', 'dev', 'generate', 'mailpit']
   command = `${command}:${args.shift()}`
 }
 
+if (command === 'gen' && args[0] === 'types') {
+  command = 'gen-types'
+  args.shift()
+  if (args[0] === 'typescript') {
+    args.shift()
+  }
+}
+
 const COMMANDS = {
   build:            cmdBuild,
   'seed:load':      cmdSeedLoad,
@@ -24,7 +28,12 @@ const COMMANDS = {
   'update':         cmdUpdate,
   'onboard':        cmdOnboard,
   'reset':          cmdReset,
-  'generate:types': cmdGenerateTypes,
+  'forms':          cmdForms,
+  'form':           cmdForms,
+  'forms:add':      cmdForms,
+  'gen-types':       cmdGenerateTypes,
+  'gen:types':       cmdGenerateTypes,
+  'generate:types':  cmdGenerateTypes,
   // New unified command mappings:
   'db:migrate':     cmdDbMigrate,
   'db:reset':       cmdDbReset,
@@ -38,6 +47,8 @@ const COMMANDS = {
   'test':           cmdTest,
   'lint':           cmdLint,
   'doctor':         cmdDoctor,
+  'setup:cloudflare': cmdSetupCloudflare,
+  'setup:cf':         cmdSetupCloudflare,
 }
 
 function help() {
@@ -50,7 +61,7 @@ function help() {
       --remote        Target remote D1 instead of local (default: local)
       --db-name <n>   Override D1 database name
       --yes, -y       Run in non-interactive mode
-    ${pc.cyan('onboard')}         One-command local provisioning (init --db + seed:load)
+    ${pc.cyan('onboard')}         One-command local provisioning (init --db)
       --remote        Target remote D1 instead of local (default: local)
       --yes, -y       Skip all interactive prompts (non-interactive mode)
       --db <name>     Override D1 database name
@@ -60,24 +71,23 @@ function help() {
     ${pc.cyan('db:migrate')}      Apply all pending local migrations
     ${pc.cyan('db:reset')}        Remove local Wrangler state and re-bootstrap database
 
-  ${pc.bold('3. Seed & Schema Management')}
-    ${pc.cyan('seed:create')}     Interactive wizard — generate a new Seed schema in seeds.ts
-    ${pc.cyan('seed:load')}       Create/update content tables from SEED_REGISTRY
-      --dry-run       Print SQL without executing
-      --diff          Show schema differences vs current DB
-      --remote        Execute against remote D1 (default: local)
-      --db <name>     Override D1 database name
-    ${pc.cyan('schema:diff')}     Diff SEED_REGISTRY vs D1 and generate additive SQL migration
-      --write         Write the migration file (default: preview only)
-      --name <name>   Migration name used in the filename
-      --remote        Diff against remote D1 (default: local)
+  ${pc.bold('3. Database & Types Management')}
+    ${pc.cyan('gen types typescript')} (alias: ${pc.cyan('gen-types')})
+      Generate TypeScript interfaces from active D1 database
+      --local         Target local D1 SQLite state (default)
+      --remote        Target remote Cloudflare D1
       --db <name>     Override D1 database name
-    ${pc.cyan('validate')}        Validate seeds registry for errors
-    ${pc.cyan('generate:types')}  Generate TypeScript interfaces from seed definitions
-      --out <path>    Output file (default: src/types/beech.ts)
-      --local         Read from seeds.ts instead of querying live D1
+      -o, --output    Output file path (default: standard output)
+    ${pc.cyan('validate')}        Validate runtime schema status
 
-  ${pc.bold('4. Local Stack & Docker')}
+  ${pc.bold('4. Forms & Frontend Generation')}
+    ${pc.cyan('forms / form')}    Interactive wizard to generate React, Vue, Svelte, or Web Component forms
+      --framework <f> Framework: react, vue, svelte, vanilla
+      --seed <slug>   Seed slug to bind to (e.g. clienti)
+      --mode <mode>   styled (Tailwind) or headless
+      --yes, -y       Skip interactive prompts
+
+  ${pc.bold('5. Local Stack & Docker')}
     ${pc.cyan('dev / start')}     Start the local dev environment (Docker + API + Dashboard)
       --plain         Avoid Ink visual TUI and run clean log streaming
     ${pc.cyan('dev:stop')}        Stop Docker containers without wiping data
@@ -85,16 +95,19 @@ function help() {
     ${pc.cyan('dev:tunnel')}      Display Cloudflare tunnel public testing URL
     ${pc.cyan('mailpit:clear')}   Clear local test inbox in Mailpit
 
-  ${pc.bold('5. Logs Streaming')}
+  ${pc.bold('6. Logs Streaming')}
     ${pc.cyan('logs <service>')}   Show streaming logs for docker service: mailpit, db, tunnel, storage
 
-  ${pc.bold('6. Quality & Deployment')}
+  ${pc.bold('7. Quality & Deployment')}
     ${pc.cyan('test')}            Run the test suite via Turborepo / Vitest
       --coverage      Generate coverage reports
       --diff          Run test coverage only for files modified on the branch
     ${pc.cyan('lint')}            Run ESLint quality checks
+    ${pc.cyan('setup:cloudflare')} (alias: ${pc.cyan('setup:cf')})
+      Interactive 1-step Cloudflare provisioning (D1, R2, Presigned S3 secrets)
+      --name <n>      Project name override
+      --yes, -y       Non-interactive mode
     ${pc.cyan('deploy')}          Compile, test, deploy to Cloudflare environment
-      --skip-seed     Skip remote seed:load step
       --skip-check    Skip /admin reachability check
     ${pc.cyan('doctor')}          Execute React diagnostics check on Dashboard
 `)
@@ -103,78 +116,10 @@ function help() {
 function cmdBuild() {
   console.log(
     '\nNo build step needed for BeechCMS projects.\n' +
-    'Edit seeds.ts then run `npx beech seed:load` to sync schema changes to D1.\n'
+    'Manage content types dynamically in the BeechCMS Dashboard at /admin.\n'
   )
 }
 
-async function tryLoadLocalRegistry() {
-  const cwd = process.cwd()
-
-  // Try compiled JS first (root or apps/api)
-  const searchDirs = [cwd, resolve(cwd, 'apps', 'api')]
-  for (const dir of searchDirs) {
-    for (const name of ['seeds.js', 'seeds.mjs', 'seed.js', 'seed.mjs']) {
-      const p = resolve(dir, name)
-      if (existsSync(p)) {
-        try {
-          const mod = await import(pathToFileURL(p).href)
-          if (mod.SEED_REGISTRY && typeof mod.SEED_REGISTRY === 'object') {
-            return mod.SEED_REGISTRY
-          }
-          if (Array.isArray(mod.seeds)) {
-            return Object.fromEntries(mod.seeds.map(s => [s.slug, s]))
-          }
-          if (Array.isArray(mod.default)) {
-            return Object.fromEntries(mod.default.map(s => [s.slug, s]))
-          }
-        } catch {}
-      }
-    }
-  }
-
-  // Try seeds.ts / seed.ts (root or apps/api)
-  let tsPath = null
-  for (const dir of searchDirs) {
-    const p = existsSync(resolve(dir, 'seeds.ts')) 
-      ? resolve(dir, 'seeds.ts') 
-      : resolve(dir, 'seed.ts')
-    if (existsSync(p)) {
-      tsPath = p
-      break
-    }
-  }
-
-  if (tsPath) {
-    const result = spawnSync(process.execPath, [
-      '--experimental-strip-types',
-      '--input-type=module',
-      '--eval',
-      `
-import * as mod from ${JSON.stringify(pathToFileURL(tsPath).href)};
-let out = null;
-if (mod.SEED_REGISTRY && typeof mod.SEED_REGISTRY === 'object') out = mod.SEED_REGISTRY;
-else if (Array.isArray(mod.seeds)) out = Object.fromEntries(mod.seeds.map(s => [s.slug, s]));
-else if (Array.isArray(mod.default)) out = Object.fromEntries(mod.default.map(s => [s.slug, s]));
-if (out) process.stdout.write(JSON.stringify(out));
-      `.trim(),
-    ], { encoding: 'utf-8' })
-    
-    if (result.status === 0 && result.stdout) {
-      try { return JSON.parse(result.stdout) } catch (err) {
-        console.error('  Failed to parse seeds.ts output:', err)
-      }
-    } else if (result.status !== 0) {
-      console.error('  Error loading seeds.ts:')
-      console.error(result.stderr || result.stdout || 'Unknown error')
-      if (process.version.slice(1).split('.')[0] < 22) {
-        console.warn('  Note: Node.js 22.6+ is required to load .ts files directly. Current version:', process.version)
-      }
-    }
-  }
-
-  return null
-}
-
 async function cmdInit(args) {
   const initDb  = args.includes('--db')
   const remote  = args.includes('--remote')
@@ -183,26 +128,17 @@ async function cmdInit(args) {
   const yes     = args.includes('--yes') || args.includes('-y')
 
   const { init } = await import('@beechcms/cli')
-  await init({ initDb, local: !remote, db, yes })
+  await init({ initDb, local: !remote, db, nonInteractive: yes })
 }
 
-async function cmdSeedLoad(args) {
-  const dryRun = args.includes('--dry-run')
-  const diff   = args.includes('--diff')
-  const remote = args.includes('--remote')
-  const dbIdx  = args.indexOf('--db')
-  const db     = dbIdx !== -1 ? args[dbIdx + 1] : undefined
-
-  const registry = await tryLoadLocalRegistry()
-
+async function cmdSeedLoad(_args) {
   const { seedLoad } = await import('@beechcms/cli')
-  await seedLoad({ dryRun, diff, local: !remote, db, registry })
+  await seedLoad({})
 }
 
-async function cmdValidate(args) {
-  const registry = await tryLoadLocalRegistry()
+async function cmdValidate(_args) {
   const { validate } = await import('@beechcms/cli')
-  await validate({ registry })
+  await validate({})
 }
 
 async function cmdSeedCreate(_args) {
@@ -213,9 +149,8 @@ async function cmdSeedCreate(_args) {
 async function cmdDeploy(args) {
   const skipSeed  = args.includes('--skip-seed')
   const skipCheck = args.includes('--skip-check')
-  const registry  = skipSeed ? null : await tryLoadLocalRegistry()
   const { deploy } = await import('@beechcms/cli')
-  await deploy({ registry, skipSeed, skipCheck })
+  await deploy({ skipSeed, skipCheck })
 }
 
 async function cmdUpdate(_args) {
@@ -228,9 +163,8 @@ async function cmdOnboard(args) {
   const yes      = args.includes('--yes') || args.includes('-y')
   const dbIdx    = args.indexOf('--db')
   const db       = dbIdx !== -1 ? args[dbIdx + 1] : undefined
-  const registry = await tryLoadLocalRegistry()
   const { onboard } = await import('@beechcms/cli')
-  await onboard({ local, yes, db, registry })
+  await onboard({ local, yes, db })
 }
 
 async function cmdReset(args) {
@@ -250,22 +184,44 @@ async function cmdSchemaDiff(args) {
   const name    = nameIdx !== -1 ? args[nameIdx + 1] : undefined
   const dbIdx   = args.indexOf('--db')
   const db      = dbIdx !== -1 ? args[dbIdx + 1] : undefined
-  const registry = await tryLoadLocalRegistry()
   const { schemaDiff } = await import('@beechcms/cli')
-  await schemaDiff({ local: !remote, write, name, db, registry })
+  await schemaDiff({ local: !remote, write, name, db })
 }
 
 async function cmdGenerateTypes(args) {
+  const remote = args.includes('--remote')
+  const local = !remote
+
+  let out = null
   const outIdx = args.indexOf('--out')
-  const out    = outIdx !== -1 ? args[outIdx + 1] : 'src/types/beech.ts'
-  const local  = args.includes('--local')
-  const dbIdx  = args.indexOf('--db')
-  const db     = dbIdx !== -1 ? args[dbIdx + 1] : undefined
+  const outputIdx = args.indexOf('--output')
+  const oIdx = args.indexOf('-o')
+  
+  if (outIdx !== -1 && args[outIdx + 1]) out = args[outIdx + 1]
+  else if (outputIdx !== -1 && args[outputIdx + 1]) out = args[outputIdx + 1]
+  else if (oIdx !== -1 && args[oIdx + 1]) out = args[oIdx + 1]
 
-  const registry = local ? await tryLoadLocalRegistry() : null
+  const dbIdx = args.indexOf('--db')
+  const db = dbIdx !== -1 ? args[dbIdx + 1] : undefined
 
   const { generateTypes } = await import('@beechcms/cli')
-  await generateTypes({ out, local, db, registry })
+  await generateTypes({ out, local, db })
+}
+
+async function cmdForms(args) {
+  const yes = args.includes('--yes') || args.includes('-y')
+  const json = args.includes('--json')
+  const frameworkIdx = args.indexOf('--framework')
+  const framework = frameworkIdx !== -1 ? args[frameworkIdx + 1] : undefined
+  const seedIdx = args.indexOf('--seed')
+  const seed = seedIdx !== -1 ? args[seedIdx + 1] : undefined
+  const modeIdx = args.indexOf('--mode')
+  const mode = modeIdx !== -1 ? args[modeIdx + 1] : undefined
+  const outIdx = args.indexOf('--out')
+  const out = outIdx !== -1 ? args[outIdx + 1] : undefined
+
+  const { forms } = await import('@beechcms/cli')
+  await forms({ framework, seed, mode, out, yes, json })
 }
 
 // New unified command wrappers:
@@ -328,10 +284,18 @@ async function cmdDoctor(args) {
   await doctor()
 }
 
+async function cmdSetupCloudflare(args) {
+  const yes = args.includes('--yes') || args.includes('-y')
+  const nameIdx = args.indexOf('--name')
+  const projectName = nameIdx !== -1 ? args[nameIdx + 1] : undefined
+  const { setupCloudflare } = await import('@beechcms/cli')
+  await setupCloudflare({ projectName, nonInteractive: yes })
+}
+
 const handler = COMMANDS[command]
 if (!handler) {
   help()
-  if (command) process.exit(1)
+  if (command && command !== '--help' && command !== '-h' && command !== 'help') process.exit(1)
 } else if (args.includes('--help') || args.includes('-h')) {
   help()
 } else {

package/bin/create.mjs

@@ -3,7 +3,7 @@
 
 import * as p from '@clack/prompts'
 import pc from 'picocolors'
-import { execSync } from 'node:child_process'
+import { spawnSync, execSync } from 'node:child_process'
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
 import { resolve, join } from 'node:path'
 import { randomBytes } from 'node:crypto'
@@ -12,78 +12,6 @@ import { dirname } from 'node:path'
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
 
-// ── Template registry ─────────────────────────────────────────────────────────
-
-const TEMPLATES = {
-  blog: {
-    label: 'Blog',
-    hint: 'posts with rich text, cover image, tags and authors',
-    file: 'blog.ts',
-    registryEntries: ['posts: POST_SEED', 'authors: AUTHOR_SEED'],
-  },
-  gallery: {
-    label: 'Gallery',
-    hint: 'media items with image, tags and featured flag',
-    file: 'gallery.ts',
-    registryEntries: ['gallery: GALLERY_SEED'],
-  },
-  contact: {
-    label: 'Contact',
-    hint: 'public form submissions with masked email and read status',
-    file: 'contact.ts',
-    registryEntries: ['messages: MESSAGE_SEED'],
-  },
-  commerce: {
-    label: 'Commerce',
-    hint: 'e-commerce product catalog with prices, inventory and ratings',
-    file: 'commerce.ts',
-    registryEntries: ['products: PRODUCT_SEED', 'reviews: REVIEW_SEED'],
-  },
-  tasks: {
-    label: 'Tasks',
-    hint: 'project management tasks with progress slider',
-    file: 'tasks.ts',
-    registryEntries: ['tasks: TASK_SEED'],
-  },
-}
-
-function readTemplate(filename) {
-  return readFileSync(join(__dirname, 'templates', filename), 'utf8')
-}
-
-function buildSeedsFile(selectedKeys) {
-  const header = `import type { Seed } from '@beechcms/core'\n\n`
-
-  if (selectedKeys.length === 0) {
-    const example = readFileSync(join(__dirname, 'templates', 'empty.ts'), 'utf8')
-    return (
-      header +
-      example +
-      '\nexport const SEED_REGISTRY: Record<string, Seed> = {}\n\n' +
-      'export function getSeed(slug: string): Seed | null {\n' +
-      '  return SEED_REGISTRY[slug] ?? null\n' +
-      '}\n'
-    )
-  }
-
-  const blocks = selectedKeys.map((key) =>
-    readFileSync(join(__dirname, 'templates', TEMPLATES[key].file), 'utf8')
-  )
-
-  const registryEntries = selectedKeys.flatMap((key) => TEMPLATES[key].registryEntries)
-  const registry =
-    'export const SEED_REGISTRY: Record<string, Seed> = {\n' +
-    registryEntries.map((e) => `  ${e},`).join('\n') +
-    '\n}\n'
-
-  const getSeed =
-    '\nexport function getSeed(slug: string): Seed | null {\n' +
-    '  return SEED_REGISTRY[slug] ?? null\n' +
-    '}\n'
-
-  return header + blocks.join('\n') + '\n' + registry + getSeed
-}
-
 // ── Helpers ───────────────────────────────────────────────────────────────────
 
 function generateSecret(bytes = 32) {
@@ -97,16 +25,11 @@ function writeFile(path, content) {
 function buildWorkerTs() {
   return `/// <reference types="@cloudflare/workers-types" />
 import { createBeechApp } from '@beechcms/api'
-import { SEED_REGISTRY } from './seeds'
 
-export default createBeechApp({ seeds: Object.values(SEED_REGISTRY) })
+export default createBeechApp({ seeds: [] })
 `
 }
 
-function buildSeedsTs(selectedKeys) {
-  return buildSeedsFile(selectedKeys)
-}
-
 function getCurrentVersion() {
   try {
     const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8'))
@@ -126,8 +49,6 @@ function buildPackageJson(name) {
     scripts: {
       dev: 'wrangler dev --port 8789',
       deploy: 'wrangler deploy --minify',
-      'seed:load': 'npx beech seed:load',
-      'seed:load:local': 'npx beech seed:load --local',
       'db:migrate:local': 'wrangler d1 migrations apply ' + name + '-db --local',
       'db:reset:local': 'node -e "require(\'fs\').rmSync(\'.wrangler/state\',{recursive:true,force:true})" && npm run db:migrate:local',
     },
@@ -136,6 +57,7 @@ function buildPackageJson(name) {
       '@beechcms/core': version,
     },
     devDependencies: {
+      '@beechcms/cms': version,
       '@cloudflare/workers-types': '^4.0.0',
       wrangler: '^4.0.0',
       typescript: '^5.0.0',
@@ -148,6 +70,7 @@ function buildWranglerJsonc(cfg) {
   "name": "${cfg.name}-api",
   "main": "worker.ts",
   "compatibility_date": "2025-01-01",
+  "compatibility_flags": ["nodejs_compat"],
 
   "vars": {
     "JWT_SECRET": "${cfg.jwtSecret}",
@@ -184,6 +107,8 @@ function buildWranglerJsonc(cfg) {
 function buildDevVars(cloudflare) {
   if (cloudflare) {
     return [
+      `# Cloudflare R2 S3 credentials (required for direct client upload via Presigned URLs)`,
+      `# Guide: https://developers.cloudflare.com/r2/api/s3/tokens/`,
       `R2_ACCESS_KEY_ID=${cloudflare.r2AccessKey}`,
       `R2_SECRET_ACCESS_KEY=${cloudflare.r2SecretKey}`,
       `R2_ENDPOINT=${cloudflare.r2Endpoint}`,
@@ -191,9 +116,8 @@ function buildDevVars(cloudflare) {
     ].join('\n') + '\n'
   }
   return [
-    '# R2 credentials — only needed if you want production-like S3 media uploads locally.',
-    '# For local development, media uploads work automatically via the Miniflare R2 binding.',
-    '# Fill these in only when testing production media behaviour:',
+    '# Cloudflare R2 S3 credentials (required for direct client upload via Presigned URLs)',
+    '# Create an R2 API Token: Cloudflare Dashboard → R2 → "Manage R2 API Tokens" (Object Read & Write)',
     '# Guide: https://developers.cloudflare.com/r2/api/s3/tokens/',
     'R2_ACCESS_KEY_ID=',
     'R2_SECRET_ACCESS_KEY=',
@@ -238,35 +162,57 @@ async function askCloudflareConfig(name) {
   })
   if (p.isCancel(accountId)) return null
 
-  const d1Name = await p.text({
-    message: 'D1 Database name',
-    initialValue: `${name}-db`,
-    validate: (v) => { if (!v.trim()) return 'Required' },
+  const autoCreate = await p.confirm({
+    message: `Auto-create Cloudflare D1 (${name}-db) and R2 (${name}-media) now?`,
+    hint: 'Runs `wrangler d1 create` and `wrangler r2 bucket create`',
+    initialValue: true,
   })
-  if (p.isCancel(d1Name)) return null
+  if (p.isCancel(autoCreate)) return null
+
+  let d1Id = ''
+  const d1Name = `${name}-db`
+  const r2Bucket = `${name}-media`
+
+  if (autoCreate) {
+    const s = p.spinner()
+    s.start(`Creating D1 database: ${pc.bold(d1Name)}…`)
+    const d1Res = spawnSync('npx', ['wrangler', 'd1', 'create', d1Name], { encoding: 'utf-8', shell: true })
+    const d1Out = (d1Res.stdout || '') + (d1Res.stderr || '')
+    const idMatch = d1Out.match(/database_id\s*=\s*["']?([a-f0-9-]{36})["']?/i) ||
+                    d1Out.match(/"database_id":\s*"([a-f0-9-]{36})"/i) ||
+                    d1Out.match(/([a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})/i)
+    if (idMatch) {
+      d1Id = idMatch[1]
+      s.stop(pc.green(`✓ D1 database ready (${d1Id})`))
+    } else {
+      s.stop(pc.yellow(`ℹ D1 status: ${d1Out.trim().slice(0, 100)}`))
+    }
 
-  const d1Id = await p.text({
-    message: 'D1 Database ID',
-    placeholder: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
-    hint: `Run: npx wrangler d1 create ${d1Name} — copy the "database_id" from the output`,
-    validate: (v) => { if (!v.trim()) return 'Required — create the D1 database first and paste its ID here' },
-  })
-  if (p.isCancel(d1Id)) return null
+    s.start(`Creating R2 bucket: ${pc.bold(r2Bucket)}…`)
+    spawnSync('npx', ['wrangler', 'r2', 'bucket', 'create', r2Bucket], { encoding: 'utf-8', shell: true })
+    s.stop(pc.green(`✓ R2 bucket ready (${r2Bucket})`))
+  }
 
-  const r2Bucket = await p.text({
-    message: 'R2 Bucket name',
-    initialValue: `${name}-media`,
-    validate: (v) => { if (!v.trim()) return 'Required' },
-  })
-  if (p.isCancel(r2Bucket)) return null
+  if (!d1Id) {
+    const d1IdInput = await p.text({
+      message: 'D1 Database ID',
+      placeholder: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
+      hint: `Run: npx wrangler d1 create ${d1Name} — paste the "database_id" here`,
+      validate: (v) => { if (!v.trim()) return 'Required — paste database_id from D1' },
+    })
+    if (p.isCancel(d1IdInput)) return null
+    d1Id = d1IdInput.trim()
+  }
 
   p.note(
     [
+      'Direct client uploads use Presigned URLs (SigV4) to stream files directly to R2.',
       'Create an R2 API token:',
       '  Cloudflare Dashboard → R2 → "Manage R2 API Tokens"',
       `  → Create Token → Object Read & Write → bucket: ${r2Bucket}`,
+      'Guide: https://developers.cloudflare.com/r2/api/s3/tokens/',
     ].join('\n'),
-    'R2 credentials'
+    'R2 S3 Credentials (for Presigned URLs)'
   )
 
   const r2AccessKey = await p.text({
@@ -309,17 +255,14 @@ async function main() {
   console.log()
   p.intro(pc.bgGreen(pc.black(' @beechcms/cms ')))
 
-  let name, selectedTemplates, cloudflare
+  let name, cloudflare
 
   if (silent) {
     // Non-interactive: use first positional arg or default name, skip Cloudflare
     const positional = argv.find((a) => !a.startsWith('-'))
     name = positional ?? 'my-beech-project'
-    const withExamples = argv.includes('--with-examples') || argv.includes('--examples')
-    selectedTemplates = withExamples ? ['blog'] : []
     cloudflare = null
-    const examplesNote = withExamples ? ' (with blog example content types)' : ''
-    console.log(pc.dim(`  Running in non-interactive mode. Project name: ${name}${examplesNote}`))
+    console.log(pc.dim(`  Running in non-interactive mode. Project name: ${name}`))
   } else {
     // Project name
     const projectName = await p.text({
@@ -333,22 +276,6 @@ async function main() {
     if (p.isCancel(projectName)) { p.cancel('Cancelled'); process.exit(0) }
     name = projectName.trim()
 
-    // Content types
-    const tmpl = await p.multiselect({
-      message: 'Which content types do you need?',
-      hint: 'Space to select, Enter to confirm. You can add more later in seeds.ts',
-      options: [
-        { value: 'blog',    label: 'Blog',    hint: 'posts with rich text, cover image, tags and authors' },
-        { value: 'gallery', label: 'Gallery', hint: 'media items with image, tags and featured flag' },
-        { value: 'contact', label: 'Contact', hint: 'public form submissions with masked email and read status' },
-        { value: 'commerce',label: 'Commerce',hint: 'e-commerce product catalog with prices, inventory and ratings' },
-        { value: 'tasks',   label: 'Tasks',   hint: 'project management tasks with progress slider' },
-      ],
-      required: false,
-    })
-    if (p.isCancel(tmpl)) { p.cancel('Cancelled'); process.exit(0) }
-    selectedTemplates = tmpl
-
     // Cloudflare now or later?
     const configureNow = await p.confirm({
       message: 'Configure Cloudflare credentials now?',
@@ -384,7 +311,6 @@ async function main() {
 
   mkdirSync(targetDir, { recursive: true })
 
-  writeFile(join(targetDir, 'seeds.ts'), buildSeedsTs(selectedTemplates))
   writeFile(join(targetDir, 'worker.ts'), buildWorkerTs())
   writeFile(join(targetDir, 'package.json'), buildPackageJson(name))
   writeFile(join(targetDir, 'tsconfig.json'), buildTsConfig())
@@ -429,10 +355,17 @@ async function main() {
       ...(pendingConfig ? [
         `${pc.bold('3. Complete Cloudflare configuration')}  ${pc.yellow('← pending')}`,
         `   Edit ${pc.underline('wrangler.jsonc')}  →  fill in ${pc.yellow('database_id')} (D1) and ${pc.yellow('bucket_name')} (R2)`,
-        `   Guide: https://developers.cloudflare.com/d1/`,
-        `   ${pc.dim('Note: media uploads work locally without R2 credentials (.dev.vars optional)')}`,
+        `   Set R2 S3 secrets for Presigned uploads in ${pc.underline('.dev.vars')} (dev) and via ${pc.cyan('npx wrangler secret put')} (prod)`,
+        `   Guide: https://developers.cloudflare.com/r2/api/s3/tokens/`,
         '',
-      ] : []),
+      ] : [
+        `${pc.bold('3. Production R2 secrets')} (when deploying to Cloudflare)`,
+        `   ${pc.cyan('npx wrangler secret put R2_ACCESS_KEY_ID')}`,
+        `   ${pc.cyan('npx wrangler secret put R2_SECRET_ACCESS_KEY')}`,
+        `   ${pc.cyan('npx wrangler secret put R2_ENDPOINT')}  →  ${cloudflare.r2Endpoint}`,
+        `   ${pc.cyan('npx wrangler secret put R2_BUCKET_NAME')}  →  ${cloudflare.r2Bucket}`,
+        '',
+      ]),
       `${step(3)}. Run local migrations`,
       `   ${pc.cyan('npm run db:migrate:local')}`,
       '',
@@ -443,7 +376,7 @@ async function main() {
       `${step(5)}. Deploy to production`,
       `   ${pc.cyan('npm run deploy')}`,
       '',
-      `${pc.dim('Your content types are defined in seeds.ts')}`,
+      `${pc.dim('Manage content types dynamically in the BeechCMS Dashboard at /admin.')}`,
       `${pc.dim('JWT secret and API keys have been auto-generated.')}`,
     ].join('\n'),
     'Next steps'
@@ -455,3 +388,4 @@ main().catch((err) => {
   console.error(err)
   process.exit(1)
 })
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beechcms/cms",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Edge-Native, Schema-Driven Headless CMS built on Cloudflare Workers, D1, and R2. Features the Botanical Engine for alias-stable field management, a modular widget layer, and a React + Vite admin dashboard.",
   "keywords": [
     "cms",
@@ -33,6 +33,8 @@
     "node": ">=18.0.0"
   },
   "bin": {
+    "cms": "bin/create.mjs",
+    "@beechcms/cms": "bin/create.mjs",
     "beechcms": "bin/create.mjs",
     "beech": "bin/cli.mjs"
   },
@@ -59,7 +61,7 @@
     "vitest": "^4.1.0"
   },
   "dependencies": {
-    "@beechcms/cli": "^0.7.0",
+    "@beechcms/cli": "^0.8.0",
     "@clack/prompts": "^0.9.1",
     "picocolors": "^1.1.1"
   },
@@ -76,9 +78,10 @@
     }
   },
   "scripts": {
-    "docs:generate": "typedoc",
+    "docs:generate": "turbo run build && typedoc",
     "docs:dev": "vitepress dev docs",
-    "docs:build": "typedoc && vitepress build docs",
+    "docs:check": "node scripts/docs-fact-check.mjs",
+    "docs:build": "turbo run build && typedoc && node scripts/docs-fact-check.mjs && vitepress build docs",
     "docs:preview": "vitepress preview docs",
     "beech": "node bin/cli.mjs",
     "dev": "node scripts/dev.mjs",
@@ -103,6 +106,10 @@
     "setup:graph": "node scripts/setup-graph.mjs",
     "release": "node scripts/release.mjs",
     "release:preview": "node scripts/release.mjs --preview",
+    "release:current": "node scripts/release.mjs --current",
+    "version:list": "node scripts/release.mjs list",
+    "version:get": "node scripts/release.mjs get",
+    "version:set": "node scripts/release.mjs set",
     "postinstall": "node scripts/check-docker.mjs",
     "doctor": "react-doctor -y --no-dead-code"
   }

package/bin/templates/blog.ts

@@ -1,35 +0,0 @@
-/** Post: blog article with rich text, cover image, tags and SEO */
-export const POST_SEED: Seed = {
-  slug: 'posts',
-  label: 'Post',
-  labelPlural: 'Posts',
-  displayNameAlias: 'title',
-  allowPublicRead: true,
-  allowDrafts: true,
-  branches: [
-    { id: 'pst_01', alias: 'title',           label: 'Title',                type: 'text',     requiredOnCreate: true },
-    { id: 'pst_02', alias: 'publishedAt',      label: 'Published at',         type: 'date' },
-    { id: 'pst_03', alias: 'coverImage',       label: 'Cover image',          type: 'file', fileOptions: { accept: 'image' } },
-    { id: 'pst_04', alias: 'excerpt',          label: 'Excerpt',              type: 'text' },
-    { id: 'pst_05', alias: 'tags',             label: 'Tags',                 type: 'json',     options: ['news', 'tutorial', 'release', 'guide', 'opinion'] },
-    { id: 'pst_06', alias: 'body',             label: 'Body',                 type: 'richtext' },
-    { id: 'pst_07', alias: 'metaTitle',        label: 'Meta title (SEO)',     type: 'text' },
-    { id: 'pst_08', alias: 'metaDescription',  label: 'Meta description (SEO)', type: 'text' },
-  ],
-}
-
-/** Author: content creator profile with photo and social link */
-export const AUTHOR_SEED: Seed = {
-  slug: 'authors',
-  label: 'Author',
-  labelPlural: 'Authors',
-  displayNameAlias: 'name',
-  allowPublicRead: true,
-  branches: [
-    { id: 'aut_01', alias: 'name',    label: 'Name',        type: 'text', requiredOnCreate: true },
-    { id: 'aut_02', alias: 'bio',     label: 'Bio',         type: 'text' },
-    { id: 'aut_03', alias: 'photo',   label: 'Photo',       type: 'file', fileOptions: { accept: 'image' } },
-    { id: 'aut_04', alias: 'website', label: 'Website URL', type: 'text' },
-    { id: 'aut_05', alias: 'active',  label: 'Active',      type: 'boolean' },
-  ],
-}

package/bin/templates/commerce.ts

@@ -1,29 +0,0 @@
-/** Product: e-commerce product catalog with prices, inventory and ratings */
-export const PRODUCT_SEED: Seed = {
-  slug: 'products',
-  label: 'Product',
-  labelPlural: 'Products',
-  displayNameAlias: 'name',
-  allowPublicRead: true,
-  branches: [
-    { alias: 'name',        label: 'Product Name', type: 'text', requiredOnCreate: true },
-    { alias: 'description', label: 'Description',  type: 'richtext' },
-    { alias: 'price',       label: 'Price',        type: 'number', numberOptions: { format: 'currency', currency: 'EUR', decimals: 2, min: 0, control: 'input', prefix: '€' } },
-    { alias: 'inventory',   label: 'Stock level',  type: 'number', numberOptions: { min: 0, step: 1, control: 'stepper' } },
-    { alias: 'rating',      label: 'Rating',       type: 'number', numberOptions: { min: 1, max: 5, step: 0.5, control: 'rating' } }
-  ],
-}
-
-/** Review: product review */
-export const REVIEW_SEED: Seed = {
-  slug: 'reviews',
-  label: 'Review',
-  labelPlural: 'Reviews',
-  displayNameAlias: 'title',
-  allowPublicRead: true,
-  branches: [
-    { alias: 'title',   label: 'Review Title', type: 'text', requiredOnCreate: true },
-    { alias: 'body',    label: 'Body',         type: 'text' },
-    { alias: 'score',   label: 'Score',        type: 'number', numberOptions: { min: 1, max: 5, step: 1, control: 'rating' } }
-  ],
-}

package/bin/templates/contact.ts

@@ -1,23 +0,0 @@
-/**
- * Message: public contact form submission.
- *
- * allowPublicPost: true  — the Public API accepts POST requests without authentication,
- *                          so any frontend form can submit directly to this seed.
- * email visibility:masked — the email is stored in full but returned partially
- *                           redacted in API responses (e.g. "jo**@example.com").
- * email public:false      — the email is never exposed through the Public API.
- */
-export const MESSAGE_SEED: Seed = {
-  slug: 'messages',
-  label: 'Message',
-  labelPlural: 'Messages',
-  displayNameAlias: 'name',
-  allowPublicPost: true,
-  branches: [
-    { id: 'msg_01', alias: 'name',    label: 'Name',    type: 'text',     requiredOnCreate: true },
-    { id: 'msg_02', alias: 'email',   label: 'Email',   type: 'text',     requiredOnCreate: true, policies: { visibility: 'masked', public: false } },
-    { id: 'msg_03', alias: 'subject', label: 'Subject', type: 'text',     requiredOnCreate: true },
-    { id: 'msg_04', alias: 'message', label: 'Message', type: 'richtext', requiredOnCreate: true },
-    { id: 'msg_05', alias: 'read',    label: 'Read',    type: 'boolean' },
-  ],
-}

package/bin/templates/empty.ts

@@ -1,41 +0,0 @@
-/**
- * Your seeds go here.
- *
- * A Seed defines a content type: its slug (used in API URLs), its display labels,
- * and its branches (fields).
- *
- * Each Branch has:
- *   id     — immutable database key (e.g. 'abc_01'). Never change this after
- *             the first migration or stored data will break.
- *   alias  — the name used in API payloads (e.g. 'title'). Safe to rename.
- *   label  — human-readable label shown in the dashboard.
- *   type   — 'text' | 'number' | 'boolean' | 'date' | 'richtext' | 'file' | 'json'
- *
- * Seed-level flags:
- *   allowPublicRead  — expose entries via the unauthenticated Public API (GET).
- *   allowPublicPost  — accept submissions via the Public API (POST). Useful for forms.
- *   allowDrafts      — enable a pending-draft workflow for this content type.
- *   displayNameAlias — which branch alias is used as the entry title in the dashboard.
- *
- * Branch policies (all optional):
- *   policies.visibility  — 'full' (default) | 'masked' | 'hidden'
- *   policies.public      — false to exclude the field from Public API responses
- *   policies.search      — false to exclude the field from full-text search
- *
- * Example — uncomment and adapt to define your first content type:
- *
- * export const PROJECT_SEED: Seed = {
- *   slug: 'projects',
- *   label: 'Project',
- *   labelPlural: 'Projects',
- *   displayNameAlias: 'title',
- *   allowPublicRead: true,
- *   branches: [
- *     { id: 'prj_01', alias: 'title',       label: 'Title',       type: 'text', requiredOnCreate: true },
- *     { id: 'prj_02', alias: 'description', label: 'Description', type: 'text' },
- *     { id: 'prj_03', alias: 'coverImage',  label: 'Cover image', type: 'file' },
- *     { id: 'prj_04', alias: 'tags',        label: 'Tags',        type: 'json' },
- *     { id: 'prj_05', alias: 'published',   label: 'Published',   type: 'boolean' },
- *   ],
- * }
- */

package/bin/templates/gallery.ts

@@ -1,16 +0,0 @@
-/** Gallery item: image or media asset with title, tags and featured flag */
-export const GALLERY_SEED: Seed = {
-  slug: 'gallery',
-  label: 'Item',
-  labelPlural: 'Gallery',
-  displayNameAlias: 'title',
-  allowPublicRead: true,
-  branches: [
-    { id: 'gal_01', alias: 'title',       label: 'Title',       type: 'text', requiredOnCreate: true },
-    { id: 'gal_02', alias: 'description', label: 'Description', type: 'text' },
-    { id: 'gal_03', alias: 'image',       label: 'Image',       type: 'file', requiredOnCreate: true, fileOptions: { accept: 'image' } },
-    { id: 'gal_04', alias: 'tags',        label: 'Tags',        type: 'json' },
-    { id: 'gal_05', alias: 'date',        label: 'Date',        type: 'date' },
-    { id: 'gal_06', alias: 'featured',    label: 'Featured',    type: 'boolean' },
-  ],
-}

package/bin/templates/tasks.ts

@@ -1,12 +0,0 @@
-/** Task: project management tasks with progress slider */
-export const TASK_SEED: Seed = {
-  slug: 'tasks',
-  label: 'Task',
-  labelPlural: 'Tasks',
-  displayNameAlias: 'title',
-  branches: [
-    { alias: 'title',      label: 'Task Title', type: 'text', requiredOnCreate: true },
-    { alias: 'taskStatus', label: 'Status',     type: 'text', options: ['todo', 'in_progress', 'done'] },
-    { alias: 'completion', label: 'Completion', type: 'number', numberOptions: { format: 'percentage', min: 0, max: 100, step: 5, control: 'slider' } }
-  ],
-}