@idevconn/create-icore 0.1.0

package/dist/index.cjs

@@ -0,0 +1,303 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  collectOptions: () => collectOptions,
+  scaffold: () => scaffold
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/lib/scaffold.ts
+var import_promises = require("fs/promises");
+var import_node_path = require("path");
+var import_node_child_process = require("child_process");
+var IGNORE_TOP = /* @__PURE__ */ new Set([
+  ".git",
+  "node_modules",
+  ".yarn/cache",
+  ".yarn/unplugged",
+  ".yarn/install-state.gz",
+  ".nx",
+  "dist",
+  "tmp",
+  "coverage",
+  ".idea",
+  ".vscode"
+]);
+async function copyTree(src, dest) {
+  await (0, import_promises.mkdir)(dest, { recursive: true });
+  const entries = await (0, import_promises.readdir)(src, { withFileTypes: true });
+  for (const entry of entries) {
+    if (IGNORE_TOP.has(entry.name)) continue;
+    const s = (0, import_node_path.join)(src, entry.name);
+    const d = (0, import_node_path.join)(dest, entry.name);
+    if (entry.isDirectory()) await copyTree(s, d);
+    else if (entry.isFile()) await (0, import_promises.copyFile)(s, d);
+  }
+}
+async function rewriteRootPackageJson(targetDir, opts) {
+  const pkgPath = (0, import_node_path.join)(targetDir, "package.json");
+  const raw = await (0, import_promises.readFile)(pkgPath, "utf8");
+  const pkg = JSON.parse(raw);
+  pkg["name"] = opts.projectName;
+  pkg["version"] = "0.0.1";
+  pkg["private"] = true;
+  delete pkg.description;
+  await (0, import_promises.writeFile)(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+}
+async function writeAuthEnv(targetDir, opts) {
+  const envExample = (0, import_node_path.join)(targetDir, "apps/microservices/auth/.env.example");
+  const env = await (0, import_promises.readFile)(envExample, "utf8");
+  let next = env.replace(/^AUTH_PROVIDER=.*$/m, `AUTH_PROVIDER=${opts.authProvider}`).replace(/^AUTH_TRANSPORT=.*$/m, `AUTH_TRANSPORT=${opts.transport}`);
+  if (opts.transport !== "tcp") {
+    next = next.replace(/^# (AUTH_(?:REDIS|NATS)_URL=)/m, "$1");
+  }
+  await (0, import_promises.writeFile)((0, import_node_path.join)(targetDir, "apps/microservices/auth/.env"), next);
+}
+async function writeUploadEnv(targetDir, opts) {
+  if (opts.upload === "none") return;
+  const envExample = (0, import_node_path.join)(targetDir, "apps/microservices/upload/.env.example");
+  const env = await (0, import_promises.readFile)(envExample, "utf8");
+  let next = env.replace(/^STORAGE_PROVIDER=.*$/m, `STORAGE_PROVIDER=${opts.upload}`).replace(/^UPLOAD_TRANSPORT=.*$/m, `UPLOAD_TRANSPORT=${opts.transport}`);
+  if (opts.transport !== "tcp") {
+    next = next.replace(/^# (UPLOAD_(?:REDIS|NATS)_URL=)/m, "$1");
+  }
+  await (0, import_promises.writeFile)((0, import_node_path.join)(targetDir, "apps/microservices/upload/.env"), next);
+}
+async function writeGatewayEnv(targetDir, opts) {
+  const envExample = (0, import_node_path.join)(targetDir, "apps/api/.env.example");
+  const env = await (0, import_promises.readFile)(envExample, "utf8");
+  let next = env.replace(/^AUTH_TRANSPORT=.*$/m, `AUTH_TRANSPORT=${opts.transport}`).replace(/^UPLOAD_TRANSPORT=.*$/m, `UPLOAD_TRANSPORT=${opts.transport}`);
+  if (opts.transport !== "tcp") {
+    next = next.replace(/^# (AUTH_(?:REDIS|NATS)_URL=)/m, "$1").replace(/^# (UPLOAD_(?:REDIS|NATS)_URL=)/m, "$1");
+  }
+  await (0, import_promises.writeFile)((0, import_node_path.join)(targetDir, "apps/api/.env"), next);
+}
+async function removeUploadStack(targetDir) {
+  const paths = [
+    "apps/microservices/upload",
+    "apps/microservices/upload-e2e",
+    "libs/storage-strategies",
+    "libs/upload-client",
+    "apps/api/src/app/storage"
+  ];
+  for (const p2 of paths) {
+    await (0, import_promises.rm)((0, import_node_path.join)(targetDir, p2), { recursive: true, force: true });
+  }
+  const appModulePath = (0, import_node_path.join)(targetDir, "apps/api/src/app/app.module.ts");
+  try {
+    const appModule = await (0, import_promises.readFile)(appModulePath, "utf8");
+    const next = appModule.replace(/^import \{ StorageModule \} from '\.\/storage\/storage\.module';\n/m, "").replace(/,\s*StorageModule/g, "");
+    await (0, import_promises.writeFile)(appModulePath, next);
+  } catch {
+  }
+  const gatewayEnv = (0, import_node_path.join)(targetDir, "apps/api/.env");
+  try {
+    const env = await (0, import_promises.readFile)(gatewayEnv, "utf8");
+    const next = env.split("\n").filter(
+      (line) => !line.startsWith("UPLOAD_") && !line.startsWith("# UPLOAD_") && !line.startsWith("MAX_FILE_SIZE_KB")
+    ).join("\n");
+    await (0, import_promises.writeFile)(gatewayEnv, next);
+  } catch {
+  }
+}
+async function selectClientTemplate(targetDir, opts) {
+  const templatesRoot = (0, import_node_path.join)(targetDir, "apps/templates");
+  const chosen = (0, import_node_path.join)(templatesRoot, `client-${opts.ui}`);
+  const destClient = (0, import_node_path.join)(targetDir, "apps/client");
+  try {
+    const s = await (0, import_promises.stat)(chosen);
+    if (!s.isDirectory()) throw new Error("not a dir");
+  } catch {
+    await copyTree((0, import_node_path.join)(templatesRoot, "client-shadcn"), destClient);
+    await (0, import_promises.rm)(templatesRoot, { recursive: true, force: true });
+    return;
+  }
+  await copyTree(chosen, destClient);
+  await (0, import_promises.rm)(templatesRoot, { recursive: true, force: true });
+}
+function gitInit(cwd, projectName) {
+  (0, import_node_child_process.spawnSync)("git", ["init"], { cwd, stdio: "inherit" });
+  (0, import_node_child_process.spawnSync)("git", ["add", "."], { cwd, stdio: "inherit" });
+  (0, import_node_child_process.spawnSync)(
+    "git",
+    ["commit", "-m", `chore: bootstrap ${projectName} from @idevconn/create-icore`],
+    { cwd, stdio: "inherit" }
+  );
+}
+function yarnInstall(cwd) {
+  (0, import_node_child_process.spawnSync)("yarn", ["install"], { cwd, stdio: "inherit" });
+}
+async function scaffold(opts, templatesDir) {
+  await copyTree(templatesDir, opts.targetDir);
+  await rewriteRootPackageJson(opts.targetDir, opts);
+  await writeAuthEnv(opts.targetDir, opts);
+  await writeUploadEnv(opts.targetDir, opts);
+  await writeGatewayEnv(opts.targetDir, opts);
+  await selectClientTemplate(opts.targetDir, opts);
+  if (opts.upload === "none") await removeUploadStack(opts.targetDir);
+  if (opts.install) yarnInstall(opts.targetDir);
+  if (opts.initGit) gitInit(opts.targetDir, opts.projectName);
+}
+
+// src/lib/prompts.ts
+var p = __toESM(require("@clack/prompts"), 1);
+var import_node_path2 = require("path");
+function parseFlags(argv) {
+  const out = {};
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (!a || !a.startsWith("--")) {
+      if (a && !out.projectName) out.projectName = a;
+      continue;
+    }
+    const parts = a.includes("=") ? a.split("=", 2) : [a, argv[++i]];
+    const k = parts[0] ?? "";
+    const vIn = parts[1];
+    const key = k.slice(2);
+    const v = vIn ?? "";
+    switch (key) {
+      case "auth":
+        out.authProvider = v;
+        break;
+      case "db":
+        out.dbProvider = v;
+        break;
+      case "upload":
+        out.upload = v;
+        break;
+      case "storage":
+        process.stderr.write("Warning: --storage is deprecated, use --upload\n");
+        out.upload = v;
+        break;
+      case "ui":
+        out.ui = v;
+        break;
+      case "transport":
+        out.transport = v;
+        break;
+      case "no-git":
+        out.initGit = false;
+        break;
+      case "no-install":
+        out.install = false;
+        break;
+    }
+  }
+  return out;
+}
+async function collectOptions({ argv, cwd }) {
+  const flags = parseFlags(argv);
+  p.intro("icore \u2014 bootstrap a new project");
+  const projectName = flags.projectName ?? await p.text({
+    message: "Project name",
+    placeholder: "my-app",
+    validate: (v) => v && /^[a-z0-9-]+$/i.test(v) ? void 0 : "Use letters, digits, hyphens"
+  });
+  if (p.isCancel(projectName)) throw new Error("cancelled");
+  const authProvider = flags.authProvider ?? await p.select({
+    message: "Auth provider",
+    options: [
+      { value: "supabase", label: "Supabase" },
+      { value: "firebase", label: "Firebase" }
+    ]
+  });
+  if (p.isCancel(authProvider)) throw new Error("cancelled");
+  const dbProvider = flags.dbProvider ?? await p.select({
+    message: "Database backend",
+    options: [
+      { value: "supabase", label: "Supabase Postgres" },
+      { value: "firebase", label: "Firestore" }
+    ],
+    initialValue: authProvider
+  });
+  if (p.isCancel(dbProvider)) throw new Error("cancelled");
+  if (dbProvider !== authProvider) {
+    p.log.info(
+      "Note: in v0.1.0 the DB choice mirrors auth; independent db swap arrives in Plan 8."
+    );
+  }
+  const upload = flags.upload ?? await p.select({
+    message: "File upload provider",
+    options: [
+      { value: "supabase", label: "Supabase Storage" },
+      { value: "firebase", label: "Firebase Cloud Storage" },
+      { value: "cloudinary", label: "Cloudinary" },
+      { value: "none", label: "None \u2014 skip the upload microservice" }
+    ]
+  });
+  if (p.isCancel(upload)) throw new Error("cancelled");
+  const ui = flags.ui ?? await p.select({
+    message: "UI library",
+    options: [
+      { value: "shadcn", label: "shadcn/ui + Tailwind" },
+      {
+        value: "antd",
+        label: "Ant Design (coming soon \u2014 falls back to shadcn)"
+      },
+      {
+        value: "mui",
+        label: "MUI (coming soon \u2014 falls back to shadcn)"
+      }
+    ],
+    initialValue: "shadcn"
+  });
+  if (p.isCancel(ui)) throw new Error("cancelled");
+  const transport = flags.transport ?? await p.select({
+    message: "Microservice transport",
+    options: [
+      { value: "tcp", label: "TCP (default, no broker required)" },
+      { value: "redis", label: "Redis" },
+      { value: "nats", label: "NATS" }
+    ],
+    initialValue: "tcp"
+  });
+  if (p.isCancel(transport)) throw new Error("cancelled");
+  const initGit = flags.initGit ?? !await p.confirm({ message: "Initialise git repo?", initialValue: true }) === false;
+  const install = flags.install ?? !await p.confirm({ message: "Run yarn install?", initialValue: true }) === false;
+  return {
+    projectName,
+    targetDir: (0, import_node_path2.resolve)(cwd, projectName),
+    authProvider,
+    dbProvider,
+    upload,
+    ui: ui === "shadcn" ? "shadcn" : "shadcn",
+    // antd/mui fall back to shadcn for v0.1.0
+    transport,
+    initGit,
+    install
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  collectOptions,
+  scaffold
+});

package/dist/index.d.cts

@@ -0,0 +1,26 @@
+type AuthProvider = 'supabase' | 'firebase';
+type DbProvider = 'supabase' | 'firebase';
+type UploadProvider = 'supabase' | 'firebase' | 'cloudinary' | 'none';
+type UiLibrary = 'shadcn' | 'antd' | 'mui';
+type MsTransport = 'tcp' | 'redis' | 'nats';
+interface CreateIcoreOptions {
+    projectName: string;
+    targetDir: string;
+    authProvider: AuthProvider;
+    dbProvider: DbProvider;
+    upload: UploadProvider;
+    ui: UiLibrary;
+    transport: MsTransport;
+    initGit: boolean;
+    install: boolean;
+}
+
+declare function scaffold(opts: CreateIcoreOptions, templatesDir: string): Promise<void>;
+
+interface PromptInput {
+    argv: string[];
+    cwd: string;
+}
+declare function collectOptions({ argv, cwd }: PromptInput): Promise<CreateIcoreOptions>;
+
+export { type AuthProvider, type CreateIcoreOptions, type DbProvider, type MsTransport, type UiLibrary, type UploadProvider, collectOptions, scaffold };

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+type AuthProvider = 'supabase' | 'firebase';
+type DbProvider = 'supabase' | 'firebase';
+type UploadProvider = 'supabase' | 'firebase' | 'cloudinary' | 'none';
+type UiLibrary = 'shadcn' | 'antd' | 'mui';
+type MsTransport = 'tcp' | 'redis' | 'nats';
+interface CreateIcoreOptions {
+    projectName: string;
+    targetDir: string;
+    authProvider: AuthProvider;
+    dbProvider: DbProvider;
+    upload: UploadProvider;
+    ui: UiLibrary;
+    transport: MsTransport;
+    initGit: boolean;
+    install: boolean;
+}
+
+declare function scaffold(opts: CreateIcoreOptions, templatesDir: string): Promise<void>;
+
+interface PromptInput {
+    argv: string[];
+    cwd: string;
+}
+declare function collectOptions({ argv, cwd }: PromptInput): Promise<CreateIcoreOptions>;
+
+export { type AuthProvider, type CreateIcoreOptions, type DbProvider, type MsTransport, type UiLibrary, type UploadProvider, collectOptions, scaffold };

package/dist/index.js

@@ -0,0 +1,265 @@
+// src/lib/scaffold.ts
+import { copyFile, mkdir, readdir, readFile, stat, writeFile, rm } from "fs/promises";
+import { join } from "path";
+import { spawnSync } from "child_process";
+var IGNORE_TOP = /* @__PURE__ */ new Set([
+  ".git",
+  "node_modules",
+  ".yarn/cache",
+  ".yarn/unplugged",
+  ".yarn/install-state.gz",
+  ".nx",
+  "dist",
+  "tmp",
+  "coverage",
+  ".idea",
+  ".vscode"
+]);
+async function copyTree(src, dest) {
+  await mkdir(dest, { recursive: true });
+  const entries = await readdir(src, { withFileTypes: true });
+  for (const entry of entries) {
+    if (IGNORE_TOP.has(entry.name)) continue;
+    const s = join(src, entry.name);
+    const d = join(dest, entry.name);
+    if (entry.isDirectory()) await copyTree(s, d);
+    else if (entry.isFile()) await copyFile(s, d);
+  }
+}
+async function rewriteRootPackageJson(targetDir, opts) {
+  const pkgPath = join(targetDir, "package.json");
+  const raw = await readFile(pkgPath, "utf8");
+  const pkg = JSON.parse(raw);
+  pkg["name"] = opts.projectName;
+  pkg["version"] = "0.0.1";
+  pkg["private"] = true;
+  delete pkg.description;
+  await writeFile(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+}
+async function writeAuthEnv(targetDir, opts) {
+  const envExample = join(targetDir, "apps/microservices/auth/.env.example");
+  const env = await readFile(envExample, "utf8");
+  let next = env.replace(/^AUTH_PROVIDER=.*$/m, `AUTH_PROVIDER=${opts.authProvider}`).replace(/^AUTH_TRANSPORT=.*$/m, `AUTH_TRANSPORT=${opts.transport}`);
+  if (opts.transport !== "tcp") {
+    next = next.replace(/^# (AUTH_(?:REDIS|NATS)_URL=)/m, "$1");
+  }
+  await writeFile(join(targetDir, "apps/microservices/auth/.env"), next);
+}
+async function writeUploadEnv(targetDir, opts) {
+  if (opts.upload === "none") return;
+  const envExample = join(targetDir, "apps/microservices/upload/.env.example");
+  const env = await readFile(envExample, "utf8");
+  let next = env.replace(/^STORAGE_PROVIDER=.*$/m, `STORAGE_PROVIDER=${opts.upload}`).replace(/^UPLOAD_TRANSPORT=.*$/m, `UPLOAD_TRANSPORT=${opts.transport}`);
+  if (opts.transport !== "tcp") {
+    next = next.replace(/^# (UPLOAD_(?:REDIS|NATS)_URL=)/m, "$1");
+  }
+  await writeFile(join(targetDir, "apps/microservices/upload/.env"), next);
+}
+async function writeGatewayEnv(targetDir, opts) {
+  const envExample = join(targetDir, "apps/api/.env.example");
+  const env = await readFile(envExample, "utf8");
+  let next = env.replace(/^AUTH_TRANSPORT=.*$/m, `AUTH_TRANSPORT=${opts.transport}`).replace(/^UPLOAD_TRANSPORT=.*$/m, `UPLOAD_TRANSPORT=${opts.transport}`);
+  if (opts.transport !== "tcp") {
+    next = next.replace(/^# (AUTH_(?:REDIS|NATS)_URL=)/m, "$1").replace(/^# (UPLOAD_(?:REDIS|NATS)_URL=)/m, "$1");
+  }
+  await writeFile(join(targetDir, "apps/api/.env"), next);
+}
+async function removeUploadStack(targetDir) {
+  const paths = [
+    "apps/microservices/upload",
+    "apps/microservices/upload-e2e",
+    "libs/storage-strategies",
+    "libs/upload-client",
+    "apps/api/src/app/storage"
+  ];
+  for (const p2 of paths) {
+    await rm(join(targetDir, p2), { recursive: true, force: true });
+  }
+  const appModulePath = join(targetDir, "apps/api/src/app/app.module.ts");
+  try {
+    const appModule = await readFile(appModulePath, "utf8");
+    const next = appModule.replace(/^import \{ StorageModule \} from '\.\/storage\/storage\.module';\n/m, "").replace(/,\s*StorageModule/g, "");
+    await writeFile(appModulePath, next);
+  } catch {
+  }
+  const gatewayEnv = join(targetDir, "apps/api/.env");
+  try {
+    const env = await readFile(gatewayEnv, "utf8");
+    const next = env.split("\n").filter(
+      (line) => !line.startsWith("UPLOAD_") && !line.startsWith("# UPLOAD_") && !line.startsWith("MAX_FILE_SIZE_KB")
+    ).join("\n");
+    await writeFile(gatewayEnv, next);
+  } catch {
+  }
+}
+async function selectClientTemplate(targetDir, opts) {
+  const templatesRoot = join(targetDir, "apps/templates");
+  const chosen = join(templatesRoot, `client-${opts.ui}`);
+  const destClient = join(targetDir, "apps/client");
+  try {
+    const s = await stat(chosen);
+    if (!s.isDirectory()) throw new Error("not a dir");
+  } catch {
+    await copyTree(join(templatesRoot, "client-shadcn"), destClient);
+    await rm(templatesRoot, { recursive: true, force: true });
+    return;
+  }
+  await copyTree(chosen, destClient);
+  await rm(templatesRoot, { recursive: true, force: true });
+}
+function gitInit(cwd, projectName) {
+  spawnSync("git", ["init"], { cwd, stdio: "inherit" });
+  spawnSync("git", ["add", "."], { cwd, stdio: "inherit" });
+  spawnSync(
+    "git",
+    ["commit", "-m", `chore: bootstrap ${projectName} from @idevconn/create-icore`],
+    { cwd, stdio: "inherit" }
+  );
+}
+function yarnInstall(cwd) {
+  spawnSync("yarn", ["install"], { cwd, stdio: "inherit" });
+}
+async function scaffold(opts, templatesDir) {
+  await copyTree(templatesDir, opts.targetDir);
+  await rewriteRootPackageJson(opts.targetDir, opts);
+  await writeAuthEnv(opts.targetDir, opts);
+  await writeUploadEnv(opts.targetDir, opts);
+  await writeGatewayEnv(opts.targetDir, opts);
+  await selectClientTemplate(opts.targetDir, opts);
+  if (opts.upload === "none") await removeUploadStack(opts.targetDir);
+  if (opts.install) yarnInstall(opts.targetDir);
+  if (opts.initGit) gitInit(opts.targetDir, opts.projectName);
+}
+
+// src/lib/prompts.ts
+import * as p from "@clack/prompts";
+import { resolve } from "path";
+function parseFlags(argv) {
+  const out = {};
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (!a || !a.startsWith("--")) {
+      if (a && !out.projectName) out.projectName = a;
+      continue;
+    }
+    const parts = a.includes("=") ? a.split("=", 2) : [a, argv[++i]];
+    const k = parts[0] ?? "";
+    const vIn = parts[1];
+    const key = k.slice(2);
+    const v = vIn ?? "";
+    switch (key) {
+      case "auth":
+        out.authProvider = v;
+        break;
+      case "db":
+        out.dbProvider = v;
+        break;
+      case "upload":
+        out.upload = v;
+        break;
+      case "storage":
+        process.stderr.write("Warning: --storage is deprecated, use --upload\n");
+        out.upload = v;
+        break;
+      case "ui":
+        out.ui = v;
+        break;
+      case "transport":
+        out.transport = v;
+        break;
+      case "no-git":
+        out.initGit = false;
+        break;
+      case "no-install":
+        out.install = false;
+        break;
+    }
+  }
+  return out;
+}
+async function collectOptions({ argv, cwd }) {
+  const flags = parseFlags(argv);
+  p.intro("icore \u2014 bootstrap a new project");
+  const projectName = flags.projectName ?? await p.text({
+    message: "Project name",
+    placeholder: "my-app",
+    validate: (v) => v && /^[a-z0-9-]+$/i.test(v) ? void 0 : "Use letters, digits, hyphens"
+  });
+  if (p.isCancel(projectName)) throw new Error("cancelled");
+  const authProvider = flags.authProvider ?? await p.select({
+    message: "Auth provider",
+    options: [
+      { value: "supabase", label: "Supabase" },
+      { value: "firebase", label: "Firebase" }
+    ]
+  });
+  if (p.isCancel(authProvider)) throw new Error("cancelled");
+  const dbProvider = flags.dbProvider ?? await p.select({
+    message: "Database backend",
+    options: [
+      { value: "supabase", label: "Supabase Postgres" },
+      { value: "firebase", label: "Firestore" }
+    ],
+    initialValue: authProvider
+  });
+  if (p.isCancel(dbProvider)) throw new Error("cancelled");
+  if (dbProvider !== authProvider) {
+    p.log.info(
+      "Note: in v0.1.0 the DB choice mirrors auth; independent db swap arrives in Plan 8."
+    );
+  }
+  const upload = flags.upload ?? await p.select({
+    message: "File upload provider",
+    options: [
+      { value: "supabase", label: "Supabase Storage" },
+      { value: "firebase", label: "Firebase Cloud Storage" },
+      { value: "cloudinary", label: "Cloudinary" },
+      { value: "none", label: "None \u2014 skip the upload microservice" }
+    ]
+  });
+  if (p.isCancel(upload)) throw new Error("cancelled");
+  const ui = flags.ui ?? await p.select({
+    message: "UI library",
+    options: [
+      { value: "shadcn", label: "shadcn/ui + Tailwind" },
+      {
+        value: "antd",
+        label: "Ant Design (coming soon \u2014 falls back to shadcn)"
+      },
+      {
+        value: "mui",
+        label: "MUI (coming soon \u2014 falls back to shadcn)"
+      }
+    ],
+    initialValue: "shadcn"
+  });
+  if (p.isCancel(ui)) throw new Error("cancelled");
+  const transport = flags.transport ?? await p.select({
+    message: "Microservice transport",
+    options: [
+      { value: "tcp", label: "TCP (default, no broker required)" },
+      { value: "redis", label: "Redis" },
+      { value: "nats", label: "NATS" }
+    ],
+    initialValue: "tcp"
+  });
+  if (p.isCancel(transport)) throw new Error("cancelled");
+  const initGit = flags.initGit ?? !await p.confirm({ message: "Initialise git repo?", initialValue: true }) === false;
+  const install = flags.install ?? !await p.confirm({ message: "Run yarn install?", initialValue: true }) === false;
+  return {
+    projectName,
+    targetDir: resolve(cwd, projectName),
+    authProvider,
+    dbProvider,
+    upload,
+    ui: ui === "shadcn" ? "shadcn" : "shadcn",
+    // antd/mui fall back to shadcn for v0.1.0
+    transport,
+    initGit,
+    install
+  };
+}
+export {
+  collectOptions,
+  scaffold
+};

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@idevconn/create-icore",
+  "version": "0.1.0",
+  "description": "Bootstrap a new project from the iCore scaffold (Nx + NestJS + React + Vite + shadcn/Tailwind, swappable auth + storage providers).",
+  "license": "Apache-2.0",
+  "author": "iDEVconn",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/iDEVconn/create-icore.git",
+    "directory": "tools/create-icore"
+  },
+  "bugs": {
+    "url": "https://github.com/iDEVconn/create-icore/issues"
+  },
+  "homepage": "https://github.com/iDEVconn/create-icore#readme",
+  "type": "module",
+  "keywords": [
+    "icore",
+    "scaffold",
+    "bootstrap",
+    "nestjs",
+    "react",
+    "vite",
+    "shadcn",
+    "tailwind",
+    "supabase",
+    "firebase",
+    "cloudinary",
+    "tanstack-router",
+    "create-app"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "bin": "./dist/cli.js",
+  "files": [
+    "dist",
+    "templates",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run typecheck && npm run test && npm run build"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.7.0",
+    "kleur": "^4.1.5"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.0",
+    "vitest": "^4.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}