blumenjs 0.1.3 → 0.1.5

package/dist/cli/blumen.js

@@ -84,6 +84,24 @@ async function select(question, options) {
     });
   });
 }
+async function confirm(question, defaultYes = true) {
+  const readline = await import("readline");
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  const hint = defaultYes ? "Y/n" : "y/N";
+  return new Promise((resolve2) => {
+    rl.question(`  ${c.bold}${question}${c.reset} ${c.dim}(${hint})${c.reset} `, (answer) => {
+      rl.close();
+      const a = answer.trim().toLowerCase();
+      if (a === "")
+        resolve2(defaultYes);
+      else
+        resolve2(a === "y" || a === "yes");
+    });
+  });
+}
 
 // cli/commands/dev.ts
 async function dev() {
@@ -555,12 +573,96 @@ export function Link({ href, children, onClick, target, ...rest }: LinkProps) {
 
 export default Link;
 `;
+var DOCKERFILE = `# \u2500\u2500 Stage 1: Build Go server \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+FROM golang:1.22-alpine AS go-builder
+WORKDIR /app
+COPY go-server/ go-server/
+WORKDIR /app/go-server
+RUN go build -o /app/blumen-server main.go
+
+# \u2500\u2500 Stage 2: Build Node SSR + client bundle \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+FROM node:20-alpine AS node-builder
+WORKDIR /app
+COPY package.json tsconfig.json webpack.config.js ./
+COPY app/ app/
+COPY node-ssr/ node-ssr/
+COPY scripts/ scripts/
+RUN npm install --production=false
+RUN npx tsx scripts/generate-routes.ts
+RUN npx webpack --mode production
+RUN npx esbuild node-ssr/server.ts --bundle --platform=node --format=esm \\
+    --outfile=dist/ssr-server.js --external:react --external:react-dom
+
+# \u2500\u2500 Stage 3: Production image \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+FROM node:20-alpine
+RUN apk add --no-cache libc6-compat
+WORKDIR /app
+
+# Copy Go binary
+COPY --from=go-builder /app/blumen-server ./blumen-server
+
+# Copy Node SSR server + production deps
+COPY --from=node-builder /app/dist/ ./dist/
+COPY --from=node-builder /app/static/ ./static/
+COPY --from=node-builder /app/node_modules/ ./node_modules/
+COPY --from=node-builder /app/package.json ./
+
+EXPOSE 3000 4000
+
+# Start both services (Go on :3000, Node SSR on :4000)
+CMD sh -c './blumen-server & NODE_ENV=production node dist/ssr-server.js'
+`;
+var DOCKER_COMPOSE = `services:
+  app:
+    build: .
+    ports:
+      - "3000:3000"
+    environment:
+      - NODE_ENV=production
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "wget", "--spider", "-q", "http://localhost:3000"]
+      interval: 30s
+      timeout: 5s
+      retries: 3
+      start_period: 10s
+`;
+var DOCKERIGNORE = `node_modules
+dist
+static/js/bundle.js
+.git
+*.log
+.DS_Store
+`;
 function writeFile(base, relPath, content) {
   const fullPath = path2.join(base, relPath);
   fs3.mkdirSync(path2.dirname(fullPath), { recursive: true });
   fs3.writeFileSync(fullPath, content, "utf-8");
 }
-function getTemplateFiles(projectName) {
+var TEMPLATE_MAP = {
+  starter: {
+    file: "app/pages/BlumenStarter.tsx",
+    label: "Starter",
+    desc: "Premium landing page with feature cards"
+  },
+  empty: {
+    file: "app/pages/templates/BlumenEmpty.tsx",
+    label: "Empty",
+    desc: "Minimal blank project \u2014 just a centered greeting"
+  },
+  dashboard: {
+    file: "app/pages/templates/BlumenDashboard.tsx",
+    label: "Dashboard",
+    desc: "Admin dashboard with sidebar, stats, and activity feed"
+  },
+  api: {
+    file: "app/pages/templates/BlumenApi.tsx",
+    label: "API",
+    desc: "API explorer with endpoint list and response preview"
+  }
+};
+function getTemplateFiles(projectName, template) {
+  const tpl = TEMPLATE_MAP[template] || TEMPLATE_MAP.starter;
   return [
     // Generated config
     ["package.json", pkgJson(projectName)],
@@ -571,8 +673,9 @@ function getTemplateFiles(projectName) {
     ["app/shared/DefaultApp.tsx", DEFAULT_APP],
     ["app/shared/DefaultDocument.tsx", DEFAULT_DOCUMENT],
     ["app/shared/Link.tsx", LINK_TSX],
-    // Complex files — copied from the framework source (avoids escaping hell)
-    ["app/pages/Home.tsx", readProjectFile("app/pages/BlumenStarter.tsx")],
+    // Home page — determined by template choice
+    ["app/pages/Home.tsx", readProjectFile(tpl.file)],
+    // Complex files — copied from the framework source
     ["app/shared/RouterContext.tsx", readProjectFile("app/shared/RouterContext.tsx")],
     ["app/shared/router.ts", readProjectFile("app/shared/router.ts")],
     ["app/client/entry.tsx", readProjectFile("app/client/entry.tsx")],
@@ -580,7 +683,11 @@ function getTemplateFiles(projectName) {
     ["go-server/main.go", readProjectFile("go-server/main.go")],
     ["scripts/generate-routes.ts", readProjectFile("scripts/generate-routes.ts")],
     // Placeholder
-    ["static/js/.gitkeep", ""]
+    ["static/js/.gitkeep", ""],
+    // Docker support (production deployment)
+    ["Dockerfile", DOCKERFILE],
+    ["docker-compose.yml", DOCKER_COMPOSE],
+    [".dockerignore", DOCKERIGNORE]
   ];
 }
 async function create(projectName) {
@@ -590,7 +697,7 @@ async function create(projectName) {
     log.error("Please provide a project name.");
     console.log(
       `
-  ${c.dim}Usage:${c.reset} blumen create ${c.cyan}<project-name>${c.reset}
+  ${c.dim}Usage:${c.reset} blumen create ${c.cyan}<project-name>${c.reset} ${c.dim}[--template starter|empty|dashboard|api]${c.reset}
 `
     );
     process.exit(1);
@@ -600,6 +707,25 @@ async function create(projectName) {
     log.error(`Directory ${c.bold}${projectName}${c.reset} already exists.`);
     process.exit(1);
   }
+  let template = "";
+  const templateFlagIdx = process.argv.indexOf("--template");
+  if (templateFlagIdx !== -1 && process.argv[templateFlagIdx + 1]) {
+    template = process.argv[templateFlagIdx + 1];
+    if (!TEMPLATE_MAP[template]) {
+      log.error(`Unknown template: ${c.bold}${template}${c.reset}`);
+      log.info(`Available: ${Object.keys(TEMPLATE_MAP).join(", ")}`);
+      process.exit(1);
+    }
+  }
+  if (!template) {
+    template = await select(
+      "Which template do you want to use?",
+      Object.entries(TEMPLATE_MAP).map(
+        ([key, val]) => `${key} \u2014 ${val.desc}`
+      )
+    );
+    template = template.split(" \u2014 ")[0];
+  }
   const pkgManager = await select("Which package manager do you want to use?", [
     "npm",
     "yarn",
@@ -609,8 +735,8 @@ async function create(projectName) {
   log.blank();
   divider();
   log.blank();
-  log.step(`Creating project in ${c.cyan}${projectName}${c.reset}...`);
-  const files = getTemplateFiles(projectName);
+  log.step(`Creating project in ${c.cyan}${projectName}${c.reset} with ${c.magenta}${template}${c.reset} template...`);
+  const files = getTemplateFiles(projectName, template);
   for (const [relPath, content] of files) {
     writeFile(projectDir, relPath, content);
   }
@@ -636,7 +762,7 @@ async function create(projectName) {
   log.blank();
   divider();
   log.blank();
-  log.success(`${c.bold}Project created!${c.reset}`);
+  log.success(`${c.bold}Project created!${c.reset} (template: ${c.magenta}${template}${c.reset})`);
   log.blank();
   console.log(`  ${c.dim}Next steps:${c.reset}`);
   console.log(`    cd ${projectName}`);
@@ -644,6 +770,271 @@ async function create(projectName) {
   log.blank();
 }
 
+// cli/commands/deploy.ts
+import { execSync as execSync4, spawnSync } from "child_process";
+import * as fs4 from "fs";
+import * as path3 from "path";
+var PLATFORMS = [
+  { name: "Docker (any cloud)", ok: true, note: "Best option \u2014 multi-stage Dockerfile included" },
+  { name: "Railway", ok: true, note: "Auto-detects Dockerfile, deploy with railway up" },
+  { name: "Fly.io", ok: true, note: "Docker-based deploys via fly deploy" },
+  { name: "Render", ok: true, note: "Docker support, auto-deploy from Git" },
+  { name: "AWS EC2 / GCP / Azure", ok: true, note: "Full control, any runtime" },
+  { name: "DigitalOcean", ok: true, note: "App Platform supports Docker" },
+  { name: "Vercel", ok: false, note: "Node-only, no Go runtime" },
+  { name: "Netlify", ok: false, note: "Static/serverless only, no Go" }
+];
+function hasCommand(cmd) {
+  try {
+    execSync4(`which ${cmd}`, { stdio: "pipe" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function ensureDockerfile() {
+  if (!fs4.existsSync("Dockerfile")) {
+    log.error("No Dockerfile found in the current directory.");
+    log.info(
+      `Run ${c.bold}blumen create${c.reset} to scaffold a project with Docker support.`
+    );
+    process.exit(1);
+  }
+}
+async function deployDocker() {
+  log.info("Docker Deployment\n");
+  ensureDockerfile();
+  if (!hasCommand("docker")) {
+    log.error("Docker is not installed.");
+    log.info(
+      `Install Docker: ${c.cyan}https://docs.docker.com/get-docker/${c.reset}`
+    );
+    process.exit(1);
+  }
+  const projectName = path3.basename(process.cwd()).toLowerCase().replace(/[^a-z0-9-]/g, "-");
+  const imageName = `blumen-${projectName}`;
+  log.step(`Building image: ${c.bold}${imageName}${c.reset}...`);
+  divider();
+  log.blank();
+  const buildResult = spawnSync("docker", ["build", "-t", imageName, "."], {
+    cwd: process.cwd(),
+    stdio: "inherit"
+  });
+  log.blank();
+  divider();
+  if (buildResult.status !== 0) {
+    log.error("Docker build failed.");
+    process.exit(1);
+  }
+  log.success(`Image ${c.bold}${imageName}${c.reset} built successfully!`);
+  log.blank();
+  const shouldRun = await confirm("Run the container now?");
+  if (shouldRun) {
+    log.step(`Starting ${c.bold}${imageName}${c.reset} on port 3000...`);
+    log.blank();
+    console.log(
+      `  ${c.dim}\u279C${c.reset}  ${c.bold}App${c.reset}:  ${c.cyan}http://localhost:3000${c.reset}`
+    );
+    console.log(
+      `  ${c.dim}Press ${c.bold}Ctrl+C${c.reset}${c.dim} to stop.${c.reset}`
+    );
+    log.blank();
+    spawnSync("docker", ["run", "--rm", "-p", "3000:3000", imageName], {
+      cwd: process.cwd(),
+      stdio: "inherit"
+    });
+  } else {
+    log.blank();
+    console.log(`  ${c.dim}Run manually:${c.reset}`);
+    console.log(`    docker run -p 3000:3000 ${imageName}`);
+    log.blank();
+  }
+}
+async function deployFly() {
+  log.info("Fly.io Deployment\n");
+  ensureDockerfile();
+  const projectName = path3.basename(process.cwd()).toLowerCase().replace(/[^a-z0-9-]/g, "-");
+  if (!fs4.existsSync("fly.toml")) {
+    log.step("Generating fly.toml...");
+    const flyConfig = `# Fly.io configuration for Blumen app
+# Deploy with: fly deploy
+
+app = "${projectName}"
+primary_region = "iad"
+
+[build]
+
+[http_service]
+  internal_port = 3000
+  force_https = true
+  auto_stop_machines = "stop"
+  auto_start_machines = true
+  min_machines_running = 0
+
+[checks]
+  [checks.health]
+    type = "http"
+    port = 3000
+    path = "/"
+    interval = "30s"
+    timeout = "5s"
+
+[[vm]]
+  memory = "512mb"
+  cpu_kind = "shared"
+  cpus = 1
+`;
+    fs4.writeFileSync("fly.toml", flyConfig);
+    log.success("fly.toml created");
+  } else {
+    log.info("fly.toml already exists, skipping generation.");
+  }
+  log.blank();
+  if (!hasCommand("fly") && !hasCommand("flyctl")) {
+    log.warn("Fly CLI is not installed.");
+    log.blank();
+    console.log(`  ${c.dim}Install:${c.reset}`);
+    console.log(`    curl -L https://fly.io/install.sh | sh`);
+    log.blank();
+    console.log(`  ${c.dim}Then deploy:${c.reset}`);
+    console.log(`    fly launch`);
+    console.log(`    fly deploy`);
+    log.blank();
+    return;
+  }
+  const shouldDeploy = await confirm("Deploy to Fly.io now?");
+  if (shouldDeploy) {
+    log.step("Deploying to Fly.io...");
+    divider();
+    log.blank();
+    const flyCmd = hasCommand("fly") ? "fly" : "flyctl";
+    spawnSync(flyCmd, ["deploy"], {
+      cwd: process.cwd(),
+      stdio: "inherit"
+    });
+    log.blank();
+    divider();
+    log.success("Deployment complete!");
+  } else {
+    log.blank();
+    console.log(`  ${c.dim}Deploy later:${c.reset}`);
+    console.log(`    fly deploy`);
+    log.blank();
+  }
+}
+async function deployRailway() {
+  log.info("Railway Deployment\n");
+  ensureDockerfile();
+  if (!fs4.existsSync("railway.toml")) {
+    log.step("Generating railway.toml...");
+    const railwayConfig = `# Railway configuration for Blumen app
+# Deploy with: railway up
+
+[build]
+  builder = "DOCKERFILE"
+  dockerfilePath = "Dockerfile"
+
+[deploy]
+  startCommand = ""
+  healthcheckPath = "/"
+  healthcheckTimeout = 30
+  restartPolicyType = "ON_FAILURE"
+  restartPolicyMaxRetries = 5
+`;
+    fs4.writeFileSync("railway.toml", railwayConfig);
+    log.success("railway.toml created");
+  } else {
+    log.info("railway.toml already exists, skipping generation.");
+  }
+  log.blank();
+  if (!hasCommand("railway")) {
+    log.warn("Railway CLI is not installed.");
+    log.blank();
+    console.log(`  ${c.dim}Install:${c.reset}`);
+    console.log(`    npm install -g @railway/cli`);
+    log.blank();
+    console.log(`  ${c.dim}Then deploy:${c.reset}`);
+    console.log(`    railway login`);
+    console.log(`    railway up`);
+    log.blank();
+    return;
+  }
+  const shouldDeploy = await confirm("Deploy to Railway now?");
+  if (shouldDeploy) {
+    log.step("Deploying to Railway...");
+    divider();
+    log.blank();
+    spawnSync("railway", ["up"], {
+      cwd: process.cwd(),
+      stdio: "inherit"
+    });
+    log.blank();
+    divider();
+    log.success("Deployment complete!");
+  } else {
+    log.blank();
+    console.log(`  ${c.dim}Deploy later:${c.reset}`);
+    console.log(`    railway up`);
+    log.blank();
+  }
+}
+function showInfo() {
+  log.info("Hosting Compatibility\n");
+  console.log(`  Blumen apps require ${c.bold}Go${c.reset} + ${c.bold}Node.js${c.reset} \u2014 use Docker-compatible platforms.
+`);
+  const maxName = Math.max(...PLATFORMS.map((p) => p.name.length));
+  for (const p of PLATFORMS) {
+    const icon = p.ok ? `${c.green}\u2713${c.reset}` : `${c.red}\u2717${c.reset}`;
+    const name = p.name.padEnd(maxName + 2);
+    const note = `${c.dim}${p.note}${c.reset}`;
+    console.log(`  ${icon}  ${name} ${note}`);
+  }
+  log.blank();
+  divider();
+  log.blank();
+  console.log(`  ${c.bold}Quick start:${c.reset}`);
+  log.blank();
+  console.log(`  ${c.dim}Docker (local):${c.reset}      docker compose up`);
+  console.log(`  ${c.dim}Fly.io:${c.reset}              blumen deploy fly`);
+  console.log(`  ${c.dim}Railway:${c.reset}             blumen deploy railway`);
+  log.blank();
+}
+async function deploy(subcommand) {
+  banner();
+  if (!subcommand || subcommand === "--help" || subcommand === "-h") {
+    log.info("Deploy your Blumen app\n");
+    console.log(`  ${c.bold}Usage${c.reset}   blumen deploy ${c.dim}<target>${c.reset}
+`);
+    console.log(`  ${c.bold}Targets${c.reset}`);
+    console.log(`    docker     Build Docker image and optionally run`);
+    console.log(`    fly        Generate config and deploy to Fly.io`);
+    console.log(`    railway    Generate config and deploy to Railway`);
+    console.log(`    info       Show hosting compatibility matrix`);
+    console.log("");
+    return;
+  }
+  switch (subcommand) {
+    case "docker":
+      await deployDocker();
+      break;
+    case "fly":
+      await deployFly();
+      break;
+    case "railway":
+      await deployRailway();
+      break;
+    case "info":
+      showInfo();
+      break;
+    default:
+      log.error(`Unknown deploy target: ${c.bold}${subcommand}${c.reset}`);
+      log.info(
+        `Run ${c.bold}blumen deploy --help${c.reset} for available targets.`
+      );
+      process.exit(1);
+  }
+}
+
 // cli/blumen.ts
 async function main() {
   const command = process.argv[2];
@@ -662,6 +1053,9 @@ async function main() {
     console.log(
       `    create     Scaffold a new Blumen project`
     );
+    console.log(
+      `    deploy     Deploy to Docker, Fly.io, or Railway`
+    );
     console.log("");
     console.log(`  ${c.bold}Options${c.reset}`);
     console.log(`    --help     Show this help message`);
@@ -686,6 +1080,9 @@ async function main() {
     case "create":
       await create(process.argv[3]);
       break;
+    case "deploy":
+      await deploy(process.argv[3]);
+      break;
     default:
       log.error(
         `Unknown command: ${c.bold}${command}${c.reset}`

package/dist/cli/commands/create.js

@@ -303,12 +303,96 @@ export function Link({ href, children, onClick, target, ...rest }: LinkProps) {
 
 export default Link;
 `;
+var DOCKERFILE = `# \u2500\u2500 Stage 1: Build Go server \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+FROM golang:1.22-alpine AS go-builder
+WORKDIR /app
+COPY go-server/ go-server/
+WORKDIR /app/go-server
+RUN go build -o /app/blumen-server main.go
+
+# \u2500\u2500 Stage 2: Build Node SSR + client bundle \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+FROM node:20-alpine AS node-builder
+WORKDIR /app
+COPY package.json tsconfig.json webpack.config.js ./
+COPY app/ app/
+COPY node-ssr/ node-ssr/
+COPY scripts/ scripts/
+RUN npm install --production=false
+RUN npx tsx scripts/generate-routes.ts
+RUN npx webpack --mode production
+RUN npx esbuild node-ssr/server.ts --bundle --platform=node --format=esm \\
+    --outfile=dist/ssr-server.js --external:react --external:react-dom
+
+# \u2500\u2500 Stage 3: Production image \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+FROM node:20-alpine
+RUN apk add --no-cache libc6-compat
+WORKDIR /app
+
+# Copy Go binary
+COPY --from=go-builder /app/blumen-server ./blumen-server
+
+# Copy Node SSR server + production deps
+COPY --from=node-builder /app/dist/ ./dist/
+COPY --from=node-builder /app/static/ ./static/
+COPY --from=node-builder /app/node_modules/ ./node_modules/
+COPY --from=node-builder /app/package.json ./
+
+EXPOSE 3000 4000
+
+# Start both services (Go on :3000, Node SSR on :4000)
+CMD sh -c './blumen-server & NODE_ENV=production node dist/ssr-server.js'
+`;
+var DOCKER_COMPOSE = `services:
+  app:
+    build: .
+    ports:
+      - "3000:3000"
+    environment:
+      - NODE_ENV=production
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "wget", "--spider", "-q", "http://localhost:3000"]
+      interval: 30s
+      timeout: 5s
+      retries: 3
+      start_period: 10s
+`;
+var DOCKERIGNORE = `node_modules
+dist
+static/js/bundle.js
+.git
+*.log
+.DS_Store
+`;
 function writeFile(base, relPath, content) {
   const fullPath = path2.join(base, relPath);
   fs2.mkdirSync(path2.dirname(fullPath), { recursive: true });
   fs2.writeFileSync(fullPath, content, "utf-8");
 }
-function getTemplateFiles(projectName) {
+var TEMPLATE_MAP = {
+  starter: {
+    file: "app/pages/BlumenStarter.tsx",
+    label: "Starter",
+    desc: "Premium landing page with feature cards"
+  },
+  empty: {
+    file: "app/pages/templates/BlumenEmpty.tsx",
+    label: "Empty",
+    desc: "Minimal blank project \u2014 just a centered greeting"
+  },
+  dashboard: {
+    file: "app/pages/templates/BlumenDashboard.tsx",
+    label: "Dashboard",
+    desc: "Admin dashboard with sidebar, stats, and activity feed"
+  },
+  api: {
+    file: "app/pages/templates/BlumenApi.tsx",
+    label: "API",
+    desc: "API explorer with endpoint list and response preview"
+  }
+};
+function getTemplateFiles(projectName, template) {
+  const tpl = TEMPLATE_MAP[template] || TEMPLATE_MAP.starter;
   return [
     // Generated config
     ["package.json", pkgJson(projectName)],
@@ -319,8 +403,9 @@ function getTemplateFiles(projectName) {
     ["app/shared/DefaultApp.tsx", DEFAULT_APP],
     ["app/shared/DefaultDocument.tsx", DEFAULT_DOCUMENT],
     ["app/shared/Link.tsx", LINK_TSX],
-    // Complex files — copied from the framework source (avoids escaping hell)
-    ["app/pages/Home.tsx", readProjectFile("app/pages/BlumenStarter.tsx")],
+    // Home page — determined by template choice
+    ["app/pages/Home.tsx", readProjectFile(tpl.file)],
+    // Complex files — copied from the framework source
     ["app/shared/RouterContext.tsx", readProjectFile("app/shared/RouterContext.tsx")],
     ["app/shared/router.ts", readProjectFile("app/shared/router.ts")],
     ["app/client/entry.tsx", readProjectFile("app/client/entry.tsx")],
@@ -328,7 +413,11 @@ function getTemplateFiles(projectName) {
     ["go-server/main.go", readProjectFile("go-server/main.go")],
     ["scripts/generate-routes.ts", readProjectFile("scripts/generate-routes.ts")],
     // Placeholder
-    ["static/js/.gitkeep", ""]
+    ["static/js/.gitkeep", ""],
+    // Docker support (production deployment)
+    ["Dockerfile", DOCKERFILE],
+    ["docker-compose.yml", DOCKER_COMPOSE],
+    [".dockerignore", DOCKERIGNORE]
   ];
 }
 async function create(projectName) {
@@ -338,7 +427,7 @@ async function create(projectName) {
     log.error("Please provide a project name.");
     console.log(
       `
-  ${c.dim}Usage:${c.reset} blumen create ${c.cyan}<project-name>${c.reset}
+  ${c.dim}Usage:${c.reset} blumen create ${c.cyan}<project-name>${c.reset} ${c.dim}[--template starter|empty|dashboard|api]${c.reset}
 `
     );
     process.exit(1);
@@ -348,6 +437,25 @@ async function create(projectName) {
     log.error(`Directory ${c.bold}${projectName}${c.reset} already exists.`);
     process.exit(1);
   }
+  let template = "";
+  const templateFlagIdx = process.argv.indexOf("--template");
+  if (templateFlagIdx !== -1 && process.argv[templateFlagIdx + 1]) {
+    template = process.argv[templateFlagIdx + 1];
+    if (!TEMPLATE_MAP[template]) {
+      log.error(`Unknown template: ${c.bold}${template}${c.reset}`);
+      log.info(`Available: ${Object.keys(TEMPLATE_MAP).join(", ")}`);
+      process.exit(1);
+    }
+  }
+  if (!template) {
+    template = await select(
+      "Which template do you want to use?",
+      Object.entries(TEMPLATE_MAP).map(
+        ([key, val]) => `${key} \u2014 ${val.desc}`
+      )
+    );
+    template = template.split(" \u2014 ")[0];
+  }
   const pkgManager = await select("Which package manager do you want to use?", [
     "npm",
     "yarn",
@@ -357,8 +465,8 @@ async function create(projectName) {
   log.blank();
   divider();
   log.blank();
-  log.step(`Creating project in ${c.cyan}${projectName}${c.reset}...`);
-  const files = getTemplateFiles(projectName);
+  log.step(`Creating project in ${c.cyan}${projectName}${c.reset} with ${c.magenta}${template}${c.reset} template...`);
+  const files = getTemplateFiles(projectName, template);
   for (const [relPath, content] of files) {
     writeFile(projectDir, relPath, content);
   }
@@ -384,7 +492,7 @@ async function create(projectName) {
   log.blank();
   divider();
   log.blank();
-  log.success(`${c.bold}Project created!${c.reset}`);
+  log.success(`${c.bold}Project created!${c.reset} (template: ${c.magenta}${template}${c.reset})`);
   log.blank();
   console.log(`  ${c.dim}Next steps:${c.reset}`);
   console.log(`    cd ${projectName}`);