create-kyro 0.1.0

package/src/generators/astro.ts

@@ -0,0 +1,38 @@
+import type { Answers } from '../prompts.js';
+
+export function generateAstroConfig(answers: Answers): string {
+  const integrations: string[] = [];
+  const vitePlugins: string[] = [];
+
+  if (answers.styling === 'tailwind') {
+    integrations.push("  react(),");
+    vitePlugins.push("    tailwindcss(),");
+  }
+
+  const adapter = answers.admin ? `
+  adapter: node({
+    mode: 'standalone'
+  }),` : '';
+
+  const config = `import { defineConfig } from 'astro/config';
+${answers.styling === 'tailwind' ? "import react from '@astrojs/react';\nimport tailwindcss from '@tailwindcss/vite';" : ''}
+
+export default defineConfig({
+  output: 'server',${adapter}
+
+  integrations: [
+${integrations.join('\n')}
+  ],${vitePlugins.length > 0 ? `
+  vite: {
+    plugins: [
+${vitePlugins.join('\n')}
+    ],
+  },` : ''}
+  server: {
+    port: 4321,
+    host: true,
+  },
+});`;
+
+  return config;
+}

package/src/generators/config.ts

@@ -0,0 +1,80 @@
+import type { Answers } from '../prompts.js';
+
+export function generateKyroConfig(answers: Answers): string {
+  const imports: string[] = ["import { defineConfig } from '@kyro-cms/core';"];
+  const adapterLines: string[] = [];
+
+  if (answers.database === 'sqlite') {
+    imports.push("import { localAdapter } from '@kyro-cms/core';");
+    adapterLines.push(`  adapter: localAdapter({ path: './data.db' }),`);
+  } else if (answers.database === 'postgres') {
+    imports.push("import { drizzleAdapter } from '@kyro-cms/core';");
+    adapterLines.push(`  adapter: drizzleAdapter({`);
+    adapterLines.push(`    connectionString: process.env.DATABASE_URL,`);
+    adapterLines.push(`  }),`);
+  } else if (answers.database === 'mysql') {
+    imports.push("import { drizzleAdapter } from '@kyro-cms/core';");
+    adapterLines.push(`  adapter: drizzleAdapter({`);
+    adapterLines.push(`    connectionString: process.env.DATABASE_URL,`);
+    adapterLines.push(`  }),`);
+  } else if (answers.database === 'mongodb') {
+    imports.push("import { mongoAdapter } from '@kyro-cms/core';");
+    adapterLines.push(`  adapter: mongoAdapter({`);
+    adapterLines.push(`    connectionString: process.env.MONGODB_URI,`);
+    adapterLines.push(`  }),`);
+  }
+
+  const apiConfig: string[] = [];
+  if (answers.apis.includes('rest')) {
+    apiConfig.push("    rest: true,");
+  }
+  if (answers.apis.includes('graphql')) {
+    apiConfig.push("    graphql: true,");
+  }
+  if (answers.apis.includes('trpc')) {
+    apiConfig.push("    trpc: true,");
+  }
+  if (answers.apis.includes('websocket')) {
+    apiConfig.push("    websocket: true,");
+  }
+
+  const features: string[] = [];
+  if (answers.auth) {
+    features.push("  auth: true,");
+  }
+  if (answers.versioning) {
+    features.push("  versioning: true,");
+  }
+
+  let templateImports = '';
+  let collectionsLine = '';
+
+  if (answers.template === 'minimal') {
+    templateImports = `import { minimalCollections } from '@kyro-cms/core';`;
+    collectionsLine = '  ...minimalCollections,';
+  } else if (answers.template === 'blog') {
+    templateImports = `import { blogCollections } from '@kyro-cms/core';`;
+    collectionsLine = '  ...blogCollections,';
+  } else if (answers.template === 'ecommerce') {
+    templateImports = `import { ecommerceCollections } from '@kyro-cms/core';`;
+    collectionsLine = '  ...ecommerceCollections,';
+  }
+
+  const config = `${imports.join('\n')}
+${templateImports}
+
+export default defineConfig({
+  name: '${answers.projectName}',
+  prefix: '/api',${adapterLines.length > 0 ? '\n' + adapterLines.join('\n') : ''}
+
+  collections: {
+${collectionsLine}
+  },${features.length > 0 ? '\n' + features.join('\n') : ''}
+
+  api: {
+${apiConfig.join('\n')}
+  },
+});`;
+
+  return config;
+}

