create-kyro 0.1.0

package/README.md

@@ -0,0 +1,52 @@
+# create-kyro
+
+Interactive scaffolding for Kyro CMS projects.
+
+## Usage
+
+```bash
+npm create kyro@latest
+```
+
+Or directly:
+
+```bash
+npx create-kyro
+```
+
+## What it does
+
+1. **Interactive Setup** - Prompts for:
+   - Project name
+   - Database (SQLite, PostgreSQL, MySQL, MongoDB)
+   - API protocols (REST, GraphQL, tRPC, WebSocket)
+   - Styling (Tailwind, CSS Modules, Styled Components, None)
+   - Authentication
+   - Versioning/Drafts
+   - Admin dashboard
+   - Starting template (Minimal, Blog, E-commerce)
+
+2. **Project Generation** - Creates:
+   - `package.json` with all dependencies
+   - `kyro.config.ts` with your selections
+   - `astro.config.mjs` configured for SSR
+   - `tsconfig.json`
+   - `SPEC.md` with project specification
+   - Initial pages and structure
+
+3. **Installation** - Runs `npm install`
+
+4. **Git Init** - Initializes git repository with first commit
+
+## Programmatic Usage
+
+```typescript
+import { promptUser } from 'create-kyro';
+
+const answers = await promptUser();
+// { projectName, database, apis, styling, auth, versioning, admin, template }
+```
+
+## License
+
+MIT

package/bin.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import './dist/index.js';

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.js

@@ -0,0 +1,605 @@
+// src/prompts.ts
+import prompts from "prompts";
+
+// src/validators.ts
+function validateProjectName(name) {
+  if (!name) {
+    return "Project name is required";
+  }
+  if (!/^[a-z0-9-]+$/.test(name)) {
+    return "Use lowercase letters, numbers, and hyphens only";
+  }
+  if (name.length < 2) {
+    return "Project name must be at least 2 characters";
+  }
+  if (name.length > 50) {
+    return "Project name must be less than 50 characters";
+  }
+  if (/^[-0-9]/.test(name)) {
+    return "Project name cannot start with a number or hyphen";
+  }
+  const reserved = ["node_modules", "dist", "build", "public", "src", "test", "tests"];
+  if (reserved.includes(name)) {
+    return `"${name}" is a reserved name`;
+  }
+  return true;
+}
+
+// src/prompts.ts
+async function promptUser() {
+  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;
+}
+
+// src/utils/logger.ts
+import kolorist from "kolorist";
+var { cyan, green, yellow, red, bold, dim } = kolorist;
+var logger = {
+  intro: (name, version) => {
+    console.log(`
+${bold(cyan(`\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557`))}
+${bold(cyan(`\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D`))}
+${bold(cyan(`\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557`))}
+${bold(cyan(`\u2588\u2588\u2554\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2588\u2588\u2551`))}
+${bold(cyan(`\u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551`))}
+${bold(cyan(`\u255A\u2550\u255D     \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u255D     \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D`))}
+${dim(`v${version}`)}
+${dim("Astro-native headless CMS")}
+`);
+  },
+  success: (msg) => {
+    console.log(`${green("\u2713")} ${msg}`);
+  },
+  error: (msg) => {
+    console.log(`${red("\u2717")} ${msg}`);
+  },
+  warning: (msg) => {
+    console.log(`${yellow("\u26A0")} ${msg}`);
+  },
+  info: (msg) => {
+    console.log(`${cyan("\u2139")} ${msg}`);
+  },
+  step: (num, total, msg) => {
+    console.log(`${dim(`[${num}/${total}]`)} ${msg}`);
+  },
+  heading: (msg) => {
+    console.log(`
+${bold(cyan(msg))}`);
+  },
+  subheading: (msg) => {
+    console.log(`
+${bold(msg)}`);
+  },
+  list: (items) => {
+    items.forEach((item) => {
+      console.log(`  ${green("\u2022")} ${item}`);
+    });
+  },
+  done: () => {
+    console.log(`
+${green(bold("Done!"))} Project created successfully.
+`);
+  },
+  prompt: (msg) => {
+    console.log(`
+${cyan("?")} ${bold(msg)}`);
+  }
+};
+
+// src/generators/packagejson.ts
+function generatePackageJson(answers, projectDir) {
+  const deps = {
+    "@kyro-cms/core": "latest",
+    "astro": "^5.4.0"
+  };
+  const devDeps = {
+    "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 = {
+    "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
+  };
+}
+function formatPackageJson(pkg) {
+  return JSON.stringify(pkg, null, 2);
+}
+
+// src/generators/config.ts
+function generateKyroConfig(answers) {
+  const imports = ["import { defineConfig } from '@kyro-cms/core';"];
+  const adapterLines = [];
+  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 = [];
+  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 = [];
+  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;
+}
+
+// src/generators/astro.ts
+function generateAstroConfig(answers) {
+  const integrations = [];
+  const vitePlugins = [];
+  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;
+}
+
+// src/generators/files.ts
+import { writeFileSync, mkdirSync } from "fs";
+import { join } from "path";
+function generateProjectFiles(answers, projectDir) {
+  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 \u2192</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);
+  }
+}
+
+// src/index.ts
+import { writeFileSync as writeFileSync2, mkdirSync as mkdirSync2, existsSync } from "fs";
+import { join as join2 } from "path";
+import { execSync } from "child_process";
+var VERSION = "0.1.0";
+async function main() {
+  logger.intro("create-kyro", VERSION);
+  const answers = await promptUser();
+  const projectDir = join2(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]);
+  mkdirSync2(projectDir, { recursive: true });
+  logger.success("Project directory created");
+  logger.step(2, steps.length, steps[1]);
+  const pkg = generatePackageJson(answers, projectDir);
+  writeFileSync2(
+    join2(projectDir, "package.json"),
+    formatPackageJson(pkg)
+  );
+  logger.success("package.json generated");
+  const kyroConfig = generateKyroConfig(answers);
+  writeFileSync2(join2(projectDir, "kyro.config.ts"), kyroConfig);
+  logger.success("kyro.config.ts generated");
+  const astroConfig = generateAstroConfig(answers);
+  writeFileSync2(join2(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/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "create-kyro",
+  "version": "0.1.0",
+  "description": "Create a new Kyro CMS project",
+  "type": "module",
+  "bin": {
+    "create-kyro": "./bin.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "prompts": "^2.4.2",
+    "kolorist": "^1.8.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.7.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "kyro",
+    "cms",
+    "scaffold",
+    "create"
+  ],
+  "license": "MIT"
+}