create-crm-starter 0.1.0

package/dist/index.js

@@ -0,0 +1,2341 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { defineCommand, runMain } from "citty";
+
+// src/commands/create.ts
+import path21 from "path";
+import fs16 from "fs/promises";
+import { intro, log, note as note3, outro, spinner as spinner2 } from "@clack/prompts";
+import pc3 from "picocolors";
+
+// src/prompts/runPrompts.ts
+import path from "path";
+import fs from "fs";
+import {
+  cancel,
+  confirm,
+  group,
+  isCancel,
+  multiselect,
+  note,
+  select,
+  text
+} from "@clack/prompts";
+import pc from "picocolors";
+
+// src/prompts/industries/general.ts
+var general = {
+  id: "general",
+  label: "General home services",
+  primaryColor: "#0ea5e9",
+  // sky-500
+  accentColor: "#f59e0b",
+  // amber-500
+  sampleTagline: "Trusted home-service pros at your door.",
+  serviceTypes: ["Service Call", "Estimate", "Maintenance", "Repair", "Install"],
+  defaults: {
+    landingPage: true,
+    onlineBooking: true,
+    stack: "clerk-convex",
+    roles: ["admin", "dispatcher", "technician", "csr"],
+    customers: true,
+    jobs: true,
+    estimatesInvoices: true,
+    calendarDispatch: true,
+    payments: true,
+    comms: ["sms", "email"],
+    reviews: true,
+    reporting: true,
+    seed: true,
+    initGit: true,
+    install: true,
+    deployTarget: "vercel"
+  },
+  extraModules: [],
+  seedFixtures: "general"
+};
+
+// src/prompts/industries/hvac.ts
+var hvac = {
+  id: "hvac",
+  label: "HVAC",
+  primaryColor: "#ea580c",
+  // orange-600
+  accentColor: "#0284c7",
+  // sky-600 (cool counterpoint to hot orange)
+  sampleTagline: "Heating & cooling done right, on time, the first time.",
+  serviceTypes: ["Install", "Repair", "Maintenance", "Tune-up", "Diagnostic", "Refrigerant Recharge"],
+  defaults: {
+    landingPage: true,
+    onlineBooking: true,
+    stack: "clerk-convex",
+    roles: ["admin", "dispatcher", "technician", "csr"],
+    customers: true,
+    jobs: true,
+    estimatesInvoices: true,
+    calendarDispatch: true,
+    payments: true,
+    comms: ["sms", "email"],
+    reviews: true,
+    reporting: true,
+    seed: true,
+    initGit: true,
+    install: true,
+    deployTarget: "vercel"
+  },
+  extraModules: ["equipment-tracking", "maintenance-plans"],
+  seedFixtures: "hvac"
+};
+
+// src/prompts/industries/plumbing.ts
+var plumbing = {
+  id: "plumbing",
+  label: "Plumbing",
+  primaryColor: "#2563eb",
+  // blue-600
+  accentColor: "#dc2626",
+  // red-600 (emergency / urgent counterpoint)
+  sampleTagline: "Fast, honest plumbing. Available 24/7.",
+  serviceTypes: ["Service Call", "Drain Cleaning", "Leak Repair", "Water Heater", "Re-pipe", "Emergency"],
+  defaults: {
+    landingPage: true,
+    onlineBooking: true,
+    stack: "clerk-convex",
+    roles: ["admin", "dispatcher", "technician", "csr"],
+    customers: true,
+    jobs: true,
+    estimatesInvoices: true,
+    calendarDispatch: true,
+    payments: true,
+    comms: ["sms", "email"],
+    reviews: true,
+    reporting: true,
+    seed: true,
+    initGit: true,
+    install: true,
+    deployTarget: "vercel"
+  },
+  extraModules: ["emergency-dispatch", "permit-tracking"],
+  seedFixtures: "plumbing"
+};
+
+// src/prompts/industries/electrical.ts
+var electrical = {
+  id: "electrical",
+  label: "Electrical",
+  primaryColor: "#eab308",
+  // yellow-500 (electricity / caution)
+  accentColor: "#0f172a",
+  // slate-900 (high contrast for wiring/danger feel)
+  sampleTagline: "Licensed electricians. Code-correct. Code-fast.",
+  serviceTypes: ["Service Call", "Panel Upgrade", "Outlet/Switch", "Lighting", "EV Charger", "Generator", "Inspection"],
+  defaults: {
+    landingPage: true,
+    onlineBooking: true,
+    stack: "clerk-convex",
+    roles: ["admin", "dispatcher", "technician", "csr"],
+    customers: true,
+    jobs: true,
+    estimatesInvoices: true,
+    calendarDispatch: true,
+    payments: true,
+    comms: ["sms", "email"],
+    reviews: true,
+    reporting: true,
+    seed: true,
+    initGit: true,
+    install: true,
+    deployTarget: "vercel"
+  },
+  extraModules: ["permit-tracking", "inspection-checklists"],
+  seedFixtures: "electrical"
+};
+
+// src/prompts/industries/cleaning.ts
+var cleaning = {
+  id: "cleaning",
+  label: "Home / Commercial Cleaning",
+  primaryColor: "#7c3aed",
+  // violet-600
+  accentColor: "#06b6d4",
+  // cyan-500
+  sampleTagline: "Spotless homes. Sparkling reviews.",
+  serviceTypes: ["Standard Cleaning", "Deep Clean", "Move-in/Move-out", "Recurring (Weekly)", "Recurring (Bi-weekly)", "Post-Construction"],
+  defaults: {
+    landingPage: true,
+    onlineBooking: true,
+    stack: "clerk-convex",
+    roles: ["admin", "dispatcher", "technician", "csr"],
+    customers: true,
+    jobs: true,
+    estimatesInvoices: true,
+    calendarDispatch: true,
+    payments: true,
+    comms: ["sms", "email"],
+    reviews: true,
+    reporting: true,
+    seed: true,
+    initGit: true,
+    install: true,
+    deployTarget: "vercel"
+  },
+  // Recurring service plans + crew-style dispatch (multi-tech assignment) are the
+  // cleaning-specific add-ons (Phase 18 builds these out).
+  extraModules: ["maintenance-plans"],
+  seedFixtures: "cleaning"
+};
+
+// src/prompts/industries/landscaping.ts
+var landscaping = {
+  id: "landscaping",
+  label: "Landscaping / Lawn Care",
+  primaryColor: "#16a34a",
+  // green-600
+  accentColor: "#ca8a04",
+  // yellow-600
+  sampleTagline: "Lawns done right. Yards transformed.",
+  serviceTypes: ["Mowing (weekly)", "Mowing (bi-weekly)", "Cleanup", "Mulching", "Pruning", "Sod Install", "Hardscape Project"],
+  defaults: {
+    landingPage: true,
+    onlineBooking: true,
+    stack: "clerk-convex",
+    roles: ["admin", "dispatcher", "technician", "csr"],
+    customers: true,
+    jobs: true,
+    estimatesInvoices: true,
+    calendarDispatch: true,
+    payments: true,
+    comms: ["sms", "email"],
+    reviews: true,
+    reporting: true,
+    seed: true,
+    initGit: true,
+    install: true,
+    deployTarget: "vercel"
+  },
+  // Route-based + recurring is the heart of lawn care — maintenance plans + (later)
+  // route optimization belong here.
+  extraModules: ["maintenance-plans"],
+  seedFixtures: "landscaping"
+};
+
+// src/prompts/industries/roofing.ts
+var roofing = {
+  id: "roofing",
+  label: "Roofing",
+  primaryColor: "#b91c1c",
+  // red-700
+  accentColor: "#1e293b",
+  // slate-800
+  sampleTagline: "Roofs that last. Estimates that don't.",
+  serviceTypes: ["Roof Inspection", "Repair", "Full Replacement", "Gutter", "Siding", "Insurance Claim Assist"],
+  defaults: {
+    landingPage: true,
+    onlineBooking: true,
+    stack: "clerk-convex",
+    roles: ["admin", "dispatcher", "technician", "csr", "sales"],
+    customers: true,
+    jobs: true,
+    estimatesInvoices: true,
+    calendarDispatch: true,
+    payments: true,
+    comms: ["sms", "email"],
+    reviews: true,
+    reporting: true,
+    seed: true,
+    initGit: true,
+    install: true,
+    deployTarget: "vercel"
+  },
+  // Roofing = big-ticket estimates + permits + project photo documentation.
+  // (Phase 18 will add a dedicated insurance-claims module.)
+  extraModules: ["permit-tracking", "inspection-checklists"],
+  seedFixtures: "roofing"
+};
+
+// src/prompts/industries/index.ts
+var industries = {
+  general,
+  hvac,
+  plumbing,
+  electrical,
+  cleaning,
+  landscaping,
+  roofing
+};
+var industryOptions = [
+  { value: "hvac", label: hvac.label, hint: "Equipment tracking + maintenance plans" },
+  { value: "plumbing", label: plumbing.label, hint: "Emergency dispatch + permits" },
+  { value: "electrical", label: electrical.label, hint: "Permit tracking + inspections" },
+  { value: "cleaning", label: cleaning.label, hint: "Recurring service plans" },
+  { value: "landscaping", label: landscaping.label, hint: "Route-based recurring jobs" },
+  { value: "roofing", label: roofing.label, hint: "Big-ticket estimates + permits + insurance" },
+  { value: "general", label: general.label, hint: "Core modules only \u2014 no industry preset" }
+];
+
+// src/prompts/runPrompts.ts
+function exitIfCancelled(value) {
+  if (isCancel(value)) {
+    cancel("Cancelled. No files were written.");
+    process.exit(0);
+  }
+  return value;
+}
+var REQUIRED_KEYS = [
+  "projectName",
+  "businessName",
+  "industry",
+  "primaryColor",
+  "accentColor",
+  "landingPage",
+  "onlineBooking",
+  "stack",
+  "roles",
+  "customers",
+  "jobs",
+  "estimatesInvoices",
+  "calendarDispatch",
+  "payments",
+  "comms",
+  "reviews",
+  "reporting",
+  "seed",
+  "initGit",
+  "install",
+  "deployTarget"
+];
+function deriveBusinessNameFromProject(name) {
+  return name.split(/[-_]/).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
+}
+function loadConfigFromFile(filePath) {
+  const resolved = path.resolve(process.cwd(), filePath);
+  if (!fs.existsSync(resolved)) {
+    cancel(`Config file not found: ${resolved}`);
+    process.exit(1);
+  }
+  const raw = fs.readFileSync(resolved, "utf8");
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    cancel(`Config file is not valid JSON: ${resolved}`);
+    process.exit(1);
+  }
+  const presetForBackfill = parsed.industry && industries[parsed.industry] ? industries[parsed.industry] : industries.general;
+  if (!parsed.primaryColor && parsed.brandColor) {
+    parsed.primaryColor = parsed.brandColor;
+  }
+  if (!parsed.primaryColor) parsed.primaryColor = presetForBackfill.primaryColor;
+  if (!parsed.accentColor) parsed.accentColor = presetForBackfill.accentColor;
+  if (!parsed.businessName && parsed.projectName) {
+    parsed.businessName = deriveBusinessNameFromProject(parsed.projectName);
+  }
+  if (!parsed.deployTarget) parsed.deployTarget = "vercel";
+  const missing = REQUIRED_KEYS.filter((k) => parsed[k] === void 0);
+  if (missing.length > 0) {
+    cancel(`Config missing required keys: ${missing.join(", ")}`);
+    process.exit(1);
+  }
+  return {
+    ...parsed,
+    industryExtras: parsed.industryExtras ?? []
+  };
+}
+async function runPrompts(argv) {
+  if (argv.configPath) {
+    const cfg = loadConfigFromFile(argv.configPath);
+    if (argv.projectName) cfg.projectName = argv.projectName;
+    return cfg;
+  }
+  note(
+    pc.dim("Step 1 of 4 \u2014 tell us about the business"),
+    pc.cyan("Identity")
+  );
+  const projectName = exitIfCancelled(
+    argv.projectName ?? await text({
+      message: "Project name (folder + npm package \u2014 lowercase, dashed)",
+      placeholder: "acme-hvac",
+      defaultValue: "my-crm",
+      validate(value) {
+        const v = value.trim();
+        if (!v) return "Project name is required.";
+        if (!/^[a-z0-9][a-z0-9-_]*$/i.test(v)) {
+          return "Use letters, numbers, dashes, underscores only.";
+        }
+        const target = path.resolve(process.cwd(), v);
+        if (fs.existsSync(target) && fs.readdirSync(target).length > 0) {
+          return `Directory "${v}" already exists and is not empty.`;
+        }
+        return void 0;
+      }
+    })
+  );
+  const businessName = exitIfCancelled(
+    await text({
+      message: "Business display name (shown in UI, emails, invoices)",
+      placeholder: deriveBusinessNameFromProject(projectName),
+      defaultValue: deriveBusinessNameFromProject(projectName),
+      validate(value) {
+        if (!value || !value.trim()) return "Business name is required.";
+        return void 0;
+      }
+    })
+  );
+  const businessLegalName = exitIfCancelled(
+    await text({
+      message: pc.dim("Legal business name for invoices/contracts (optional \u2014 Enter to skip)"),
+      placeholder: `${businessName} LLC`,
+      defaultValue: ""
+    })
+  );
+  const industry = exitIfCancelled(
+    await select({
+      message: "Industry vertical",
+      options: industryOptions,
+      initialValue: "general"
+    })
+  );
+  const preset = industries[industry];
+  const tagline = exitIfCancelled(
+    await text({
+      message: pc.dim("Tagline / one-liner for the landing page (optional)"),
+      placeholder: preset.sampleTagline,
+      defaultValue: ""
+    })
+  );
+  note(
+    pc.dim("Step 2 of 4 \u2014 make it look like their brand"),
+    pc.cyan("Branding")
+  );
+  const hexValidator = (value) => {
+    if (!value) return void 0;
+    if (!/^#[0-9a-f]{6}$/i.test(value.trim())) {
+      return "Use a 6-digit hex color like #0ea5e9";
+    }
+    return void 0;
+  };
+  const primaryColor = exitIfCancelled(
+    await text({
+      message: `Primary brand color (hex) \u2014 used for buttons, links, headers`,
+      placeholder: preset.primaryColor,
+      defaultValue: preset.primaryColor,
+      validate: hexValidator
+    })
+  );
+  const accentColor = exitIfCancelled(
+    await text({
+      message: `Accent color (hex) \u2014 used for highlights, badges, secondary CTAs`,
+      placeholder: preset.accentColor,
+      defaultValue: preset.accentColor,
+      validate: hexValidator
+    })
+  );
+  const logoPath = exitIfCancelled(
+    await text({
+      message: pc.dim("Logo file path (PNG/SVG/JPG \u2014 optional, copied to public/)"),
+      placeholder: "~/Desktop/acme-logo.png",
+      defaultValue: "",
+      validate(value) {
+        if (!value || !value.trim()) return void 0;
+        const expanded = value.replace(/^~/, process.env.HOME ?? "");
+        if (!fs.existsSync(expanded)) {
+          return `File not found: ${expanded}`;
+        }
+        if (!/\.(png|jpg|jpeg|svg|webp)$/i.test(expanded)) {
+          return "Logo must be PNG, JPG, SVG, or WebP";
+        }
+        return void 0;
+      }
+    })
+  );
+  note(
+    pc.dim("Step 3 of 4 \u2014 contact details (all optional, used in footer + transactional emails)"),
+    pc.cyan("Contact")
+  );
+  const contactAnswers = await group(
+    {
+      businessPhone: () => text({
+        message: pc.dim("Business phone"),
+        placeholder: "(555) 010-1234",
+        defaultValue: ""
+      }),
+      businessEmail: () => text({
+        message: pc.dim("Business email"),
+        placeholder: "hello@acmehvac.com",
+        defaultValue: "",
+        validate(value) {
+          if (!value || !value.trim()) return void 0;
+          if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value.trim())) {
+            return "Use a valid email address";
+          }
+          return void 0;
+        }
+      }),
+      businessAddress: () => text({
+        message: pc.dim("Mailing address (single line)"),
+        placeholder: "120 Main St, Austin, TX 78701",
+        defaultValue: ""
+      }),
+      serviceAreaZips: () => text({
+        message: pc.dim("Service-area ZIP codes (comma-separated)"),
+        placeholder: "78701, 78704, 78745",
+        defaultValue: ""
+      })
+    },
+    {
+      onCancel: () => {
+        cancel("Cancelled. No files were written.");
+        process.exit(0);
+      }
+    }
+  );
+  note(
+    pc.dim("Step 4 of 4 \u2014 features + stack + first admin account"),
+    pc.cyan("Features")
+  );
+  const answers = await group(
+    {
+      stack: () => select({
+        message: "Auth + database stack",
+        options: [
+          {
+            value: "better-auth-drizzle",
+            label: "Better-Auth + Postgres + Drizzle",
+            hint: "full-featured \u2014 recommended for client delivery"
+          },
+          {
+            value: "clerk-convex",
+            label: "Clerk + Convex",
+            hint: "core modules only \u2014 customers + jobs are fully working; estimates/invoices/portal are Drizzle-only for now (experimental)"
+          }
+        ],
+        initialValue: preset.defaults.stack ?? "clerk-convex"
+      }),
+      roles: () => multiselect({
+        message: "User roles to include",
+        options: [
+          { value: "admin", label: "Owner / Admin" },
+          { value: "dispatcher", label: "Dispatcher" },
+          { value: "technician", label: "Field Technician" },
+          { value: "csr", label: "CSR (Customer Service Rep)" },
+          { value: "sales", label: "Sales / Estimator" },
+          { value: "accountant", label: "Accountant" }
+        ],
+        initialValues: preset.defaults.roles ?? ["admin", "dispatcher", "technician", "csr"],
+        required: true
+      }),
+      landingPage: () => confirm({
+        message: "Public landing page (marketing site)?",
+        initialValue: preset.defaults.landingPage ?? true
+      }),
+      onlineBooking: ({ results }) => results.landingPage ? confirm({
+        message: "Online booking widget on the landing page?",
+        initialValue: preset.defaults.onlineBooking ?? true
+      }) : Promise.resolve(false),
+      customers: () => confirm({
+        message: "Customers / Contacts module?",
+        initialValue: preset.defaults.customers ?? true
+      }),
+      jobs: () => confirm({
+        message: "Jobs / Work Orders module?",
+        initialValue: preset.defaults.jobs ?? true
+      }),
+      estimatesInvoices: () => confirm({
+        message: "Estimates & Invoices module?",
+        initialValue: preset.defaults.estimatesInvoices ?? true
+      }),
+      calendarDispatch: () => confirm({
+        message: "Calendar + Dispatch board?",
+        initialValue: preset.defaults.calendarDispatch ?? true
+      }),
+      payments: () => confirm({
+        message: "Payments (Stripe)?",
+        initialValue: preset.defaults.payments ?? true
+      }),
+      comms: () => multiselect({
+        message: "Communication channels",
+        options: [
+          { value: "sms", label: "SMS (Twilio)" },
+          { value: "email", label: "Email (Resend)" }
+        ],
+        initialValues: preset.defaults.comms ?? ["sms", "email"],
+        required: false
+      }),
+      reviews: () => confirm({
+        message: "Reviews & marketing automation?",
+        initialValue: preset.defaults.reviews ?? true
+      }),
+      reporting: () => confirm({
+        message: "Reporting dashboard?",
+        initialValue: preset.defaults.reporting ?? true
+      }),
+      mobileApp: ({ results }) => results.stack === "better-auth-drizzle" && results.jobs && results.customers ? confirm({
+        message: "Field-tech iPhone app? (Expo \u2014 adds a mobile API + branded app)",
+        initialValue: preset.defaults.mobileApp ?? true
+      }) : Promise.resolve(false),
+      ownerName: () => text({
+        message: pc.dim("First admin user \u2014 full name (optional, pre-seeded in dev)"),
+        placeholder: "Joe Smith",
+        defaultValue: ""
+      }),
+      ownerEmail: () => text({
+        message: pc.dim("First admin user \u2014 email (optional)"),
+        placeholder: "joe@acmehvac.com",
+        defaultValue: "",
+        validate(value) {
+          if (!value || !value.trim()) return void 0;
+          if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value.trim())) {
+            return "Use a valid email address";
+          }
+          return void 0;
+        }
+      }),
+      deployTarget: () => select({
+        message: "Deploy target (drives README + setup-script)",
+        options: [
+          { value: "vercel", label: "Vercel", hint: "one-click deploy button in README" },
+          { value: "netlify", label: "Netlify", hint: "netlify.toml + deploy button" },
+          { value: "manual", label: "Self-host / manual", hint: "plain dockerfile + docs" }
+        ],
+        initialValue: preset.defaults.deployTarget ?? "vercel"
+      }),
+      seed: () => confirm({
+        message: "Generate realistic demo seed data?",
+        initialValue: preset.defaults.seed ?? true
+      }),
+      initGit: () => confirm({
+        message: "Initialize a git repository?",
+        initialValue: preset.defaults.initGit ?? true
+      }),
+      install: () => confirm({
+        message: "Install dependencies now?",
+        initialValue: preset.defaults.install ?? true
+      })
+    },
+    {
+      onCancel: () => {
+        cancel("Cancelled. No files were written.");
+        process.exit(0);
+      }
+    }
+  );
+  const config = {
+    projectName,
+    businessName: businessName.trim(),
+    businessLegalName: businessLegalName.trim() || void 0,
+    tagline: tagline.trim() || void 0,
+    industry,
+    primaryColor,
+    accentColor,
+    logoPath: logoPath.trim() || void 0,
+    businessPhone: contactAnswers.businessPhone.trim() || void 0,
+    businessEmail: contactAnswers.businessEmail.trim() || void 0,
+    businessAddress: contactAnswers.businessAddress.trim() || void 0,
+    serviceAreaZips: contactAnswers.serviceAreaZips.trim() || void 0,
+    stack: answers.stack,
+    roles: answers.roles,
+    landingPage: answers.landingPage,
+    onlineBooking: Boolean(answers.onlineBooking),
+    customers: answers.customers,
+    jobs: answers.jobs,
+    estimatesInvoices: answers.estimatesInvoices,
+    calendarDispatch: answers.calendarDispatch,
+    payments: answers.payments,
+    comms: answers.comms,
+    reviews: answers.reviews,
+    reporting: answers.reporting,
+    mobileApp: Boolean(answers.mobileApp),
+    industryExtras: preset.extraModules,
+    ownerName: answers.ownerName.trim() || void 0,
+    ownerEmail: answers.ownerEmail.trim() || void 0,
+    seed: answers.seed,
+    initGit: answers.initGit,
+    install: answers.install,
+    deployTarget: answers.deployTarget
+  };
+  return config;
+}
+function summarizeConfig(cfg) {
+  const lines = [
+    `${pc.bold("Project:")} ${cfg.projectName}`,
+    `${pc.bold("Business:")} ${cfg.businessName}${cfg.businessLegalName ? pc.dim(` (${cfg.businessLegalName})`) : ""}`,
+    cfg.tagline ? `${pc.bold("Tagline:")} ${pc.italic(cfg.tagline)}` : null,
+    `${pc.bold("Industry:")} ${industries[cfg.industry].label}`,
+    `${pc.bold("Stack:")} ${cfg.stack}`,
+    `${pc.bold("Modules:")} ${[
+      cfg.landingPage && "landing-page",
+      "auth",
+      "admin",
+      cfg.customers && "customers",
+      cfg.jobs && "jobs",
+      cfg.estimatesInvoices && "estimates-invoices",
+      cfg.calendarDispatch && "calendar-dispatch",
+      cfg.payments && "payments-stripe",
+      cfg.comms.includes("sms") && "comms-sms",
+      cfg.comms.includes("email") && "comms-email",
+      cfg.reviews && "reviews",
+      cfg.reporting && "reporting",
+      cfg.mobileApp && "mobile (iPhone app)",
+      ...cfg.industryExtras
+    ].filter(Boolean).join(", ")}`,
+    `${pc.bold("Roles:")} ${cfg.roles.join(", ")}`,
+    `${pc.bold("Brand:")} primary ${pc.cyan(cfg.primaryColor)} \xB7 accent ${pc.magenta(cfg.accentColor)}${cfg.logoPath ? pc.dim(` \xB7 logo: ${cfg.logoPath}`) : ""}`,
+    cfg.businessPhone || cfg.businessEmail || cfg.businessAddress ? `${pc.bold("Contact:")} ${[cfg.businessPhone, cfg.businessEmail, cfg.businessAddress].filter(Boolean).join(" \xB7 ")}` : null,
+    cfg.serviceAreaZips ? `${pc.bold("Service area:")} ${cfg.serviceAreaZips}` : null,
+    cfg.ownerName || cfg.ownerEmail ? `${pc.bold("First admin:")} ${[cfg.ownerName, cfg.ownerEmail].filter(Boolean).join(" \xB7 ")}` : null,
+    `${pc.bold("Deploy:")} ${cfg.deployTarget}`,
+    `${pc.bold("Seed:")} ${cfg.seed ? "yes" : "no"} \xB7 ${pc.bold("Git:")} ${cfg.initGit ? "yes" : "no"} \xB7 ${pc.bold("Install:")} ${cfg.install ? "yes" : "no"}`
+  ];
+  return lines.filter((l) => l !== null).join("\n");
+}
+
+// src/helpers/copyTemplate.ts
+import fs3 from "fs/promises";
+import path3 from "path";
+
+// src/helpers/paths.ts
+import { fileURLToPath } from "url";
+import path2 from "path";
+import fs2 from "fs";
+var here = path2.dirname(fileURLToPath(import.meta.url));
+function findPackageRoot(start) {
+  let dir = start;
+  for (let i = 0; i < 8; i++) {
+    if (fs2.existsSync(path2.join(dir, "template", "base"))) return dir;
+    const parent = path2.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  dir = start;
+  for (let i = 0; i < 8; i++) {
+    if (fs2.existsSync(path2.join(dir, "package.json"))) return dir;
+    const parent = path2.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return path2.resolve(here, "..");
+}
+var packageRoot = findPackageRoot(here);
+var templateBaseDir = path2.join(packageRoot, "template", "base");
+var templateExtrasDir = path2.join(packageRoot, "template", "extras");
+
+// src/helpers/copyTemplate.ts
+function rewriteName(name) {
+  if (name.startsWith("_dot_")) return "." + name.slice("_dot_".length);
+  return name;
+}
+async function copyDir(src, dest) {
+  await fs3.mkdir(dest, { recursive: true });
+  const entries = await fs3.readdir(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path3.join(src, entry.name);
+    const destPath = path3.join(dest, rewriteName(entry.name));
+    if (entry.isDirectory()) {
+      await copyDir(srcPath, destPath);
+    } else if (entry.isFile()) {
+      await fs3.cp(srcPath, destPath);
+    }
+  }
+}
+async function copyBase(projectDir) {
+  await copyDir(templateBaseDir, projectDir);
+}
+async function copyExtra(extraSubpath, projectDir) {
+  const src = path3.join(templateExtrasDir, extraSubpath);
+  await copyDir(src, projectDir);
+}
+
+// src/helpers/mergeEnv.ts
+import fs4 from "fs/promises";
+import path4 from "path";
+async function mergeEnv(projectDir, block) {
+  if (Object.keys(block.vars).length === 0) return;
+  const examplePath = path4.join(projectDir, ".env.example");
+  const localPath = path4.join(projectDir, ".env.local");
+  const defaults = block.localDefaults ?? {};
+  const exampleLines = [
+    "",
+    `# --- ${block.heading} ---`,
+    ...Object.entries(block.vars).map(([k, v]) => `${k}=${v}`)
+  ].join("\n");
+  const localLines = [
+    "",
+    `# --- ${block.heading} ---`,
+    ...Object.keys(block.vars).map((k) => `${k}=${defaults[k] ?? ""}`)
+  ].join("\n");
+  await fs4.appendFile(examplePath, exampleLines, "utf8");
+  await fs4.appendFile(localPath, localLines, "utf8");
+}
+async function ensureEnvFiles(projectDir) {
+  const examplePath = path4.join(projectDir, ".env.example");
+  const localPath = path4.join(projectDir, ".env.local");
+  try {
+    await fs4.access(examplePath);
+  } catch {
+    await fs4.writeFile(examplePath, "# Environment variables\n", "utf8");
+  }
+  try {
+    await fs4.access(localPath);
+  } catch {
+    await fs4.writeFile(
+      localPath,
+      "# Local environment overrides (gitignored)\n",
+      "utf8"
+    );
+  }
+}
+
+// src/helpers/mergePackageJson.ts
+import fs5 from "fs/promises";
+import path5 from "path";
+async function readPackageJson(projectDir) {
+  const raw = await fs5.readFile(path5.join(projectDir, "package.json"), "utf8");
+  return JSON.parse(raw);
+}
+async function writePackageJson(projectDir, pkg) {
+  await fs5.writeFile(
+    path5.join(projectDir, "package.json"),
+    JSON.stringify(pkg, null, 2) + "\n",
+    "utf8"
+  );
+}
+function mergePackageJson(pkg, patch) {
+  if (patch.scripts) {
+    pkg.scripts = { ...pkg.scripts, ...patch.scripts };
+  }
+  if (patch.dependencies) {
+    pkg.dependencies = { ...pkg.dependencies, ...patch.dependencies };
+  }
+  if (patch.devDependencies) {
+    pkg.devDependencies = {
+      ...pkg.devDependencies,
+      ...patch.devDependencies
+    };
+  }
+  for (const [key, value] of Object.entries(patch)) {
+    if (key === "scripts" || key === "dependencies" || key === "devDependencies") {
+      continue;
+    }
+    pkg[key] = value;
+  }
+  for (const field of ["dependencies", "devDependencies"]) {
+    const map = pkg[field];
+    if (map) {
+      pkg[field] = Object.fromEntries(
+        Object.entries(map).sort(([a], [b]) => a.localeCompare(b))
+      );
+    }
+  }
+  return pkg;
+}
+function setProjectName(pkg, name) {
+  pkg.name = name;
+}
+
+// src/helpers/installDeps.ts
+import { execa } from "execa";
+import { spinner } from "@clack/prompts";
+
+// src/helpers/detectPM.ts
+import { detect } from "package-manager-detector/detect";
+async function detectPackageManager(cwd = process.cwd()) {
+  const detected = await detect({ cwd });
+  if (detected?.name === "pnpm") return "pnpm";
+  if (detected?.name === "yarn") return "yarn";
+  if (detected?.name === "bun") return "bun";
+  const ua = process.env.npm_config_user_agent ?? "";
+  if (ua.startsWith("pnpm")) return "pnpm";
+  if (ua.startsWith("yarn")) return "yarn";
+  if (ua.startsWith("bun")) return "bun";
+  return "npm";
+}
+function installCommand(pm) {
+  switch (pm) {
+    case "pnpm":
+      return { command: "pnpm", args: ["install"] };
+    case "yarn":
+      return { command: "yarn", args: [] };
+    case "bun":
+      return { command: "bun", args: ["install"] };
+    case "npm":
+    default:
+      return { command: "npm", args: ["install"] };
+  }
+}
+function runScript(pm, script) {
+  switch (pm) {
+    case "npm":
+      return `npm run ${script}`;
+    default:
+      return `${pm} ${script}`;
+  }
+}
+
+// src/helpers/installDeps.ts
+async function installDeps(projectDir) {
+  const pm = await detectPackageManager();
+  const { command, args } = installCommand(pm);
+  const s = spinner();
+  s.start(`Installing dependencies with ${pm}`);
+  try {
+    await execa(command, args, { cwd: projectDir, stdio: "pipe" });
+    s.stop(`Installed dependencies with ${pm}`);
+  } catch (err) {
+    s.stop(`Dependency install failed \u2014 run \`${command} ${args.join(" ")}\` manually.`);
+    throw err;
+  }
+  return pm;
+}
+
+// src/helpers/initGit.ts
+import path6 from "path";
+import fs6 from "fs/promises";
+import { execa as execa2 } from "execa";
+async function isInsideGitRepo(dir) {
+  try {
+    const { stdout } = await execa2("git", ["rev-parse", "--is-inside-work-tree"], {
+      cwd: dir,
+      stdio: "pipe"
+    });
+    return stdout.trim() === "true";
+  } catch {
+    return false;
+  }
+}
+async function initGit(projectDir) {
+  const dotGit = path6.join(projectDir, ".git");
+  try {
+    await fs6.access(dotGit);
+    return false;
+  } catch {
+  }
+  if (await isInsideGitRepo(path6.dirname(projectDir))) {
+    return false;
+  }
+  await execa2("git", ["init", "-b", "main"], { cwd: projectDir, stdio: "pipe" });
+  await execa2("git", ["add", "-A"], { cwd: projectDir, stdio: "pipe" });
+  await execa2(
+    "git",
+    ["commit", "-m", "Initial commit from create-crm-starter", "--no-verify"],
+    { cwd: projectDir, stdio: "pipe", env: { ...process.env, GIT_AUTHOR_NAME: process.env.GIT_AUTHOR_NAME ?? "create-crm-starter", GIT_AUTHOR_EMAIL: process.env.GIT_AUTHOR_EMAIL ?? "noreply@create-crm-starter" } }
+  ).catch(() => {
+  });
+  return true;
+}
+
+// src/helpers/nextSteps.ts
+import pc2 from "picocolors";
+import { note as note2 } from "@clack/prompts";
+function printNextSteps(opts) {
+  const { cfg, pm, installed } = opts;
+  const lines = [];
+  lines.push(pc2.cyan(`cd ${cfg.projectName}`));
+  if (!installed) {
+    lines.push(pc2.cyan(`${pm} install`));
+  }
+  if (cfg.stack === "clerk-convex") {
+    lines.push("");
+    lines.push(pc2.dim("# Configure Clerk (sign up at https://clerk.com)"));
+    lines.push(pc2.dim("# then fill NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY + CLERK_SECRET_KEY in .env.local"));
+    lines.push("");
+    lines.push(pc2.dim("# Configure Convex"));
+    lines.push(pc2.cyan(`${runScript(pm, "convex:dev")}    # follow prompts to create deployment`));
+  } else {
+    lines.push("");
+    lines.push(pc2.dim("# Set DATABASE_URL in .env.local (Postgres). Local Docker: `docker compose up -d`"));
+    lines.push(pc2.cyan(`${runScript(pm, "db:push")}       # apply schema`));
+  }
+  if (cfg.seed) {
+    lines.push(pc2.cyan(`${runScript(pm, "db:seed")}       # populate demo data`));
+  }
+  lines.push(pc2.cyan(`${runScript(pm, "dev")}             # start dev server`));
+  note2(lines.join("\n"), "Next steps");
+}
+
+// src/installers/auth-clerk.ts
+var installAuthClerk = async ({ projectDir, pkg }) => {
+  await copyExtra("auth-clerk", projectDir);
+  mergePackageJson(pkg, {
+    dependencies: {
+      "@clerk/nextjs": "^6.36.6"
+    }
+  });
+  await mergeEnv(projectDir, {
+    heading: "Clerk (https://clerk.com)",
+    vars: {
+      NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY: "pk_test_...",
+      CLERK_SECRET_KEY: "sk_test_...",
+      NEXT_PUBLIC_CLERK_SIGN_IN_URL: "/sign-in",
+      NEXT_PUBLIC_CLERK_SIGN_UP_URL: "/sign-up"
+    }
+  });
+};
+
+// src/installers/db-convex.ts
+var installDbConvex = async ({ projectDir, pkg }) => {
+  await copyExtra("db-convex", projectDir);
+  mergePackageJson(pkg, {
+    dependencies: {
+      convex: "^1.31.2"
+    },
+    scripts: {
+      "convex:dev": "convex dev",
+      "convex:deploy": "convex deploy"
+    }
+  });
+  await mergeEnv(projectDir, {
+    heading: "Convex (https://convex.dev)",
+    vars: {
+      NEXT_PUBLIC_CONVEX_URL: "https://<your-deployment>.convex.cloud"
+    }
+  });
+};
+
+// src/installers/auth-better-auth.ts
+import crypto from "crypto";
+var installAuthBetterAuth = async ({ projectDir, pkg }) => {
+  await copyExtra("auth-better-auth", projectDir);
+  mergePackageJson(pkg, {
+    dependencies: {
+      // Pinned exact: better-auth 1.6.12 ships a @better-auth/kysely-adapter
+      // that imports DEFAULT_MIGRATION_TABLE from a kysely version that no
+      // longer exports it, breaking `next build`. 1.6.11 is the last known-good.
+      // Re-test before bumping (and prefer reproducible client builds anyway).
+      "better-auth": "1.6.11"
+    }
+  });
+  const generatedSecret = crypto.randomBytes(32).toString("hex");
+  await mergeEnv(projectDir, {
+    heading: "Better-Auth",
+    // .env.example gets placeholders (never the real secret — it's committed).
+    vars: {
+      BETTER_AUTH_SECRET: "<generated at scaffold \u2014 see .env.local; regenerate for prod>",
+      BETTER_AUTH_URL: "http://localhost:3000",
+      NEXT_PUBLIC_BETTER_AUTH_URL: "http://localhost:3000"
+    },
+    // .env.local is pre-filled so `pnpm dev` works first-try (secret +
+    // localhost URLs). For production, set a fresh secret + real URL in Vercel.
+    localDefaults: {
+      BETTER_AUTH_SECRET: generatedSecret,
+      BETTER_AUTH_URL: "http://localhost:3000",
+      NEXT_PUBLIC_BETTER_AUTH_URL: "http://localhost:3000"
+    }
+  });
+};
+
+// src/installers/db-drizzle-pg.ts
+var installDbDrizzlePg = async ({ projectDir, pkg }) => {
+  await copyExtra("db-drizzle-pg", projectDir);
+  mergePackageJson(pkg, {
+    dependencies: {
+      "@tanstack/react-query": "^5.62.0",
+      "drizzle-orm": "^0.36.0",
+      postgres: "^3.4.5"
+    },
+    devDependencies: {
+      dotenv: "^16.4.7",
+      "drizzle-kit": "^0.30.0",
+      tsx: "^4.19.0"
+    },
+    scripts: {
+      "db:generate": "drizzle-kit generate",
+      "db:push": "drizzle-kit push",
+      "db:studio": "drizzle-kit studio"
+    }
+  });
+  await mergeEnv(projectDir, {
+    heading: "Postgres + Drizzle",
+    vars: {
+      DATABASE_URL: "postgres://postgres:postgres@localhost:5432/crm"
+    },
+    // Pre-fill the local docker-compose connection string so
+    // `docker compose up -d && pnpm db:push` works first-try in dev.
+    // Swap for your Neon URL (or set it in Vercel) for production.
+    localDefaults: {
+      DATABASE_URL: "postgres://postgres:postgres@localhost:5432/crm"
+    }
+  });
+};
+
+// src/installers/landing-page.ts
+var installLandingPage = async ({ projectDir, cfg }) => {
+  await copyExtra("landing-page/_shared", projectDir);
+  if (cfg.stack === "better-auth-drizzle") {
+    await copyExtra("landing-page/drizzle", projectDir);
+  }
+};
+
+// src/installers/customers.ts
+import fs8 from "fs/promises";
+import path8 from "path";
+
+// src/helpers/insertAtMarker.ts
+import fs7 from "fs/promises";
+import path7 from "path";
+async function insertAtMarker(opts) {
+  const { filePath, marker, content } = opts;
+  let raw;
+  try {
+    raw = await fs7.readFile(filePath, "utf8");
+  } catch {
+    return;
+  }
+  if (raw.includes(content)) return;
+  const next = raw.includes(marker) ? raw.replace(marker, `${content}
+${marker}`) : `${raw}
+${content}
+`;
+  await fs7.writeFile(filePath, next, "utf8");
+}
+async function appendImport(opts) {
+  const { filePath, importLine } = opts;
+  let raw;
+  try {
+    raw = await fs7.readFile(filePath, "utf8");
+  } catch {
+    return;
+  }
+  if (raw.includes(importLine)) return;
+  const lines = raw.split("\n");
+  let lastImportIdx = -1;
+  for (let i = 0; i < lines.length; i++) {
+    if (/^\s*import\b/.test(lines[i])) lastImportIdx = i;
+  }
+  if (lastImportIdx >= 0) {
+    lines.splice(lastImportIdx + 1, 0, importLine);
+  } else {
+    lines.unshift(importLine);
+  }
+  await fs7.writeFile(filePath, lines.join("\n"), "utf8");
+}
+
+// src/installers/customers.ts
+var installCustomers = async ({ projectDir, cfg }) => {
+  await copyExtra("customers/_shared", projectDir);
+  if (cfg.stack === "clerk-convex") {
+    const fragmentPath = path8.join(
+      templateExtrasDir,
+      "customers",
+      "_fragments",
+      "convex.txt"
+    );
+    const fragment = await fs8.readFile(fragmentPath, "utf8");
+    await insertAtMarker({
+      filePath: path8.join(projectDir, "convex", "schema.ts"),
+      marker: "// <crm-starter:tables>",
+      content: fragment
+    });
+    await copyExtra("customers/convex", projectDir);
+  } else {
+    await copyExtra("customers/drizzle", projectDir);
+    await insertAtMarker({
+      filePath: path8.join(projectDir, "src", "db", "schema", "index.ts"),
+      marker: "// <crm-starter:exports>",
+      content: `export * from './customers';`
+    });
+  }
+};
+
+// src/installers/jobs.ts
+import fs9 from "fs/promises";
+import path9 from "path";
+var installJobs = async ({ projectDir, cfg, pkg }) => {
+  await copyExtra("jobs/_shared", projectDir);
+  if (cfg.stack === "clerk-convex") {
+    const fragmentPath = path9.join(templateExtrasDir, "jobs", "_fragments", "convex.txt");
+    const fragment = await fs9.readFile(fragmentPath, "utf8");
+    await insertAtMarker({
+      filePath: path9.join(projectDir, "convex", "schema.ts"),
+      marker: "// <crm-starter:tables>",
+      content: fragment
+    });
+    await copyExtra("jobs/convex", projectDir);
+  } else {
+    await copyExtra("jobs/drizzle", projectDir);
+    await insertAtMarker({
+      filePath: path9.join(projectDir, "src", "db", "schema", "index.ts"),
+      marker: "// <crm-starter:exports>",
+      content: `export * from './jobs';
+export * from './job-attachments';`
+    });
+    mergePackageJson(pkg, {
+      dependencies: {
+        "@aws-sdk/client-s3": "^3.717.0"
+      }
+    });
+    await mergeEnv(projectDir, {
+      heading: "Cloudflare R2 (job photos + attachments)",
+      vars: {
+        R2_ACCOUNT_ID: "",
+        R2_ACCESS_KEY_ID: "",
+        R2_SECRET_ACCESS_KEY: "",
+        R2_BUCKET: "",
+        R2_PUBLIC_URL: "https://your-bucket.r2.dev"
+      }
+    });
+  }
+};
+
+// src/installers/estimates-invoices.ts
+import path10 from "path";
+var installEstimatesInvoices = async ({ projectDir, cfg }) => {
+  await copyExtra("estimates-invoices/_shared", projectDir);
+  if (cfg.stack === "better-auth-drizzle") {
+    await copyExtra("estimates-invoices/drizzle", projectDir);
+    await insertAtMarker({
+      filePath: path10.join(projectDir, "src", "db", "schema", "index.ts"),
+      marker: "// <crm-starter:exports>",
+      content: `export * from './estimates';
+export * from './invoices';`
+    });
+  }
+};
+
+// src/installers/calendar-dispatch.ts
+var installCalendarDispatch = async ({ projectDir, cfg, pkg }) => {
+  await copyExtra("calendar-dispatch/_shared", projectDir);
+  if (cfg.stack === "better-auth-drizzle") {
+    await copyExtra("calendar-dispatch/drizzle", projectDir);
+  }
+  mergePackageJson(pkg, {
+    dependencies: {
+      "@dnd-kit/core": "^6.3.1",
+      "@dnd-kit/sortable": "^10.0.0",
+      "date-fns": "^4.1.0"
+    }
+  });
+};
+
+// src/installers/payments-stripe.ts
+var installPaymentsStripe = async ({ projectDir, pkg }) => {
+  await copyExtra("payments-stripe", projectDir);
+  mergePackageJson(pkg, {
+    dependencies: {
+      stripe: "^17.4.0",
+      "@stripe/stripe-js": "^5.3.0"
+    }
+  });
+  await mergeEnv(projectDir, {
+    heading: "Stripe",
+    vars: {
+      STRIPE_SECRET_KEY: "sk_test_...",
+      STRIPE_WEBHOOK_SECRET: "whsec_...",
+      NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY: "pk_test_..."
+    }
+  });
+};
+
+// src/installers/comms-sms.ts
+import path11 from "path";
+var installCommsSms = async ({ projectDir, cfg, pkg }) => {
+  await copyExtra("comms-sms/_shared", projectDir);
+  if (cfg.stack === "better-auth-drizzle") {
+    await copyExtra("comms-sms/drizzle", projectDir);
+    await insertAtMarker({
+      filePath: path11.join(projectDir, "src", "db", "schema", "index.ts"),
+      marker: "// <crm-starter:exports>",
+      content: `export * from './sms-messages';`
+    });
+  }
+  mergePackageJson(pkg, {
+    dependencies: {
+      twilio: "^5.11.2",
+      "libphonenumber-js": "^1.12.0"
+    }
+  });
+  await mergeEnv(projectDir, {
+    heading: "Twilio (SMS)",
+    vars: {
+      TWILIO_ACCOUNT_SID: "AC...",
+      TWILIO_AUTH_TOKEN: "...",
+      TWILIO_PHONE_NUMBER: "+15555555555"
+    }
+  });
+};
+
+// src/installers/comms-email.ts
+var installCommsEmail = async ({ projectDir, pkg }) => {
+  await copyExtra("comms-email", projectDir);
+  mergePackageJson(pkg, {
+    dependencies: {
+      resend: "^4.0.0",
+      "react-email": "^3.0.0",
+      "@react-email/components": "^0.0.31"
+    }
+  });
+  await mergeEnv(projectDir, {
+    heading: "Resend (email)",
+    vars: {
+      RESEND_API_KEY: "re_...",
+      EMAIL_FROM: "noreply@yourbusiness.com"
+    }
+  });
+};
+
+// src/installers/reviews.ts
+var installReviews = async ({ projectDir }) => {
+  await copyExtra("reviews", projectDir);
+};
+
+// src/installers/reporting.ts
+var installReporting = async ({ projectDir, pkg }) => {
+  await copyExtra("reporting", projectDir);
+  mergePackageJson(pkg, {
+    dependencies: {
+      recharts: "^2.13.0"
+    }
+  });
+};
+
+// src/installers/seed.ts
+var installSeed = async ({ projectDir, cfg, pkg }) => {
+  await copyExtra("seed/_shared", projectDir);
+  if (cfg.stack === "better-auth-drizzle") {
+    await copyExtra("seed/drizzle", projectDir);
+    mergePackageJson(pkg, {
+      dependencies: { dotenv: "^16.4.7" }
+    });
+  }
+  mergePackageJson(pkg, {
+    devDependencies: {
+      "@faker-js/faker": "^9.3.0",
+      tsx: "^4.19.0"
+    },
+    scripts: {
+      "db:seed": "tsx scripts/seed.ts"
+    }
+  });
+};
+
+// src/installers/price-book.ts
+import path12 from "path";
+var installPriceBook = async ({ projectDir, cfg }) => {
+  await copyExtra("price-book/_shared", projectDir);
+  if (cfg.stack === "better-auth-drizzle") {
+    await copyExtra("price-book/drizzle", projectDir);
+    await insertAtMarker({
+      filePath: path12.join(projectDir, "src", "db", "schema", "index.ts"),
+      marker: "// <crm-starter:exports>",
+      content: `export * from './price-book';`
+    });
+  }
+};
+
+// src/installers/customer-portal.ts
+var installCustomerPortal = async ({ projectDir, cfg }) => {
+  await copyExtra("customer-portal/_shared", projectDir);
+  if (cfg.stack === "better-auth-drizzle") {
+    await copyExtra("customer-portal/drizzle", projectDir);
+  }
+};
+
+// src/installers/service-plans.ts
+import path13 from "path";
+var installServicePlans = async ({ projectDir, cfg }) => {
+  await copyExtra("service-plans/_shared", projectDir);
+  if (cfg.stack === "better-auth-drizzle") {
+    await copyExtra("service-plans/drizzle", projectDir);
+    await insertAtMarker({
+      filePath: path13.join(projectDir, "src", "db", "schema", "index.ts"),
+      marker: "// <crm-starter:exports>",
+      content: `export * from './service-plans';`
+    });
+  }
+};
+
+// src/installers/checklists.ts
+import path14 from "path";
+var installChecklists = async ({ projectDir, cfg }) => {
+  await copyExtra("checklists/_shared", projectDir);
+  if (cfg.stack === "better-auth-drizzle") {
+    await copyExtra("checklists/drizzle", projectDir);
+    await insertAtMarker({
+      filePath: path14.join(projectDir, "src", "db", "schema", "index.ts"),
+      marker: "// <crm-starter:exports>",
+      content: `export * from './checklists';`
+    });
+  }
+};
+
+// src/installers/industry-extras.ts
+var installEquipmentTracking = async ({ projectDir }) => {
+  await copyExtra("equipment-tracking", projectDir);
+};
+var installMaintenancePlans = async ({ projectDir }) => {
+  await copyExtra("maintenance-plans", projectDir);
+};
+var installEmergencyDispatch = async ({ projectDir }) => {
+  await copyExtra("emergency-dispatch", projectDir);
+};
+var installPermitTracking = async ({ projectDir }) => {
+  await copyExtra("permit-tracking", projectDir);
+};
+var installInspectionChecklists = async ({ projectDir }) => {
+  await copyExtra("inspection-checklists", projectDir);
+};
+
+// src/installers/brand.ts
+import fs10 from "fs/promises";
+import path15 from "path";
+function hexToHslTriplet(hex) {
+  const m = /^#?([0-9a-f]{6})$/i.exec(hex.trim());
+  if (!m) return "199 89% 48%";
+  const value = m[1];
+  const r = parseInt(value.slice(0, 2), 16) / 255;
+  const g = parseInt(value.slice(2, 4), 16) / 255;
+  const b = parseInt(value.slice(4, 6), 16) / 255;
+  const max = Math.max(r, g, b);
+  const min = Math.min(r, g, b);
+  const l = (max + min) / 2;
+  let h = 0;
+  let s = 0;
+  if (max !== min) {
+    const d = max - min;
+    s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+    switch (max) {
+      case r:
+        h = (g - b) / d + (g < b ? 6 : 0);
+        break;
+      case g:
+        h = (b - r) / d + 2;
+        break;
+      case b:
+        h = (r - g) / d + 4;
+        break;
+    }
+    h /= 6;
+  }
+  return `${Math.round(h * 360)} ${Math.round(s * 100)}% ${Math.round(l * 100)}%`;
+}
+var installBrand = async ({ projectDir, cfg }) => {
+  const cssPath = path15.join(projectDir, "src", "app", "globals.css");
+  try {
+    const css = await fs10.readFile(cssPath, "utf8");
+    const primaryHsl = hexToHslTriplet(cfg.primaryColor);
+    const accentHsl = hexToHslTriplet(cfg.accentColor);
+    const next = css.replace(/--brand: [^;]+;/g, `--brand: ${primaryHsl};`).replace(/--brand-hex: [^;]+;/g, `--brand-hex: ${cfg.primaryColor};`).replace(/--brand-accent: [^;]+;/g, `--brand-accent: ${accentHsl};`).replace(/--brand-accent-hex: [^;]+;/g, `--brand-accent-hex: ${cfg.accentColor};`);
+    await fs10.writeFile(cssPath, next, "utf8");
+  } catch {
+  }
+};
+
+// src/installers/logo.ts
+import fs11 from "fs/promises";
+import path16 from "path";
+var installLogo = async ({ projectDir, cfg }) => {
+  if (!cfg.logoPath) return;
+  const sourcePath = cfg.logoPath.replace(/^~/, process.env.HOME ?? "");
+  try {
+    await fs11.access(sourcePath);
+  } catch {
+    return;
+  }
+  const ext = path16.extname(sourcePath).toLowerCase();
+  const publicDir = path16.join(projectDir, "public");
+  await fs11.mkdir(publicDir, { recursive: true });
+  await fs11.copyFile(sourcePath, path16.join(publicDir, `logo${ext}`));
+};
+
+// src/installers/business-info.ts
+import fs12 from "fs/promises";
+import path17 from "path";
+var installBusinessInfo = async ({ projectDir, cfg }) => {
+  const libDir = path17.join(projectDir, "src", "lib");
+  await fs12.mkdir(libDir, { recursive: true });
+  const businessModule = `/**
+ * Canonical business identity + contact info \u2014 generated at scaffold time
+ * by create-crm-starter. Edit here once; it surfaces everywhere (headers,
+ * landing page, transactional emails, invoices, customer portal).
+ */
+export const business = {
+  name: ${JSON.stringify(cfg.businessName)},
+  legalName: ${JSON.stringify(cfg.businessLegalName ?? cfg.businessName)},
+  tagline: ${JSON.stringify(cfg.tagline ?? "")},
+  industry: ${JSON.stringify(cfg.industry)},
+  phone: ${JSON.stringify(cfg.businessPhone ?? "")},
+  email: ${JSON.stringify(cfg.businessEmail ?? "")},
+  address: ${JSON.stringify(cfg.businessAddress ?? "")},
+  serviceAreaZips: ${JSON.stringify(
+    cfg.serviceAreaZips ? cfg.serviceAreaZips.split(",").map((z) => z.trim()).filter(Boolean) : []
+  )},
+  brand: {
+    primary: ${JSON.stringify(cfg.primaryColor)},
+    accent: ${JSON.stringify(cfg.accentColor)},
+    logoSrc: ${JSON.stringify(cfg.logoPath ? `/logo${path17.extname(cfg.logoPath).toLowerCase()}` : "")},
+  },
+} as const;
+
+export type Business = typeof business;
+`;
+  await fs12.writeFile(path17.join(libDir, "business.ts"), businessModule, "utf8");
+  const layoutPath = path17.join(projectDir, "src", "app", "layout.tsx");
+  try {
+    const layout = await fs12.readFile(layoutPath, "utf8");
+    const titleEscaped = cfg.businessName.replace(/'/g, "\\'");
+    const description = cfg.tagline?.trim() ? cfg.tagline.replace(/'/g, "\\'") : `${titleEscaped} \u2014 home-services CRM`;
+    const next = layout.replace(/title:\s*'[^']*'/, `title: '${titleEscaped}'`).replace(/description:\s*'[^']*'/, `description: '${description}'`);
+    if (next !== layout) {
+      await fs12.writeFile(layoutPath, next, "utf8");
+    }
+  } catch {
+  }
+  if (cfg.stack === "better-auth-drizzle") {
+    const block = (value) => `
+# --- Admin bootstrap ---
+ADMIN_BOOTSTRAP_EMAIL=${value}
+`;
+    try {
+      await fs12.appendFile(
+        path17.join(projectDir, ".env.local"),
+        block(cfg.ownerEmail ?? ""),
+        "utf8"
+      );
+      await fs12.appendFile(
+        path17.join(projectDir, ".env.example"),
+        block("owner@example.com"),
+        "utf8"
+      );
+    } catch {
+    }
+  }
+};
+
+// src/installers/mobile-api.ts
+import fs13 from "fs/promises";
+import path18 from "path";
+
+// src/helpers/mobileBrand.ts
+function mobileBrand(cfg) {
+  const base = cfg.projectName.replace(/[^a-z0-9]/gi, "").toLowerCase() || "crmapp";
+  return {
+    name: `${cfg.businessName} Field`,
+    slug: cfg.projectName,
+    scheme: base,
+    bundleId: `com.crmstarter.${base}`,
+    primaryColor: cfg.primaryColor,
+    accentColor: cfg.accentColor
+  };
+}
+
+// src/installers/mobile-api.ts
+var installMobileApi = async ({ projectDir, cfg, pkg }) => {
+  await copyExtra("mobile-api/drizzle", projectDir);
+  await insertAtMarker({
+    filePath: path18.join(projectDir, "src", "db", "schema", "index.ts"),
+    marker: "// <crm-starter:exports>",
+    content: `export * from './push-tokens';
+export * from './time-entries';`
+  });
+  if (cfg.estimatesInvoices && cfg.payments) {
+    await copyExtra("mobile-api/invoices", projectDir);
+  }
+  if (cfg.estimatesInvoices) {
+    await copyExtra("mobile-api/estimates", projectDir);
+  }
+  if (cfg.comms.includes("sms")) {
+    await copyExtra("mobile-api/sms", projectDir);
+  }
+  const authPath = path18.join(projectDir, "src", "lib", "auth.ts");
+  try {
+    const raw = await fs13.readFile(authPath, "utf8");
+    if (raw.includes("// <crm-starter:auth-plugins>")) {
+      const patched = raw.replace(
+        "  plugins: [nextCookies()], // <crm-starter:auth-plugins>",
+        [
+          "  // Mobile app deep-link origin (set MOBILE_APP_SCHEME in env).",
+          "  trustedOrigins: process.env.MOBILE_APP_SCHEME ? [process.env.MOBILE_APP_SCHEME] : [],",
+          "  plugins: [bearer(), nextCookies()],"
+        ].join("\n")
+      );
+      await fs13.writeFile(authPath, patched, "utf8");
+      await appendImport({ filePath: authPath, importLine: "import { bearer } from 'better-auth/plugins';" });
+    }
+  } catch {
+  }
+  await insertAtMarker({
+    filePath: path18.join(projectDir, "src", "lib", "calendar", "actions.ts"),
+    marker: "// <crm-starter:assign-hook>",
+    content: [
+      "  if (input.technicianId) {",
+      "    const { sendPushToUser } = await import('@/lib/push/send');",
+      "    await sendPushToUser(input.technicianId, {",
+      "      title: 'New job assigned',",
+      "      body: 'A job was added to your schedule.',",
+      "      data: { jobId: input.jobId },",
+      "    });",
+      "  }"
+    ].join("\n")
+  });
+  mergePackageJson(pkg, {
+    dependencies: {
+      "@aws-sdk/s3-request-presigner": "^3.717.0",
+      "@aws-sdk/client-s3": "^3.717.0"
+    }
+  });
+  const { scheme } = mobileBrand(cfg);
+  await mergeEnv(projectDir, {
+    heading: "Mobile (field-tech iPhone app)",
+    vars: {
+      MOBILE_APP_SCHEME: `${scheme}://`,
+      EXPO_ACCESS_TOKEN: ""
+    },
+    localDefaults: {
+      MOBILE_APP_SCHEME: `${scheme}://`
+    }
+  });
+};
+
+// src/installers/mobile.ts
+import fs14 from "fs/promises";
+import path19 from "path";
+var installMobile = async ({ projectDir, cfg }) => {
+  await copyExtra("mobile", projectDir);
+  const mobileDir = path19.join(projectDir, "mobile");
+  const brand = mobileBrand(cfg);
+  const brandModule = `/**
+ * Per-client branding for the field-tech app \u2014 generated by
+ * create-crm-starter from your scaffold inputs. Re-run the scaffolder (or
+ * edit your inputs) to rebrand; change the bundleId prefix to your Apple
+ * Developer team's reverse-domain before submitting to the App Store.
+ */
+export const brand = {
+  name: ${JSON.stringify(brand.name)},
+  slug: ${JSON.stringify(brand.slug)},
+  scheme: ${JSON.stringify(brand.scheme)},
+  bundleId: ${JSON.stringify(brand.bundleId)},
+  primaryColor: ${JSON.stringify(brand.primaryColor)},
+  accentColor: ${JSON.stringify(brand.accentColor)},
+} as const;
+`;
+  await fs14.writeFile(path19.join(mobileDir, "app.brand.ts"), brandModule, "utf8");
+  const featuresModule = `/**
+ * Which optional features this client's CRM exposes \u2014 generated by
+ * create-crm-starter from your scaffold choices. The app hides buttons/tabs
+ * for features the backend doesn't have. (Checklists + time tracking are
+ * always available.)
+ */
+export const features = {
+  invoices: ${cfg.estimatesInvoices && cfg.payments},
+  estimates: ${cfg.estimatesInvoices},
+  sms: ${cfg.comms.includes("sms")},
+} as const;
+`;
+  await fs14.writeFile(path19.join(mobileDir, "app.features.ts"), featuresModule, "utf8");
+  await fs14.writeFile(
+    path19.join(mobileDir, ".env"),
+    `EXPO_PUBLIC_API_URL=https://your-client-domain.com
+`,
+    "utf8"
+  );
+};
+
+// src/installers/readme.ts
+import fs15 from "fs/promises";
+import path20 from "path";
+
+// src/helpers/envSchema.ts
+var ENV_SCHEMA = {
+  "auth-clerk": [
+    {
+      key: "NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY",
+      label: "Clerk Publishable Key",
+      description: "Public key shared with the browser (pk_test_\u2026 or pk_live_\u2026)",
+      required: true,
+      example: "pk_test_\u2026",
+      helpUrl: "https://dashboard.clerk.com/last-active?path=api-keys",
+      category: "auth"
+    },
+    {
+      key: "CLERK_SECRET_KEY",
+      label: "Clerk Secret Key",
+      description: "Server-only key, sk_test_\u2026 or sk_live_\u2026",
+      required: true,
+      example: "sk_test_\u2026",
+      helpUrl: "https://dashboard.clerk.com/last-active?path=api-keys",
+      category: "auth"
+    },
+    {
+      key: "NEXT_PUBLIC_CLERK_SIGN_IN_URL",
+      label: "Clerk sign-in URL",
+      description: "Where unauthed users get redirected. /sign-in is the default route.",
+      required: false,
+      example: "/sign-in",
+      category: "auth"
+    },
+    {
+      key: "NEXT_PUBLIC_CLERK_SIGN_UP_URL",
+      label: "Clerk sign-up URL",
+      description: "Where new users land. /sign-up is the default route.",
+      required: false,
+      example: "/sign-up",
+      category: "auth"
+    }
+  ],
+  "auth-better-auth": [
+    {
+      key: "BETTER_AUTH_SECRET",
+      label: "Better-Auth signing secret",
+      description: "32+ random bytes used to sign session JWTs. Auto-generated at scaffold time \u2014 keep it secret.",
+      required: true,
+      example: "<32-byte hex string>",
+      category: "auth"
+    },
+    {
+      key: "BETTER_AUTH_URL",
+      label: "App URL",
+      description: "Full https URL of the deployed app \u2014 needed for OAuth callbacks.",
+      required: true,
+      example: "https://your-domain.com",
+      category: "auth"
+    },
+    {
+      key: "NEXT_PUBLIC_BETTER_AUTH_URL",
+      label: "App URL (public)",
+      description: "Same as BETTER_AUTH_URL but exposed to the browser for client-side auth helpers.",
+      required: true,
+      example: "https://your-domain.com",
+      category: "auth"
+    }
+  ],
+  "db-convex": [
+    {
+      key: "NEXT_PUBLIC_CONVEX_URL",
+      label: "Convex deployment URL",
+      description: "Get this by running `npx convex dev` once \u2014 it creates a deployment and prints the URL.",
+      required: true,
+      example: "https://<your-deployment>.convex.cloud",
+      helpUrl: "https://docs.convex.dev/dashboard/deployments",
+      category: "database"
+    }
+  ],
+  "db-drizzle-pg": [
+    {
+      key: "DATABASE_URL",
+      label: "Postgres connection string",
+      description: "Use Neon, Supabase, RDS, or the included docker-compose for local dev.",
+      required: true,
+      example: "postgres://user:pass@host:5432/dbname",
+      helpUrl: "https://neon.tech",
+      category: "database"
+    }
+  ],
+  "payments-stripe": [
+    {
+      key: "STRIPE_SECRET_KEY",
+      label: "Stripe Secret Key",
+      description: "Server-only key, sk_test_\u2026 or sk_live_\u2026",
+      required: true,
+      example: "sk_test_\u2026",
+      helpUrl: "https://dashboard.stripe.com/apikeys",
+      category: "payments"
+    },
+    {
+      key: "STRIPE_WEBHOOK_SECRET",
+      label: "Stripe Webhook Signing Secret",
+      description: "whsec_\u2026 \u2014 get it from the Webhook endpoint settings in Stripe.",
+      required: true,
+      example: "whsec_\u2026",
+      helpUrl: "https://dashboard.stripe.com/webhooks",
+      category: "payments"
+    },
+    {
+      key: "NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY",
+      label: "Stripe Publishable Key",
+      description: "Public key for browser, pk_test_\u2026 or pk_live_\u2026",
+      required: true,
+      example: "pk_test_\u2026",
+      helpUrl: "https://dashboard.stripe.com/apikeys",
+      category: "payments"
+    }
+  ],
+  "comms-sms": [
+    {
+      key: "TWILIO_ACCOUNT_SID",
+      label: "Twilio Account SID",
+      description: "AC\u2026 \u2014 find it on the Twilio console dashboard.",
+      required: true,
+      example: "AC\u2026",
+      helpUrl: "https://console.twilio.com",
+      category: "comms"
+    },
+    {
+      key: "TWILIO_AUTH_TOKEN",
+      label: "Twilio Auth Token",
+      description: "Server-only Twilio auth token.",
+      required: true,
+      example: "<auth token>",
+      helpUrl: "https://console.twilio.com",
+      category: "comms"
+    },
+    {
+      key: "TWILIO_PHONE_NUMBER",
+      label: "Twilio Phone Number",
+      description: "The number SMS will be sent from + the number customers reply to. E.164 (+1\u2026).",
+      required: true,
+      example: "+15125550100",
+      helpUrl: "https://console.twilio.com/us1/develop/phone-numbers/manage/active",
+      category: "comms"
+    }
+  ],
+  "comms-email": [
+    {
+      key: "RESEND_API_KEY",
+      label: "Resend API Key",
+      description: "re_\u2026 \u2014 server-only.",
+      required: true,
+      example: "re_\u2026",
+      helpUrl: "https://resend.com/api-keys",
+      category: "comms"
+    },
+    {
+      key: "EMAIL_FROM",
+      label: "Sender email",
+      description: "A verified email at your sending domain (e.g. hello@yourbusiness.com).",
+      required: true,
+      example: "hello@yourbusiness.com",
+      helpUrl: "https://resend.com/domains",
+      category: "comms"
+    }
+  ],
+  jobs: [
+    {
+      key: "R2_ACCOUNT_ID",
+      label: "Cloudflare account ID",
+      description: "Used for job photo uploads. Find it in the Cloudflare R2 dashboard.",
+      required: false,
+      helpUrl: "https://dash.cloudflare.com/?to=/:account/r2",
+      category: "storage"
+    },
+    {
+      key: "R2_ACCESS_KEY_ID",
+      label: "R2 API token access key",
+      description: "Create an R2 API token with read+write permission, scope to one bucket.",
+      required: false,
+      category: "storage"
+    },
+    {
+      key: "R2_SECRET_ACCESS_KEY",
+      label: "R2 API token secret",
+      description: "Shown once when creating the token \u2014 store it securely.",
+      required: false,
+      category: "storage"
+    },
+    {
+      key: "R2_BUCKET",
+      label: "R2 bucket name",
+      description: "Just the name (no slashes).",
+      required: false,
+      example: "my-crm-uploads",
+      category: "storage"
+    },
+    {
+      key: "R2_PUBLIC_URL",
+      label: "R2 public URL",
+      description: "Public URL for the bucket (custom domain or pub-\u2026 URL). Required for rendering uploaded images.",
+      required: false,
+      example: "https://pub-\u2026.r2.dev",
+      category: "storage"
+    }
+  ],
+  "mobile-api": [
+    {
+      key: "MOBILE_APP_SCHEME",
+      label: "Mobile app URL scheme",
+      description: "Deep-link scheme of the field-tech app (e.g. yourapp://). Registered as a trusted origin for token auth. Auto-set at scaffold time.",
+      required: false,
+      example: "yourapp://",
+      category: "mobile"
+    },
+    {
+      key: "EXPO_ACCESS_TOKEN",
+      label: "Expo access token (optional)",
+      description: "Only needed for enhanced push-notification security. Basic Expo push works without it.",
+      required: false,
+      helpUrl: "https://docs.expo.dev/push-notifications/sending-notifications/",
+      category: "mobile"
+    }
+  ]
+};
+function getEnvVarsForConfig(cfg) {
+  const modules = [];
+  if (cfg.stack === "clerk-convex") {
+    modules.push("auth-clerk", "db-convex");
+  } else {
+    modules.push("auth-better-auth", "db-drizzle-pg");
+  }
+  if (cfg.payments) modules.push("payments-stripe");
+  if (cfg.comms.includes("sms")) modules.push("comms-sms");
+  if (cfg.comms.includes("email")) modules.push("comms-email");
+  if (cfg.jobs) modules.push("jobs");
+  if (cfg.mobileApp && cfg.stack === "better-auth-drizzle" && cfg.jobs && cfg.customers) {
+    modules.push("mobile-api");
+  }
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const m of modules) {
+    for (const spec of ENV_SCHEMA[m] ?? []) {
+      if (seen.has(spec.key)) continue;
+      seen.add(spec.key);
+      out.push(spec);
+    }
+  }
+  return out;
+}
+
+// src/helpers/vercelDeployUrl.ts
+function buildVercelDeployUrl(opts) {
+  const required = getEnvVarsForConfig(opts.cfg).filter((v) => v.required);
+  const params = new URLSearchParams();
+  if (opts.repositoryUrl) params.set("repository-url", opts.repositoryUrl);
+  params.set("project-name", opts.projectName ?? opts.cfg.projectName);
+  if (required.length > 0) {
+    params.set("env", required.map((v) => v.key).join(","));
+    params.set(
+      "envDescription",
+      required.map((v) => `${v.key} \u2014 ${v.description}`).join(" \xB7 ")
+    );
+    if (opts.repositoryUrl) {
+      const trimmed = opts.repositoryUrl.replace(/\.git$/, "");
+      params.set("envLink", `${trimmed}#environment-variables`);
+    }
+  }
+  return `https://vercel.com/new/clone?${params.toString()}`;
+}
+
+// src/installers/readme.ts
+var installReadme = async ({ projectDir, cfg }) => {
+  const vars = getEnvVarsForConfig(cfg);
+  const byCategory = groupByCategory(vars);
+  const isConvex = cfg.stack === "clerk-convex";
+  const preview = (label) => isConvex ? `${label} _(preview \u2014 sample data on Convex)_` : label;
+  const features = [];
+  if (cfg.landingPage) features.push("Public landing page" + (cfg.onlineBooking ? " with online booking widget" : ""));
+  if (cfg.customers) features.push("Customers / contacts management");
+  if (cfg.jobs) features.push("Jobs with status pipeline + line items + photos");
+  if (cfg.estimatesInvoices) features.push(preview("Estimates + invoices with Stripe payment links"));
+  if (cfg.calendarDispatch) features.push("Drag-drop dispatch calendar");
+  if (cfg.payments) features.push("Stripe Checkout (one-off + recurring)");
+  if (cfg.comms.includes("sms")) features.push(preview("Two-way SMS inbox (Twilio)"));
+  if (cfg.comms.includes("email")) features.push("Transactional email (Resend)");
+  if (cfg.reviews) features.push("Review collection");
+  if (cfg.reporting) features.push("Reporting dashboard");
+  if (cfg.mobileApp) features.push("Field-tech iPhone app (Expo) \u2014 see `mobile/README.md`");
+  if (!isConvex && cfg.customers && cfg.jobs && cfg.estimatesInvoices) {
+    features.push("Customer portal at `/portal/[token]`");
+  }
+  for (const extra of cfg.industryExtras) {
+    features.push(`Industry module: ${extra}`);
+  }
+  const setupSteps = buildSetupSteps(cfg);
+  const deployUrl = buildVercelDeployUrl({ cfg });
+  const businessLine = cfg.businessLegalName && cfg.businessLegalName !== cfg.businessName ? `**${cfg.businessName}** *(${cfg.businessLegalName})*` : `**${cfg.businessName}**`;
+  const readme = `# ${cfg.businessName}
+
+${cfg.tagline ?? `Custom CRM for ${cfg.businessName}.`}
+
+${businessLine}${cfg.businessPhone ? ` \xB7 ${cfg.businessPhone}` : ""}${cfg.businessEmail ? ` \xB7 ${cfg.businessEmail}` : ""}
+
+---
+
+## \u26A1 One-click deploy
+
+[![Deploy with Vercel](https://vercel.com/button)](${deployUrl})
+
+After deploy, fill in the env vars below \u2014 see [Environment variables](#environment-variables) for full descriptions.
+
+---
+
+## \u{1F6E0} Local dev
+
+\`\`\`bash
+pnpm install
+pnpm setup              # interactive env wizard \u2014 fills in .env.local
+${cfg.stack === "better-auth-drizzle" ? "pnpm db:push           # apply schema to your Postgres" : "pnpm convex:dev        # first run prompts you to create a Convex deployment"}
+${cfg.seed ? "pnpm db:seed           # populate realistic demo data\n" : ""}pnpm dev               # http://localhost:3000
+\`\`\`
+
+${cfg.ownerName || cfg.ownerEmail ? `First admin to seed:
+- Name: ${cfg.ownerName ?? "(not set)"}
+- Email: ${cfg.ownerEmail ?? "(not set)"}
+
+Sign up with that email at \`/sign-up\` to get admin access.
+` : ""}
+---
+
+## \u2728 What's in the box
+
+${features.map((f) => `- ${f}`).join("\n")}
+
+Stack: ${stackLabel(cfg.stack)}.
+
+---
+
+## \u{1F510} Environment variables
+
+${vars.length === 0 ? "_No external integrations required._" : Object.entries(byCategory).map(
+    ([category, list]) => `### ${categoryLabel(category)}
+
+${list.map(
+      (v) => `- **${v.key}** ${v.required ? "*(required)*" : "*(optional)*"}
+  ${v.description}${v.example ? `
+  - Example: \`${v.example}\`` : ""}${v.helpUrl ? `
+  - Get it: [${v.helpUrl}](${v.helpUrl})` : ""}`
+    ).join("\n")}`
+  ).join("\n\n")}
+
+Set them in \`.env.local\` for local dev. The \`pnpm setup\` script walks you through them interactively.
+
+---
+
+## \u{1F680} Hand-off checklist
+
+${setupSteps.map((s, i) => `${i + 1}. ${s}`).join("\n")}
+
+---
+
+## \u{1F4E6} Generated with [create-crm-starter](https://github.com/dougallen/crm-starter)
+
+Industry preset: **${cfg.industry}** \xB7 Deploy target: **${cfg.deployTarget}** \xB7 Brand: ${cfg.primaryColor}${cfg.accentColor ? ` + ${cfg.accentColor}` : ""}
+`;
+  await fs15.writeFile(path20.join(projectDir, "README.md"), readme, "utf8");
+};
+function groupByCategory(vars) {
+  const out = {};
+  for (const v of vars) {
+    (out[v.category] ??= []).push(v);
+  }
+  return out;
+}
+function categoryLabel(cat) {
+  switch (cat) {
+    case "auth":
+      return "Authentication";
+    case "database":
+      return "Database";
+    case "payments":
+      return "Payments (Stripe)";
+    case "comms":
+      return "Communications";
+    case "storage":
+      return "File storage";
+    case "ai":
+      return "AI";
+    case "mobile":
+      return "Mobile app";
+    default:
+      return cat;
+  }
+}
+function stackLabel(stack) {
+  return stack === "clerk-convex" ? "Next.js 15 + Clerk + Convex" : "Next.js 15 + Better-Auth + Postgres + Drizzle";
+}
+function buildSetupSteps(cfg) {
+  const steps = [
+    "Register a domain and point it at Vercel.",
+    "Click the Deploy button above; fill in environment variables when prompted."
+  ];
+  if (cfg.stack === "better-auth-drizzle") {
+    steps.push("Provision a Postgres database (Neon recommended) and add `DATABASE_URL`.");
+    steps.push("Run `pnpm db:push` to apply schema.");
+  } else {
+    steps.push("Run `npx convex dev` to provision a Convex deployment and copy its URL into `NEXT_PUBLIC_CONVEX_URL`.");
+  }
+  if (cfg.payments) {
+    steps.push("Create Stripe webhook at `https://<your-domain>/api/stripe/webhook` \u2014 copy the signing secret into `STRIPE_WEBHOOK_SECRET`.");
+  }
+  if (cfg.comms.includes("sms")) {
+    steps.push('Buy a Twilio phone number and set its "A message comes in" webhook to `https://<your-domain>/api/twilio/sms`.');
+  }
+  if (cfg.comms.includes("email")) {
+    steps.push("Verify your sending domain in Resend and set `EMAIL_FROM` to a verified address.");
+  }
+  if (cfg.jobs) {
+    steps.push("(Optional) Create a Cloudflare R2 bucket for job photo uploads \u2014 set the R2_* env vars.");
+  }
+  steps.push("Sign up via `/sign-up` to create the first admin user.");
+  steps.push("Set up the price book, default checklists, and any service plans before handing off to staff.");
+  if (cfg.mobileApp) {
+    steps.push("Build + ship the field-tech iPhone app: set `mobile/.env` `EXPO_PUBLIC_API_URL` to this deployed URL, then follow `mobile/README.md` (EAS build \u2192 App Store).");
+  }
+  return steps;
+}
+
+// src/installers/index.ts
+var installers = {
+  "auth-clerk": installAuthClerk,
+  "db-convex": installDbConvex,
+  "auth-better-auth": installAuthBetterAuth,
+  "db-drizzle-pg": installDbDrizzlePg,
+  "landing-page": installLandingPage,
+  customers: installCustomers,
+  jobs: installJobs,
+  "estimates-invoices": installEstimatesInvoices,
+  "calendar-dispatch": installCalendarDispatch,
+  "payments-stripe": installPaymentsStripe,
+  "comms-sms": installCommsSms,
+  "comms-email": installCommsEmail,
+  reviews: installReviews,
+  reporting: installReporting,
+  seed: installSeed,
+  "price-book": installPriceBook,
+  "customer-portal": installCustomerPortal,
+  "service-plans": installServicePlans,
+  checklists: installChecklists,
+  "equipment-tracking": installEquipmentTracking,
+  "maintenance-plans": installMaintenancePlans,
+  "emergency-dispatch": installEmergencyDispatch,
+  "permit-tracking": installPermitTracking,
+  "inspection-checklists": installInspectionChecklists,
+  brand: installBrand,
+  logo: installLogo,
+  "business-info": installBusinessInfo,
+  "mobile-api": installMobileApi,
+  mobile: installMobile,
+  readme: installReadme
+};
+function resolveInstallers(cfg) {
+  const list = [];
+  if (cfg.stack === "clerk-convex") {
+    list.push("auth-clerk", "db-convex");
+  } else {
+    list.push("auth-better-auth", "db-drizzle-pg");
+  }
+  if (cfg.landingPage) list.push("landing-page");
+  if (cfg.customers) list.push("customers");
+  if (cfg.jobs) list.push("jobs");
+  if (cfg.jobs || cfg.estimatesInvoices) list.push("price-book");
+  if (cfg.calendarDispatch) list.push("calendar-dispatch");
+  if (cfg.payments) list.push("payments-stripe");
+  if (cfg.estimatesInvoices) list.push("estimates-invoices");
+  if (cfg.stack === "better-auth-drizzle" && cfg.customers && cfg.jobs && cfg.estimatesInvoices) {
+    list.push("customer-portal");
+  }
+  if (cfg.industryExtras.includes("maintenance-plans") || cfg.industryExtras.includes("service-plans")) {
+    list.push("service-plans");
+  }
+  if (cfg.jobs) list.push("checklists");
+  if (cfg.comms.includes("sms")) list.push("comms-sms");
+  if (cfg.comms.includes("email")) list.push("comms-email");
+  if (cfg.reviews) list.push("reviews");
+  if (cfg.reporting) list.push("reporting");
+  for (const extra of cfg.industryExtras) list.push(extra);
+  if (cfg.seed) list.push("seed");
+  if (cfg.mobileApp && cfg.stack === "better-auth-drizzle" && cfg.jobs && cfg.customers) {
+    list.push("mobile-api", "mobile");
+  }
+  list.push("brand");
+  if (cfg.logoPath) list.push("logo");
+  list.push("business-info");
+  list.push("readme");
+  return list;
+}
+
+// src/commands/create.ts
+async function create(args) {
+  intro(pc3.bgCyan(pc3.black(" create-crm-starter ")));
+  const cfg = await runPrompts({
+    projectName: args.projectName,
+    configPath: args.configPath
+  });
+  note3(summarizeConfig(cfg), "Configuration");
+  const projectDir = path21.resolve(process.cwd(), cfg.projectName);
+  const copySpin = spinner2();
+  copySpin.start("Copying base template");
+  await fs16.mkdir(projectDir, { recursive: true });
+  await copyBase(projectDir);
+  await ensureEnvFiles(projectDir);
+  const pkg = await readPackageJson(projectDir);
+  setProjectName(pkg, cfg.projectName);
+  copySpin.stop("Base template copied");
+  const installerNames = resolveInstallers(cfg);
+  const missing = [];
+  for (const name of installerNames) {
+    const installer = installers[name];
+    if (!installer) {
+      missing.push(name);
+      continue;
+    }
+    const s = spinner2();
+    s.start(`Adding ${name}`);
+    await installer({ projectDir, cfg, pkg });
+    s.stop(`Added ${name}`);
+  }
+  await writePackageJson(projectDir, pkg);
+  if (missing.length > 0) {
+    log.warn(
+      `Modules selected but not yet implemented (stub-skipped): ${missing.join(", ")}`
+    );
+  }
+  const pm = cfg.install ? await installDeps(projectDir) : await detectPackageManager();
+  if (cfg.initGit) {
+    const gitSpin = spinner2();
+    gitSpin.start("Initializing git repository");
+    const initialized = await initGit(projectDir);
+    gitSpin.stop(initialized ? "Git repository initialized" : "Skipped git (already inside a repo)");
+  }
+  if (cfg.stack === "clerk-convex") {
+    const PREVIEW_ON_CONVEX = {
+      "estimates-invoices": "Estimates & invoices",
+      "price-book": "Price book",
+      "service-plans": "Service plans",
+      checklists: "Job checklists",
+      "comms-sms": "SMS sending + inbox"
+    };
+    const previews = installerNames.filter((n) => n in PREVIEW_ON_CONVEX).map((n) => PREVIEW_ON_CONVEX[n]);
+    if (previews.length > 0) {
+      note3(
+        [
+          pc3.yellow("Heads up \u2014 these render with sample data on the Convex stack:"),
+          ...previews.map((p) => `  \u2022 ${p}`),
+          "",
+          pc3.dim("customers + jobs are fully working on Convex. The rest have"),
+          pc3.dim("real backends only on the Better-Auth + Drizzle stack for now.")
+        ].join("\n"),
+        "Convex: preview-only modules"
+      );
+    }
+  }
+  printNextSteps({ cfg, pm, installed: cfg.install });
+  outro(pc3.green(`Done. ${pc3.bold(cfg.projectName)} is ready.`));
+}
+
+// src/commands/add.ts
+import fs17 from "fs/promises";
+import path22 from "path";
+import { intro as intro2, log as log2, note as note4, outro as outro2, spinner as spinner3 } from "@clack/prompts";
+import pc4 from "picocolors";
+function detectStack(pkg) {
+  const deps = { ...pkg.dependencies ?? {}, ...pkg.devDependencies ?? {} };
+  if (deps["@clerk/nextjs"]) return "clerk-convex";
+  if (deps["better-auth"]) return "better-auth-drizzle";
+  throw new Error(
+    "Could not detect stack. This project does not appear to be generated by create-crm-starter."
+  );
+}
+function buildConfig(pkg, stack) {
+  const projectName = pkg.name ?? "crm-app";
+  return {
+    projectName,
+    businessName: projectName,
+    industry: "general",
+    primaryColor: "#0ea5e9",
+    accentColor: "#f59e0b",
+    landingPage: true,
+    onlineBooking: true,
+    stack,
+    roles: ["admin", "dispatcher", "technician", "csr"],
+    customers: false,
+    jobs: false,
+    estimatesInvoices: false,
+    calendarDispatch: false,
+    payments: false,
+    comms: [],
+    reviews: false,
+    reporting: false,
+    mobileApp: false,
+    industryExtras: [],
+    seed: false,
+    initGit: false,
+    install: false,
+    deployTarget: "vercel"
+  };
+}
+async function add(args) {
+  intro2(pc4.bgMagenta(pc4.black(` add ${args.module} `)));
+  const projectDir = process.cwd();
+  try {
+    await fs17.access(path22.join(projectDir, "package.json"));
+  } catch {
+    outro2(pc4.red("No package.json in current directory. Run from your project root."));
+    process.exit(1);
+  }
+  const installer = installers[args.module];
+  if (!installer) {
+    const available = Object.keys(installers).filter((k) => !["auth-clerk", "auth-better-auth", "db-convex", "db-drizzle-pg", "brand"].includes(k)).join(", ");
+    outro2(pc4.red(`Unknown module "${args.module}".
+Available: ${available}`));
+    process.exit(1);
+  }
+  let pkg;
+  let stack;
+  try {
+    pkg = await readPackageJson(projectDir);
+    stack = detectStack(pkg);
+  } catch (err) {
+    outro2(pc4.red(err.message));
+    process.exit(1);
+  }
+  log2.info(`Detected stack: ${pc4.cyan(stack)}`);
+  const cfg = buildConfig(pkg, stack);
+  const s = spinner3();
+  s.start(`Adding ${args.module}`);
+  try {
+    await installer({ projectDir, cfg, pkg });
+    await writePackageJson(projectDir, pkg);
+    s.stop(`Added ${args.module}`);
+  } catch (err) {
+    s.stop(`Failed to add ${args.module}`);
+    outro2(pc4.red(`Error: ${err.message}`));
+    process.exit(1);
+  }
+  const lines = [
+    pc4.dim("# Install new dependencies"),
+    pc4.cyan("pnpm install")
+  ];
+  if (stack === "better-auth-drizzle" && schemaModules.has(args.module)) {
+    lines.push("");
+    lines.push(pc4.dim("# Apply schema changes"));
+    lines.push(pc4.cyan("pnpm db:push"));
+  } else if (stack === "clerk-convex" && schemaModules.has(args.module)) {
+    lines.push("");
+    lines.push(pc4.dim("# Push schema to Convex"));
+    lines.push(pc4.cyan("pnpm convex:dev"));
+  }
+  note4(lines.join("\n"), "Next steps");
+  outro2(pc4.green("Done."));
+}
+var schemaModules = /* @__PURE__ */ new Set(["customers", "jobs"]);
+
+// src/index.ts
+var main = defineCommand({
+  meta: {
+    name: "create-crm-starter",
+    // Keep in sync with package.json "version" on each release.
+    version: "0.1.0",
+    description: "Scaffold a home-services CRM (Next.js 15). Run `add <module>` to add a module to an existing project."
+  },
+  args: {
+    projectName: {
+      type: "positional",
+      description: "Directory to create (or `add` to add a module)",
+      required: false
+    },
+    module: {
+      type: "positional",
+      description: "When using `add`: the module name (e.g. payments, calendar)",
+      required: false
+    },
+    config: {
+      type: "string",
+      description: "Path to a JSON file with pre-filled wizard answers (skips interactive prompts)",
+      required: false
+    }
+  },
+  run: ({ args }) => {
+    const positionals = process.argv.slice(2).filter((a) => !a.startsWith("-"));
+    if (positionals[0] === "add") {
+      const moduleName = positionals[1];
+      if (!moduleName) {
+        console.error("Usage: create-crm-starter add <module>");
+        process.exit(1);
+      }
+      return add({ module: moduleName });
+    }
+    return create({
+      projectName: args.projectName ? String(args.projectName) : void 0,
+      configPath: args.config ? String(args.config) : void 0
+    });
+  }
+});
+runMain(main);