package/src/generators/files.ts

@@ -0,0 +1,159 @@
+import type { Answers } from '../prompts.js';
+import { writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+
+export function generateProjectFiles(answers: Answers, projectDir: string): void {
+  const srcDir = join(projectDir, 'src');
+  const pagesDir = join(srcDir, 'pages');
+  const publicDir = join(projectDir, 'public');
+
+  mkdirSync(pagesDir, { recursive: true });
+  mkdirSync(publicDir, { recursive: true });
+
+  if (answers.database === 'sqlite') {
+    mkdirSync(join(projectDir, 'data'), { recursive: true });
+  }
+
+  const tsconfig = `{
+  "extends": "astro/tsconfigs/strict",
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  }
+}`;
+
+  writeFileSync(join(projectDir, 'tsconfig.json'), tsconfig);
+
+  const gitignore = `node_modules/
+dist/
+.astro/
+data/
+*.db
+.env
+.env.local
+.DS_Store
+`;
+
+  writeFileSync(join(projectDir, '.gitignore'), gitignore);
+
+  const readme = `# ${answers.projectName}
+
+A Kyro CMS project.
+
+## Getting Started
+
+\`\`\`bash
+npm install
+npm run dev
+\`\`\`
+
+## Documentation
+
+Visit [https://kyro.cms](https://kyro.cms) for full documentation.
+`;
+
+  writeFileSync(join(projectDir, 'README.md'), readme);
+
+  const spec = `# ${answers.projectName}
+
+## Overview
+
+This project uses Kyro CMS - an Astro-native headless CMS.
+
+## Configuration
+
+- **Database**: ${answers.database === 'sqlite' ? 'SQLite (local-first)' : answers.database}
+- **APIs**: ${answers.apis.join(', ')}
+- **Styling**: ${answers.styling}
+- **Auth**: ${answers.auth ? 'Enabled' : 'Disabled'}
+- **Versioning**: ${answers.versioning ? 'Enabled' : 'Disabled'}
+- **Admin**: ${answers.admin ? 'Included' : 'Not included'}
+- **Template**: ${answers.template}
+
+## Collections
+
+${
+  answers.template === 'minimal' ? '- Posts' :
+  answers.template === 'blog' ? '- Posts\n- Categories\n- Media' :
+  '- Products\n- Categories\n- Customers\n- Orders\n- Coupons'
+}
+`;
+
+  writeFileSync(join(projectDir, 'SPEC.md'), spec);
+
+  const indexPage = `---
+const title = "${answers.projectName}";
+---
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${answers.projectName}</title>
+  </head>
+  <body>
+    <main>
+      <h1>Welcome to ${answers.projectName}</h1>
+      <p>Your Kyro CMS is ready.</p>
+      ${
+        answers.admin
+          ? '<p><a href="/admin">Go to Admin Dashboard →</a></p>'
+          : ''
+      }
+    </main>
+  </body>
+</html>
+
+<style>
+  main {
+    max-width: 800px;
+    margin: 4rem auto;
+    padding: 2rem;
+    text-align: center;
+    font-family: system-ui, sans-serif;
+  }
+  h1 {
+    font-size: 2.5rem;
+    margin-bottom: 1rem;
+  }
+  p {
+    color: #666;
+  }
+  a {
+    color: #6366f1;
+    text-decoration: none;
+  }
+  a:hover {
+    text-decoration: underline;
+  }
+</style>
+`;
+
+  writeFileSync(join(pagesDir, 'index.astro'), indexPage);
+
+  if (answers.admin) {
+    const adminDir = join(srcDir, 'admin');
+    mkdirSync(adminDir, { recursive: true });
+
+    const adminIndex = `---
+import { Admin } from '@kyro-cms/admin';
+import config from '../kyro.config';
+---
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Admin - ${answers.projectName}</title>
+  </head>
+  <body>
+    <Admin client:load config={config} />
+  </body>
+</html>
+`;
+
+    writeFileSync(join(adminDir, 'index.astro'), adminIndex);
+  }
+}

package/src/generators/packagejson.ts

@@ -0,0 +1,72 @@
+import type { Answers } from '../prompts.js';
+
+export interface PackageJson {
+  name: string;
+  version: string;
+  type: string;
+  private: boolean;
+  scripts: Record<string, string>;
+  dependencies: Record<string, string>;
+  devDependencies: Record<string, string>;
+}
+
+export function generatePackageJson(answers: Answers, projectDir: string): PackageJson {
+  const deps: Record<string, string> = {
+    '@kyro-cms/core': 'latest',
+    'astro': '^5.4.0'
+  };
+
+  const devDeps: Record<string, string> = {
+    'typescript': '^5.7.3'
+  };
+
+  if (answers.styling === 'tailwind') {
+    deps['@astrojs/react'] = '^4.2.0';
+    deps['react'] = '^19.0.0';
+    deps['react-dom'] = '^19.0.0';
+    deps['tailwindcss'] = '^4.0.0';
+    deps['@tailwindcss/vite'] = '^4.0.0';
+    devDeps['@types/react'] = '^19.0.0';
+    devDeps['@types/react-dom'] = '^19.0.0';
+  }
+
+  if (answers.database === 'postgres') {
+    deps['pg'] = '^8.13.1';
+    deps['@types/pg'] = '^8.11.0';
+  } else if (answers.database === 'mysql') {
+    deps['mysql2'] = '^3.12.0';
+  } else if (answers.database === 'mongodb') {
+    deps['mongodb'] = '^6.12.0';
+  }
+
+  if (answers.admin) {
+    deps['@kyro-cms/admin'] = 'latest';
+    deps['lucide-react'] = '^0.475.0';
+  }
+
+  const scripts: Record<string, string> = {
+    'dev': 'astro dev',
+    'build': 'astro build',
+    'preview': 'astro preview'
+  };
+
+  if (answers.database === 'sqlite') {
+    scripts['db:generate'] = 'kyro generate';
+    scripts['db:push'] = 'kyro push';
+    scripts['db:studio'] = 'kyro studio';
+  }
+
+  return {
+    name: answers.projectName,
+    version: '0.1.0',
+    type: 'module',
+    private: true,
+    scripts,
+    dependencies: deps,
+    devDependencies: devDeps
+  };
+}
+
+export function formatPackageJson(pkg: PackageJson): string {
+  return JSON.stringify(pkg, null, 2);
+}

package/src/index.ts

@@ -0,0 +1,97 @@
+import { promptUser, type Answers } from './prompts.js';
+import { logger } from './utils/logger.js';
+import { generatePackageJson, formatPackageJson } from './generators/packagejson.js';
+import { generateKyroConfig } from './generators/config.js';
+import { generateAstroConfig } from './generators/astro.js';
+import { generateProjectFiles } from './generators/files.js';
+import { writeFileSync, mkdirSync, cpSync, existsSync } from 'fs';
+import { join } from 'path';
+import { execSync } from 'child_process';
+
+const VERSION = '0.1.0';
+
+async function main() {
+  logger.intro('create-kyro', VERSION);
+
+  const answers = await promptUser();
+  const projectDir = join(process.cwd(), answers.projectName);
+
+  if (existsSync(projectDir)) {
+    logger.error(`Directory "${answers.projectName}" already exists.`);
+    process.exit(1);
+  }
+
+  const steps = [
+    'Creating project directory',
+    'Generating configuration files',
+    'Installing dependencies',
+    'Initializing git repository',
+  ];
+
+  logger.step(1, steps.length, steps[0]);
+  mkdirSync(projectDir, { recursive: true });
+  logger.success('Project directory created');
+
+  logger.step(2, steps.length, steps[1]);
+
+  const pkg = generatePackageJson(answers, projectDir);
+  writeFileSync(
+    join(projectDir, 'package.json'),
+    formatPackageJson(pkg)
+  );
+  logger.success('package.json generated');
+
+  const kyroConfig = generateKyroConfig(answers);
+  writeFileSync(join(projectDir, 'kyro.config.ts'), kyroConfig);
+  logger.success('kyro.config.ts generated');
+
+  const astroConfig = generateAstroConfig(answers);
+  writeFileSync(join(projectDir, 'astro.config.mjs'), astroConfig);
+  logger.success('astro.config.mjs generated');
+
+  generateProjectFiles(answers, projectDir);
+  logger.success('Project files generated');
+
+  logger.step(3, steps.length, steps[2]);
+  console.log('  Installing dependencies...');
+
+  try {
+    execSync('npm install', {
+      cwd: projectDir,
+      stdio: 'inherit',
+      env: { ...process.env, npm_config_loglevel: 'warn' }
+    });
+    logger.success('Dependencies installed');
+  } catch (error) {
+    logger.error('Failed to install dependencies');
+    process.exit(1);
+  }
+
+  logger.step(4, steps.length, steps[3]);
+  try {
+    execSync('git init && git add . && git commit -m "Initial commit - created with create-kyro"', {
+      cwd: projectDir,
+      stdio: 'pipe'
+    });
+    logger.success('Git repository initialized');
+  } catch {
+    logger.warning('Could not initialize git repository');
+  }
+
+  logger.done();
+
+  console.log('  To get started:');
+  console.log(`    ${logger ? '\x1b[36m' : ''}cd ${answers.projectName}${logger ? '\x1b[0m' : ''}`);
+  console.log(`    ${logger ? '\x1b[36m' : ''}npm run dev${logger ? '\x1b[0m' : ''}`);
+  console.log('');
+  console.log('  Visit http://localhost:4321 to see your app.');
+  if (answers.admin) {
+    console.log('  Visit http://localhost:4321/admin for the admin dashboard.');
+  }
+  console.log('');
+}
+
+main().catch((error) => {
+  logger.error(`Unexpected error: ${error.message}`);
+  process.exit(1);
+});

package/src/prompts.ts

@@ -0,0 +1,164 @@
+import prompts from 'prompts';
+import { validateProjectName } from './validators.js';
+
+export interface Answers {
+  projectName: string;
+  database: 'sqlite' | 'postgres' | 'mysql' | 'mongodb';
+  apis: ('rest' | 'graphql' | 'trpc' | 'websocket')[];
+  styling: 'tailwind' | 'cssmodules' | 'styled' | 'none';
+  auth: boolean;
+  versioning: boolean;
+  admin: boolean;
+  template: 'minimal' | 'blog' | 'ecommerce';
+}
+
+export async function promptUser(): Promise<Answers> {
+  const response = await prompts([
+    {
+      type: 'text',
+      name: 'projectName',
+      message: 'Project name:',
+      initial: 'my-kyro-app',
+      validate: validateProjectName
+    },
+    {
+      type: 'select',
+      name: 'database',
+      message: 'Database:',
+      hint: ' ',
+      choices: [
+        {
+          title: 'SQLite (local-first, zero config)',
+          description: 'Best for development and small projects. No setup required.',
+          value: 'sqlite'
+        },
+        {
+          title: 'PostgreSQL',
+          description: 'Recommended for production. Robust and scalable.',
+          value: 'postgres'
+        },
+        {
+          title: 'MySQL',
+          description: 'Popular choice for web applications.',
+          value: 'mysql'
+        },
+        {
+          title: 'MongoDB',
+          description: 'Best for flexible, document-based schemas.',
+          value: 'mongodb'
+        }
+      ]
+    },
+    {
+      type: 'multiselect',
+      name: 'apis',
+      message: 'API protocols (select multiple):',
+      hint: 'Space to select, Enter to confirm',
+      instructions: false,
+      choices: [
+        {
+          title: 'REST',
+          description: 'Simple HTTP API, great for any client',
+          value: 'rest',
+          selected: true
+        },
+        {
+          title: 'GraphQL',
+          description: 'Flexible query language, great for complex data',
+          value: 'graphql',
+          selected: true
+        },
+        {
+          title: 'tRPC',
+          description: 'End-to-end typesafe APIs, great for TypeScript',
+          value: 'trpc'
+        },
+        {
+          title: 'WebSocket',
+          description: 'Real-time bidirectional communication',
+          value: 'websocket'
+        }
+      ]
+    },
+    {
+      type: 'select',
+      name: 'styling',
+      message: 'Styling:',
+      hint: ' ',
+      choices: [
+        {
+          title: 'Tailwind CSS',
+          description: 'Utility-first CSS framework, excellent DX',
+          value: 'tailwind'
+        },
+        {
+          title: 'CSS Modules',
+          description: 'Scoped CSS, no extra dependencies',
+          value: 'cssmodules'
+        },
+        {
+          title: 'Styled Components',
+          description: 'CSS-in-JS with tagged template literals',
+          value: 'styled'
+        },
+        {
+          title: 'None',
+          description: 'Bring your own styling solution',
+          value: 'none'
+        }
+      ]
+    },
+    {
+      type: 'toggle',
+      name: 'auth',
+      message: 'Add authentication (JWT)?',
+      active: 'Yes',
+      inactive: 'No'
+    },
+    {
+      type: 'toggle',
+      name: 'versioning',
+      message: 'Add versioning/drafts?',
+      active: 'Yes',
+      inactive: 'No'
+    },
+    {
+      type: 'toggle',
+      name: 'admin',
+      message: 'Include admin dashboard?',
+      initial: true,
+      active: 'Yes',
+      inactive: 'No'
+    },
+    {
+      type: 'select',
+      name: 'template',
+      message: 'Starting template:',
+      hint: ' ',
+      choices: [
+        {
+          title: 'Minimal',
+          description: 'Basic configuration with one example collection',
+          value: 'minimal'
+        },
+        {
+          title: 'Blog',
+          description: 'Posts, categories, tags, and media library',
+          value: 'blog'
+        },
+        {
+          title: 'E-commerce',
+          description: 'Products, orders, customers, inventory, and coupons',
+          value: 'ecommerce'
+        }
+      ]
+    }
+  ], {
+    onCancel: () => {
+      console.log('\nCancelled.');
+      process.exit(1);
+    }
+  });
+
+  return response as Answers;
+}

package/src/utils/logger.ts

@@ -0,0 +1,60 @@
+import kolorist from 'kolorist';
+
+const { cyan, green, yellow, red, bold, dim } = kolorist;
+
+export const logger = {
+  intro: (name: string, version: string) => {
+    console.log(`
+${bold(cyan(`██████╗ ███████╗██╗   ██╗██████╗ ███████╗`))}
+${bold(cyan(`██╔══██╗██╔════╝██║   ██║██╔══██╗██╔════╝`))}
+${bold(cyan(`██████╔╝███████╗██║   ██║██████╔╝███████╗`))}
+${bold(cyan(`██╔═══╝ ╚════██║██║   ██║██╔═══╝ ╚════██║`))}
+${bold(cyan(`██║     ███████║╚██████╔╝██║     ███████║`))}
+${bold(cyan(`╚═╝     ╚══════╝ ╚═════╝ ╚═╝     ╚══════╝`))}
+${dim(`v${version}`)}
+${dim('Astro-native headless CMS')}
+`);
+  },
+
+  success: (msg: string) => {
+    console.log(`${green('✓')} ${msg}`);
+  },
+
+  error: (msg: string) => {
+    console.log(`${red('✗')} ${msg}`);
+  },
+
+  warning: (msg: string) => {
+    console.log(`${yellow('⚠')} ${msg}`);
+  },
+
+  info: (msg: string) => {
+    console.log(`${cyan('ℹ')} ${msg}`);
+  },
+
+  step: (num: number, total: number, msg: string) => {
+    console.log(`${dim(`[${num}/${total}]`)} ${msg}`);
+  },
+
+  heading: (msg: string) => {
+    console.log(`\n${bold(cyan(msg))}`);
+  },
+
+  subheading: (msg: string) => {
+    console.log(`\n${bold(msg)}`);
+  },
+
+  list: (items: string[]) => {
+    items.forEach(item => {
+      console.log(`  ${green('•')} ${item}`);
+    });
+  },
+
+  done: () => {
+    console.log(`\n${green(bold('Done!'))} Project created successfully.\n`);
+  },
+
+  prompt: (msg: string) => {
+    console.log(`\n${cyan('?')} ${bold(msg)}`);
+  }
+};