create-stackrjs 1.4.0 → 2.0.0

package/README.md

@@ -40,24 +40,27 @@ npm create stackrjs@latest [name] -- [options]
 # or:  npx create-stackrjs [name] [options]
 
   --architecture <a>   monolith   | microservices
-  --database <db>      postgres   | mysql | mongodb
-  --orm <orm>          prisma     | drizzle | mongoose
+  --database <db>      postgres   | mysql | mongodb | none
+  --orm <orm>          prisma     | drizzle | mongoose | none
   --auth <auth>        nextauth   | better-auth | clerk | supabase
   --styling <s>        tailwind   | shadcn   (shadcn ships the full Tailwind stack)
-  --interfaces <list>  auth-pages,dashboard,admin,landing
+  --interfaces <list>  auth-pages,dashboard,admin,landing   (`--interfaces=` for none)
   -y, --yes            skip the wizard, use flags + defaults
   --ci                 non-interactive: implies --yes --no-install --no-git
   --no-install         skip npm install
   --no-git             skip git init
 ```
 
-Run with no options for an interactive wizard (`@clack/prompts`).
+Run with no options for an interactive wizard (`@clack/prompts`). The flag list
+above is printed by `--help`, generated from the registry so it can't drift. An
+unknown flag is an error, not a silently-ignored token.
 
 ### Compatible by construction
 
 The dimensions are linked, so you can't assemble an incompatible stack. Picking a
 technology constrains the rest (MongoDB rules out Drizzle; Supabase Auth needs
-Postgres; shadcn implies Tailwind). Incompatible flag combinations are rejected
+Postgres; shadcn implies Tailwind; the microservices bundle ships its own data
+layer, auth and pages, so it pins every other dimension but styling). Incompatible flag combinations are rejected
 with a clear message, and both the wizard and the [web configurator](#web-configurator)
 grey out options that clash with your current choices or aren't generatable yet.
 The catalogue + rules live in one place — `src/shared/registry.ts` — consumed by the
@@ -89,9 +92,16 @@ npm run dev      # http://localhost:3000
 ```
 
 The configurator reads the same option catalogue + compatibility rules as the CLI.
-`web/src/lib/stack.ts` is a mirror of `src/shared/registry.ts` (the deployable Next
-app imports no TypeScript from the engine); the `test/registry-sync.test.ts` suite
-fails if the two ever drift, so the registry stays the single source of truth.
+Since the deployable Next app compiles nothing from outside `web/`, the shared
+modules are generated into it:
+
+```bash
+npm run gen:web   # src/shared/{registry,compat}.ts -> web/src/lib/shared/
+```
+
+`web/src/lib/stack.ts` holds only the UI on top (grouping, `reconcile`, the command
+builder). CI re-runs the generator and fails on any diff, so `src/shared/registry.ts`
+stays the single source of truth.
 
 ## Develop Stackr
 
@@ -99,6 +109,7 @@ fails if the two ever drift, so the registry stays the single source of truth.
 npm install
 npm run build      # bundle the CLI with tsup -> dist/
 npm run typecheck  # type-check the engine
+npm run gen:web    # copy src/shared into the web configurator
 npm run smoke      # generate every stack and verify each installs + builds
 node dist/index.js demo --ci   # try it locally
 ```
@@ -112,6 +123,7 @@ npm test            # engine: flags, selections, package.json/env merge, install
                     # plus an integration test that scaffolds a project to a temp dir
 npm run smoke       # heavier: generate each stack (monolith, shadcn, microservices),
                     # then npm install, tsc and build the output
+npm run smoke -- clerk   # a single case; `-- --list` prints the case names
 cd web && npm test  # the command builder
 ```
 
@@ -121,6 +133,9 @@ Two GitHub Actions workflows:
 
 - **`.github/workflows/ci.yml`** — on every push/PR: typecheck, test and build the CLI
   (Node 18/20/22) and the web app.
+- **`.github/workflows/smoke.yml`** — nightly, on demand, and on any PR touching
+  `template/**` or the installers: generates every stack in a parallel job matrix and
+  checks each one installs, type-checks and builds.
 - **`.github/workflows/release.yml`** — on push to `main`: runs the checks, then
   [`semantic-release`](https://semantic-release.gitbook.io) versions, publishes to npm
   (with provenance), tags, writes `CHANGELOG.md` and creates a GitHub Release —

package/dist/index.js

@@ -3,28 +3,53 @@
 // src/index.ts
 import { createRequire } from "module";
 
+// src/cli/flags.ts
+import { parseArgs as nodeParseArgs } from "util";
+
 // src/shared/registry.ts
 var REGISTRY = {
   architecture: [
     { value: "monolith", label: "Monolith", status: "stable" },
-    // The microservices bundle ships its own Postgres data layer.
-    { value: "microservices", label: "Microservices", status: "stable", requires: { database: ["postgres"] } }
+    // The microservices bundle is a fixed stack: it ships its own Prisma/Postgres
+    // data layer, its own session auth in the API service, and its own web pages.
+    // The other dimensions can't be layered onto it, so it pins them (and an empty
+    // `interfaces` list means "no interface option fits").
+    {
+      value: "microservices",
+      label: "Microservices",
+      status: "stable",
+      requires: {
+        database: ["postgres"],
+        orm: ["prisma"],
+        auth: ["nextauth"],
+        interfaces: []
+      }
+    }
   ],
   database: [
     { value: "postgres", label: "PostgreSQL", status: "stable" },
     { value: "mysql", label: "MySQL", status: "stable" },
     // MongoDB pairs with the Mongoose ODM (Prisma/Drizzle here are SQL-only).
-    { value: "mongodb", label: "MongoDB", status: "stable", requires: { orm: ["mongoose"] } }
+    { value: "mongodb", label: "MongoDB", status: "stable", requires: { orm: ["mongoose"] } },
+    // No database: there is nothing for an ORM to talk to, so it forces "no ORM".
+    // NB: shares the value "none" with the ORM dimension, so keep the label generic
+    // (OPTION_LABELS is keyed by value across all dimensions).
+    { value: "none", label: "None", status: "stable", requires: { orm: ["none"] } }
   ],
   orm: [
-    { value: "prisma", label: "Prisma", status: "stable" },
+    // Prisma/Drizzle/Mongoose each need a real database to sit on top of.
+    { value: "prisma", label: "Prisma", status: "stable", requires: { database: ["postgres", "mysql", "mongodb"] } },
     // Drizzle is SQL-only: no MongoDB.
     { value: "drizzle", label: "Drizzle", status: "stable", requires: { database: ["postgres", "mysql"] } },
     // Mongoose is MongoDB-only.
-    { value: "mongoose", label: "Mongoose", status: "stable", requires: { database: ["mongodb"] } }
+    { value: "mongoose", label: "Mongoose", status: "stable", requires: { database: ["mongodb"] } },
+    // No data layer: only valid when there is no database either.
+    { value: "none", label: "None", status: "stable", requires: { database: ["none"] } }
   ],
   auth: [
-    { value: "nextauth", label: "NextAuth (Auth.js)", status: "stable" },
+    // NextAuth's credentials provider reads/writes users through an ORM overlay,
+    // so it needs a data layer (Prisma / Drizzle / Mongoose).
+    { value: "nextauth", label: "NextAuth (Auth.js)", status: "stable", requires: { orm: ["prisma", "drizzle", "mongoose"] } },
     // Clerk is hosted auth, independent of the chosen ORM/database.
     { value: "clerk", label: "Clerk", status: "stable" },
     // Supabase Auth is backed by a Supabase Postgres project.
@@ -70,9 +95,6 @@ var OPTION_LABELS = Object.fromEntries(
   DIMENSIONS.flatMap((d) => REGISTRY[d].map((o) => [o.value, o.label]))
 );
 var optionLabel = (value) => OPTION_LABELS[value] ?? value;
-var ALL_VALUES = Object.fromEntries(
-  DIMENSIONS.map((d) => [d, REGISTRY[d].map((o) => o.value)])
-);
 var STABLE_VALUES = Object.fromEntries(
   DIMENSIONS.map((d) => [d, REGISTRY[d].filter((o) => o.status === "stable").map((o) => o.value)])
 );
@@ -84,75 +106,48 @@ function findOption(dimension, value) {
 }
 
 // src/cli/flags.ts
-var SUPPORTED = STABLE_VALUES;
-var VALUE_FLAGS = /* @__PURE__ */ new Set([
-  "architecture",
-  "database",
-  "orm",
-  "auth",
-  "styling",
-  "interfaces"
-]);
-function parseArgs(argv) {
-  const result = { positionals: [], yes: false, help: false, version: false };
-  const positionals = [];
-  for (let i = 0; i < argv.length; i++) {
-    const token = argv[i];
-    if (!token.startsWith("-")) {
-      positionals.push(token);
-      continue;
-    }
-    let key = token.replace(/^--?/, "");
-    let value;
-    const eq = key.indexOf("=");
-    if (eq !== -1) {
-      value = key.slice(eq + 1);
-      key = key.slice(0, eq);
-    }
-    switch (key) {
-      case "help":
-      case "h":
-        result.help = true;
-        break;
-      case "version":
-      case "v":
-        result.version = true;
-        break;
-      case "yes":
-      case "y":
-        result.yes = true;
-        break;
-      case "ci":
-        result.yes = true;
-        result.install = false;
-        result.git = false;
-        break;
-      case "install":
-        result.install = true;
-        break;
-      case "no-install":
-        result.install = false;
-        break;
-      case "git":
-        result.git = true;
-        break;
-      case "no-git":
-        result.git = false;
-        break;
-      default: {
-        if (VALUE_FLAGS.has(key)) {
-          if (value === void 0) value = argv[++i];
-          if (key === "interfaces") {
-            result.interfaces = (value ?? "").split(",").map((s) => s.trim()).filter(Boolean);
-          } else {
-            result[key] = value;
-          }
-        }
-      }
-    }
+var UsageError = class extends Error {
+};
+var OPTIONS = {
+  ...Object.fromEntries(
+    DIMENSIONS.map((d) => [d, { type: "string" }])
+  ),
+  yes: { type: "boolean", short: "y" },
+  ci: { type: "boolean" },
+  install: { type: "boolean" },
+  "no-install": { type: "boolean" },
+  git: { type: "boolean" },
+  "no-git": { type: "boolean" },
+  help: { type: "boolean", short: "h" },
+  version: { type: "boolean", short: "v" }
+};
+function strictParse(argv) {
+  try {
+    return nodeParseArgs({ args: argv, options: OPTIONS, allowPositionals: true, strict: true });
+  } catch (err) {
+    throw new UsageError(err instanceof Error ? err.message : String(err));
   }
-  result.positionals = positionals;
-  return result;
+}
+function parseArgs(argv) {
+  const { values, positionals } = strictParse(argv);
+  const ci = values.ci === true;
+  const flag = (on, off) => on === true ? true : off === true || ci ? false : void 0;
+  const install = flag(values.install, values["no-install"]);
+  const git = flag(values.git, values["no-git"]);
+  return {
+    positionals,
+    architecture: values.architecture,
+    database: values.database,
+    orm: values.orm,
+    auth: values.auth,
+    styling: values.styling,
+    interfaces: values.interfaces === void 0 ? void 0 : values.interfaces.split(",").map((i) => i.trim()).filter(Boolean),
+    yes: values.yes === true || ci,
+    install,
+    git,
+    help: values.help === true,
+    version: values.version === true
+  };
 }
 
 // src/cli/create.ts
@@ -171,13 +166,32 @@ function getTemplateDir() {
 // src/utils/logger.ts
 import pc from "picocolors";
 var logger = {
-  info: (msg) => console.log(msg),
   success: (msg) => console.log(pc.green(msg)),
-  warn: (msg) => console.log(pc.yellow(msg)),
   error: (msg) => console.error(pc.red(msg)),
   dim: (msg) => console.log(pc.dim(msg))
 };
 
+// src/utils/packageManager.ts
+function detectPackageManager() {
+  const agent = process.env.npm_config_user_agent ?? "";
+  if (agent.startsWith("pnpm")) return "pnpm";
+  if (agent.startsWith("yarn")) return "yarn";
+  if (agent.startsWith("bun")) return "bun";
+  return "npm";
+}
+function execCommand(pm) {
+  switch (pm) {
+    case "pnpm":
+      return "pnpm exec";
+    case "yarn":
+      return "yarn";
+    case "bun":
+      return "bunx";
+    case "npm":
+      return "npx";
+  }
+}
+
 // src/helpers/scaffoldProject.ts
 import { promises as fs6 } from "fs";
 import path20 from "path";
@@ -479,57 +493,46 @@ var supabaseInstaller = async (ctx) => {
   });
 };
 
-// src/installers/tailwind.ts
+// src/installers/styling.ts
 import path13 from "path";
 var TAILWIND_DEV_DEPS = {
   tailwindcss: "^3.4.17",
   postcss: "^8.4.49",
   autoprefixer: "^10.4.20"
 };
-var tailwindInstaller = async (ctx) => {
-  const webDir = path13.join(ctx.projectDir, ctx.layout.webRoot);
-  await copyTemplate(path13.join(ctx.templateDir, "extras", "tailwind"), webDir);
-  if (ctx.layout.multiService) {
-    await mergePackageDependencies(path13.join(webDir, "package.json"), {}, TAILWIND_DEV_DEPS);
-  } else {
-    addDevDependencies(ctx.pkg, TAILWIND_DEV_DEPS);
-  }
-};
-
-// src/installers/shadcn.ts
-import path14 from "path";
 var SHADCN_DEPS = {
   "class-variance-authority": "^0.7.1",
   clsx: "^2.1.1",
   "tailwind-merge": "^2.6.0",
   "lucide-react": "^0.469.0"
 };
-var SHADCN_DEV_DEPS = {
-  tailwindcss: "^3.4.17",
-  postcss: "^8.4.49",
-  autoprefixer: "^10.4.20",
-  "tailwindcss-animate": "^1.0.7"
-};
-var shadcnInstaller = async (ctx) => {
-  const webDir = path14.join(ctx.projectDir, ctx.layout.webRoot);
-  await copyTemplate(path14.join(ctx.templateDir, "extras", "shadcn"), webDir);
+var SHADCN_DEV_DEPS = { ...TAILWIND_DEV_DEPS, "tailwindcss-animate": "^1.0.7" };
+async function installStyling(ctx, templateName, deps, devDeps) {
+  const webDir = path13.join(ctx.projectDir, ctx.layout.webRoot);
+  await copyTemplate(path13.join(ctx.templateDir, "extras", templateName), webDir);
   if (ctx.layout.multiService) {
-    await mergePackageDependencies(path14.join(webDir, "package.json"), SHADCN_DEPS, SHADCN_DEV_DEPS);
-  } else {
-    addDependencies(ctx.pkg, SHADCN_DEPS);
-    addDevDependencies(ctx.pkg, SHADCN_DEV_DEPS);
+    await mergePackageDependencies(path13.join(webDir, "package.json"), deps, devDeps);
+    return;
   }
-};
+  addDependencies(ctx.pkg, deps);
+  addDevDependencies(ctx.pkg, devDeps);
+}
+var tailwindInstaller = (ctx) => installStyling(ctx, "tailwind", {}, TAILWIND_DEV_DEPS);
+var shadcnInstaller = (ctx) => installStyling(ctx, "shadcn", SHADCN_DEPS, SHADCN_DEV_DEPS);
 
 // src/installers/auth-pages.ts
-import path15 from "path";
+import path14 from "path";
 var authPagesInstaller = async (ctx) => {
   if (ctx.selections.auth !== "nextauth") return;
-  await copyTemplate(path15.join(ctx.templateDir, "extras", "auth-pages"), ctx.projectDir);
+  await copyTemplate(path14.join(ctx.templateDir, "extras", "auth-pages"), ctx.projectDir);
   const overlay = `auth-pages-${ctx.selections.orm}`;
-  await copyTemplate(path15.join(ctx.templateDir, "extras", overlay), ctx.projectDir);
+  await copyTemplate(path14.join(ctx.templateDir, "extras", overlay), ctx.projectDir);
 };
 
+// src/installers/auth-ui.ts
+import path15 from "path";
+var authUiInstaller = (ctx) => copyTemplate(path15.join(ctx.templateDir, "extras", "auth-ui"), ctx.projectDir);
+
 // src/installers/account.ts
 import path16 from "path";
 var accountAdapterInstaller = async (ctx) => {
@@ -598,7 +601,7 @@ function resolveInstallers(selections) {
     if (selections.styling === "shadcn") installers.push(shadcnInstaller);
     return installers;
   }
-  installers.push(databaseInstaller);
+  if (selections.database !== "none") installers.push(databaseInstaller);
   if (selections.orm === "prisma") installers.push(prismaInstaller);
   if (selections.orm === "drizzle") installers.push(drizzleInstaller);
   if (selections.orm === "mongoose") installers.push(mongooseInstaller);
@@ -606,6 +609,8 @@ function resolveInstallers(selections) {
   if (selections.auth === "better-auth") installers.push(betterAuthInstaller);
   if (selections.auth === "clerk") installers.push(clerkInstaller);
   if (selections.auth === "supabase") installers.push(supabaseInstaller);
+  const rendersAuthPages = selections.auth === "better-auth" || selections.auth === "supabase" || selections.auth === "nextauth" && selections.interfaces.includes("auth-pages");
+  if (rendersAuthPages) installers.push(authUiInstaller);
   if (selections.styling === "tailwind") installers.push(tailwindInstaller);
   if (selections.styling === "shadcn") installers.push(shadcnInstaller);
   if (selections.interfaces.includes("auth-pages")) installers.push(authPagesInstaller);
@@ -627,16 +632,122 @@ function getLayout(architecture) {
   return LAYOUTS[architecture];
 }
 
+// src/shared/compat.ts
+function selectedValues(selection, dimension) {
+  const raw = selection[dimension];
+  if (raw === void 0) return [];
+  return Array.isArray(raw) ? raw : [raw];
+}
+function conflict(selection, dimension, value) {
+  const own = findOption(dimension, value);
+  for (const other of DIMENSIONS) {
+    if (other === dimension) continue;
+    for (const otherValue of selectedValues(selection, other)) {
+      const forward = own?.requires?.[other];
+      if (forward && !forward.includes(otherValue)) return [other, otherValue];
+      const backward = findOption(other, otherValue)?.requires?.[dimension];
+      if (backward && !backward.includes(value)) return [other, otherValue];
+    }
+  }
+  return void 0;
+}
+function resolveAvailability(selection) {
+  const out = {};
+  for (const dimension of DIMENSIONS) {
+    out[dimension] = REGISTRY[dimension].map((option) => {
+      const clash = conflict(selection, dimension, option.value);
+      const generatable = option.status === "stable";
+      let reason;
+      if (clash) {
+        reason = `incompatible with ${clash[0]} "${optionLabel(clash[1])}"`;
+      } else if (!generatable) {
+        reason = "coming soon";
+      }
+      return { value: option.value, enabled: !clash, generatable, reason };
+    });
+  }
+  return out;
+}
+function validateCompat(selection) {
+  const errors = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const dimension of DIMENSIONS) {
+    for (const value of selectedValues(selection, dimension)) {
+      const clash = conflict(selection, dimension, value);
+      if (!clash) continue;
+      const key = [dimension, value, clash[0], clash[1]].sort().join("|");
+      if (seen.has(key)) continue;
+      seen.add(key);
+      errors.push(
+        `${dimension} "${optionLabel(value)}" is incompatible with ${clash[0]} "${optionLabel(clash[1])}".`
+      );
+    }
+  }
+  return errors;
+}
+function impliedInterfaces(auth, interfaces) {
+  const wantsAccount = interfaces.includes("dashboard") || interfaces.includes("admin");
+  if (auth !== "nextauth" || !wantsAccount || interfaces.includes("auth-pages")) return interfaces;
+  return ["auth-pages", ...interfaces];
+}
+function defaultSelection(pinned) {
+  const singles = DIMENSIONS.filter((d) => d !== "interfaces");
+  const out = { ...pinned };
+  for (let pass = 0; pass < singles.length; pass++) {
+    const availability = resolveAvailability(out);
+    let changed = false;
+    for (const dimension of singles) {
+      if (pinned[dimension] !== void 0) continue;
+      const pick = availability[dimension].find((a) => a.enabled && a.generatable)?.value;
+      if (pick !== void 0 && pick !== out[dimension]) {
+        out[dimension] = pick;
+        changed = true;
+      }
+    }
+    if (!changed) break;
+  }
+  if (pinned.interfaces === void 0) {
+    const availability = resolveAvailability(out);
+    out.interfaces = [DEFAULT_VALUES.interfaces].filter(
+      (value) => availability.interfaces.some((a) => a.value === value && a.enabled && a.generatable)
+    );
+  }
+  return out;
+}
+
 // src/helpers/generateReadme.ts
-function generateReadme(selections) {
-  const interfaces = selections.interfaces.length ? selections.interfaces.map((i) => `- ${optionLabel(i)}`).join("\n") : "- _(none)_";
-  const dbEngine = { postgres: "Postgres", mysql: "MySQL", mongodb: "MongoDB" }[selections.database] ?? "Postgres";
-  const gettingStarted = selections.architecture === "microservices" ? microservicesGettingStarted() : monolithGettingStarted(dbEngine, selections.orm);
+function generateReadme(selections, pm) {
+  const body = selections.architecture === "microservices" ? microservicesBody(selections, pm) : monolithBody(selections, pm);
   return `# ${selections.projectName}
 
-Generated with [Stackr](https://github.com/) \u2014 a runnable full-stack Next.js starter.
+Generated with [Stackr](https://github.com/Tristan-stack/stackr) \u2014 a runnable full-stack Next.js starter.
 
-## Stack
+${body}`;
+}
+function monolithBody(selections, pm) {
+  const interfaces = selections.interfaces.length ? selections.interfaces.map((i) => `- ${optionLabel(i)}`).join("\n") : "- _(none)_";
+  const dbEngine = selections.database === "none" ? null : optionLabel(selections.database);
+  const schemaStep = selections.orm === "prisma" ? `
+# 3. Create the database schema
+${execCommand(pm)} prisma migrate dev --name init
+` : selections.orm === "drizzle" ? `
+# 3. Create the database schema
+${pm} run db:push
+` : "";
+  const dbScriptRows = selections.orm === "prisma" ? `| \`${pm} run db:migrate\` | Run Prisma migrations |
+| \`${pm} run db:studio\` | Open Prisma Studio |
+` : selections.orm === "drizzle" ? `| \`${pm} run db:push\` | Push the schema to the database |
+| \`${pm} run db:studio\` | Open Drizzle Studio |
+` : "";
+  const dbStep = dbEngine ? `# 1. Start a local ${dbEngine} (requires Docker)
+docker compose up -d
+
+# 2. Install dependencies
+${pm} install
+` : `# 1. Install dependencies
+${pm} install
+`;
+  return `## Stack
 
 - **Architecture:** ${optionLabel(selections.architecture)}
 - **Database:** ${optionLabel(selections.database)}
@@ -648,22 +759,12 @@ Generated with [Stackr](https://github.com/) \u2014 a runnable full-stack Next.j
 
 ${interfaces}
 
-${gettingStarted}`;
-}
-function monolithGettingStarted(dbEngine, orm) {
-  const schemaStep = orm === "prisma" ? "\n# 3. Create the database schema\nnpx prisma migrate dev --name init\n" : orm === "drizzle" ? "\n# 3. Create the database schema\nnpm run db:push\n" : "";
-  const dbScriptRows = orm === "prisma" ? "| `npm run db:migrate` | Run Prisma migrations |\n| `npm run db:studio` | Open Prisma Studio |\n" : orm === "drizzle" ? "| `npm run db:push` | Push the schema to the database |\n| `npm run db:studio` | Open Drizzle Studio |\n" : "";
-  return `## Getting started
+## Getting started
 
 \`\`\`bash
-# 1. Start a local ${dbEngine} (requires Docker)
-docker compose up -d
-
-# 2. Install dependencies
-npm install
-${schemaStep}
+${dbStep}${schemaStep}
 # Run the app
-npm run dev
+${pm} run dev
 \`\`\`
 
 Then open [http://localhost:3000](http://localhost:3000).
@@ -680,15 +781,19 @@ generated \`AUTH_SECRET\` was already created for you.
 
 | Script | Description |
 | ------ | ----------- |
-| \`npm run dev\` | Start the dev server |
-| \`npm run build\` | Production build |
-${dbScriptRows}| \`npm run typecheck\` | Type-check without emitting |
+| \`${pm} run dev\` | Start the dev server |
+| \`${pm} run build\` | Production build |
+${dbScriptRows}| \`${pm} run typecheck\` | Type-check without emitting |
 `;
 }
-function microservicesGettingStarted() {
-  return `## Architecture
+function microservicesBody(selections, pm) {
+  return `## Stack
 
-This is an npm-workspaces monorepo split into independent services:
+- **Architecture:** ${optionLabel(selections.architecture)} (npm workspaces: web + API + gateway)
+- **Database:** PostgreSQL (docker-compose)
+- **ORM:** Prisma, owned by \`services/api\`
+- **Auth:** email + password, sessions signed as JWTs by the API service
+- **Styling:** ${optionLabel(selections.styling)}
 
 | Path | Service | Description |
 | ---- | ------- | ----------- |
@@ -706,13 +811,13 @@ service (prefix stripped) and all other routes to the web app.
 docker compose up -d db
 
 # 2. Install dependencies for every workspace
-npm install
+${pm} install
 
 # 3. Create the database schema (runs in services/api)
-npm run db:migrate
+${pm} run db:migrate
 
 # 4. Run the web app and the API together
-npm run dev
+${pm} run dev
 \`\`\`
 
 - web: [http://localhost:3000](http://localhost:3000) \xB7 api: [http://localhost:3001](http://localhost:3001)
@@ -736,11 +841,11 @@ generated \`AUTH_SECRET\` was already created for you.
 
 | Script | Description |
 | ------ | ----------- |
-| \`npm run dev\` | Start every workspace (web + api) |
-| \`npm run build\` | Build every workspace |
-| \`npm run db:migrate\` | Run Prisma migrations in the API service |
-| \`npm run db:studio\` | Open Prisma Studio for the API database |
-| \`npm run compose:up\` | Start the full stack via docker-compose |
+| \`${pm} run dev\` | Start every workspace (web + api) |
+| \`${pm} run build\` | Build every workspace |
+| \`${pm} run db:migrate\` | Run Prisma migrations in the API service |
+| \`${pm} run db:studio\` | Open Prisma Studio for the API database |
+| \`${pm} run compose:up\` | Start the full stack via docker-compose |
 `;
 }
 
@@ -751,14 +856,11 @@ function architectureBase(templateDir, selections) {
   }
   return path20.join(templateDir, "base");
 }
-function withImpliedInterfaces(selections) {
-  const wantsAccount = selections.interfaces.includes("dashboard") || selections.interfaces.includes("admin");
-  const needsPortal = selections.auth === "nextauth" && wantsAccount && !selections.interfaces.includes("auth-pages");
-  if (!needsPortal) return selections;
-  return { ...selections, interfaces: ["auth-pages", ...selections.interfaces] };
-}
-async function scaffoldProject(templateDir, projectDir, inputSelections) {
-  const selections = withImpliedInterfaces(inputSelections);
+async function scaffoldProject(templateDir, projectDir, inputSelections, pm = "npm") {
+  const selections = {
+    ...inputSelections,
+    interfaces: impliedInterfaces(inputSelections.auth, inputSelections.interfaces)
+  };
   await fs6.mkdir(projectDir, { recursive: true });
   await copyTemplate(architectureBase(templateDir, selections), projectDir);
   const pkgPath = path20.join(projectDir, "package.json");
@@ -774,25 +876,25 @@ async function scaffoldProject(templateDir, projectDir, inputSelections) {
   await writeEnvFiles(projectDir, env);
   await fs6.writeFile(
     path20.join(projectDir, "README.md"),
-    generateReadme(selections),
+    generateReadme(selections, pm),
     "utf8"
   );
 }
 
 // src/helpers/installDependencies.ts
 import { spawn } from "child_process";
-function installDependencies(projectDir) {
+function installDependencies(projectDir, pm) {
   return new Promise((resolve, reject) => {
-    const child = spawn("npm", ["install"], {
+    const child = spawn(pm, ["install"], {
       cwd: projectDir,
       stdio: "inherit",
-      // npm is a .cmd shim on Windows; shell:true resolves it correctly.
+      // Package managers are .cmd shims on Windows; shell:true resolves them.
       shell: process.platform === "win32"
     });
     child.on("error", reject);
     child.on("close", (code) => {
       if (code === 0) resolve();
-      else reject(new Error(`npm install exited with code ${code}`));
+      else reject(new Error(`${pm} install exited with code ${code}`));
     });
   });
 }
@@ -823,98 +925,43 @@ async function initGit(projectDir) {
 
 // src/helpers/logNextSteps.ts
 import path21 from "path";
-function logNextSteps({ projectDir, selections, depsInstalled }) {
-  const rel = path21.relative(process.cwd(), projectDir) || ".";
-  const steps = [`cd ${rel}`];
+function logNextSteps({ projectDir, selections, depsInstalled, pm }) {
+  const steps = [];
+  const step = (command, comment) => steps.push(comment ? `${command.padEnd(26)}# ${comment}` : command);
+  step(`cd ${path21.relative(process.cwd(), projectDir) || "."}`);
   if (selections.architecture === "microservices") {
-    steps.push("docker compose up -d db     # start local Postgres");
-    if (!depsInstalled) steps.push("npm install                 # installs every workspace");
-    steps.push("npm run db:migrate          # migrate the API database");
-    steps.push("npm run dev                 # web + api together");
+    step("docker compose up -d db", "start local Postgres");
+    if (!depsInstalled) step(`${pm} install`, "installs every workspace");
+    step(`${pm} run db:migrate`, "migrate the API database");
+    step(`${pm} run dev`, "web + api together");
   } else {
-    const engineLabel = {
-      postgres: "Postgres",
-      mysql: "MySQL",
-      mongodb: "MongoDB"
-    };
-    if (engineLabel[selections.database]) {
-      steps.push(`docker compose up -d        # start local ${engineLabel[selections.database]}`);
-    }
-    if (!depsInstalled) {
-      steps.push("npm install");
+    if (selections.database !== "none") {
+      step("docker compose up -d", `start local ${optionLabel(selections.database)}`);
     }
+    if (!depsInstalled) step(`${pm} install`);
     if (selections.orm === "prisma") {
-      steps.push("npx prisma migrate dev --name init");
+      step(`${execCommand(pm)} prisma migrate dev --name init`);
     } else if (selections.orm === "drizzle") {
-      steps.push("npm run db:push           # create the schema with Drizzle");
+      step(`${pm} run db:push`, "create the schema with Drizzle");
     }
-    steps.push("npm run dev");
+    step(`${pm} run dev`);
   }
   console.log("");
   console.log(pc.bold("Next steps:"));
-  for (const step of steps) {
-    console.log("  " + pc.cyan(step));
-  }
+  for (const s of steps) console.log("  " + pc.cyan(s));
   console.log("");
-  return steps;
 }
 
 // src/cli/wizard.ts
 import * as p from "@clack/prompts";
 
-// src/shared/compat.ts
-function selectedValues(selection, dimension) {
-  const raw = selection[dimension];
-  if (raw === void 0) return [];
-  return Array.isArray(raw) ? raw : [raw];
-}
-function conflict(selection, dimension, value) {
-  const own = findOption(dimension, value);
-  for (const other of DIMENSIONS) {
-    if (other === dimension) continue;
-    for (const otherValue of selectedValues(selection, other)) {
-      const forward = own?.requires?.[other];
-      if (forward && !forward.includes(otherValue)) return [other, otherValue];
-      const backward = findOption(other, otherValue)?.requires?.[dimension];
-      if (backward && !backward.includes(value)) return [other, otherValue];
-    }
-  }
+// src/shared/projectName.ts
+var VALID = /^[a-z0-9][a-z0-9-_.]*$/i;
+function validateProjectName(name) {
+  if (!name) return "Please enter a project name.";
+  if (!VALID.test(name)) return "Use letters, numbers, '-', '_' or '.'.";
   return void 0;
 }
-function resolveAvailability(selection) {
-  const out = {};
-  for (const dimension of DIMENSIONS) {
-    out[dimension] = REGISTRY[dimension].map((option) => {
-      const clash = conflict(selection, dimension, option.value);
-      const generatable = option.status === "stable";
-      let reason;
-      if (clash) {
-        reason = `incompatible with ${clash[0]} "${optionLabel(clash[1])}"`;
-      } else if (!generatable) {
-        reason = "coming soon";
-      }
-      return { value: option.value, enabled: !clash, generatable, reason };
-    });
-  }
-  return out;
-}
-function validateCompat(selection) {
-  const errors = [];
-  const seen = /* @__PURE__ */ new Set();
-  for (const dimension of DIMENSIONS) {
-    for (const value of selectedValues(selection, dimension)) {
-      const clash = conflict(selection, dimension, value);
-      if (!clash) continue;
-      const key = [dimension, value, clash[0], clash[1]].sort().join("|");
-      if (seen.has(key)) continue;
-      seen.add(key);
-      errors.push(
-        `${dimension} "${optionLabel(value)}" is incompatible with ${clash[0]} "${optionLabel(clash[1])}".`
-      );
-    }
-  }
-  return errors;
-}
 
 // src/cli/wizard.ts
 function bail() {
@@ -936,7 +983,16 @@ function isSelectable(dimension, value, selection) {
   const a = resolveAvailability(selection)[dimension].find((x) => x.value === value);
   return a.enabled && a.generatable;
 }
+function selectable(dimension, selection) {
+  return resolveAvailability(selection)[dimension].filter((a) => a.enabled && a.generatable).map((a) => a.value);
+}
 async function selectDimension(message, dimension, selection) {
+  const options = selectable(dimension, selection);
+  if (options.length === 1) {
+    const only = options[0];
+    p.log.info(`${message.replace(/\?$/, "")}: only ${optionLabel(only)} fits your stack.`);
+    return only;
+  }
   for (; ; ) {
     const value = unwrap(
       await p.select({
@@ -950,18 +1006,14 @@ async function selectDimension(message, dimension, selection) {
     p.log.warn(`"${optionLabel(value)}" is ${reason}. Please pick another.`);
   }
 }
-async function runWizard(defaults) {
+async function runWizard(defaults2) {
   p.intro("Stackr \u2014 scaffold a runnable full-stack Next.js project");
   const projectName = unwrap(
     await p.text({
       message: "Project name?",
       placeholder: "my-app",
-      initialValue: defaults.projectName,
-      validate: (v) => {
-        if (!v) return "Please enter a project name.";
-        if (!/^[a-z0-9][a-z0-9-_.]*$/i.test(v)) return "Use letters, numbers, '-', '_' or '.'.";
-        return void 0;
-      }
+      initialValue: defaults2.projectName,
+      validate: validateProjectName
     })
   );
   const selection = {};
@@ -970,20 +1022,24 @@ async function runWizard(defaults) {
   selection.orm = await selectDimension("ORM / data layer?", "orm", selection);
   selection.auth = await selectDimension("Authentication?", "auth", selection);
   selection.styling = await selectDimension("Styling?", "styling", selection);
-  const picked = unwrap(
-    await p.multiselect({
-      message: "Pre-built interfaces? (space to toggle)",
-      options: buildOptions("interfaces", selection),
-      initialValues: ["auth-pages"],
-      required: false
-    })
-  );
   const interfaces = [];
-  for (const value of picked) {
-    if (isSelectable("interfaces", value, selection)) interfaces.push(value);
-    else {
-      const reason = resolveAvailability(selection).interfaces.find((x) => x.value === value).reason;
-      p.log.warn(`Skipping "${optionLabel(value)}" \u2014 ${reason}.`);
+  if (selectable("interfaces", selection).length === 0) {
+    p.log.info("This stack ships its own pages \u2014 no extra interfaces to add.");
+  } else {
+    const picked = unwrap(
+      await p.multiselect({
+        message: "Pre-built interfaces? (space to toggle)",
+        options: buildOptions("interfaces", selection),
+        initialValues: ["auth-pages"],
+        required: false
+      })
+    );
+    for (const value of picked) {
+      if (isSelectable("interfaces", value, selection)) interfaces.push(value);
+      else {
+        const reason = resolveAvailability(selection).interfaces.find((x) => x.value === value).reason;
+        p.log.warn(`Skipping "${optionLabel(value)}" \u2014 ${reason}.`);
+      }
     }
   }
   selection.interfaces = interfaces;
@@ -1005,22 +1061,31 @@ function projectNameFromArgs(args) {
   return positionals[0];
 }
 function selectionsFromFlags(args) {
+  const pinned = {};
+  for (const dimension of DIMENSIONS) {
+    const value = args[dimension];
+    if (value !== void 0) pinned[dimension] = value;
+  }
+  const settled = defaultSelection(pinned);
+  const single = (dimension) => settled[dimension];
   return {
     projectName: projectNameFromArgs(args) ?? "my-app",
-    architecture: args.architecture ?? "monolith",
-    database: args.database ?? "postgres",
-    orm: args.orm ?? "prisma",
-    auth: args.auth ?? "nextauth",
-    styling: args.styling ?? "tailwind",
-    interfaces: args.interfaces ?? ["auth-pages"]
+    architecture: single("architecture"),
+    database: single("database"),
+    orm: single("orm"),
+    auth: single("auth"),
+    styling: single("styling"),
+    interfaces: settled.interfaces
   };
 }
 function validateSelections(s) {
   const errors = [];
+  const nameError = validateProjectName(s.projectName);
+  if (nameError) errors.push(`project name "${s.projectName}" is invalid. ${nameError}`);
   const check = (dim, value) => {
-    if (!SUPPORTED[dim].includes(value)) {
+    if (!STABLE_VALUES[dim].includes(value)) {
       errors.push(
-        `${dim} "${value}" is not supported yet (currently generatable: ${SUPPORTED[dim].join(", ")}).`
+        `${dim} "${value}" is not supported yet (currently generatable: ${STABLE_VALUES[dim].join(", ")}).`
       );
     }
   };
@@ -1040,7 +1105,9 @@ async function isEmptyDir(dir) {
     const entries = await fs7.readdir(dir);
     return entries.length === 0;
   } catch (err) {
-    if (err.code === "ENOENT") return true;
+    const code = err.code;
+    if (code === "ENOENT") return true;
+    if (code === "ENOTDIR") return false;
     throw err;
   }
 }
@@ -1059,25 +1126,27 @@ async function runCreate(args) {
 Target directory "${selections.projectName}" exists and is not empty. Aborting.`);
     process.exit(1);
   }
+  const pm = detectPackageManager();
   const spinner2 = p2.spinner();
   spinner2.start("Scaffolding project");
   try {
-    await scaffoldProject(getTemplateDir(), projectDir, selections);
+    await scaffoldProject(getTemplateDir(), projectDir, selections, pm);
     spinner2.stop("Project scaffolded");
   } catch (err) {
     spinner2.stop("Scaffolding failed");
+    await fs7.rm(projectDir, { recursive: true, force: true });
     throw err;
   }
   let depsInstalled = false;
   if (args.install !== false) {
     const installSpinner = p2.spinner();
-    installSpinner.start("Installing dependencies (npm install)");
+    installSpinner.start(`Installing dependencies (${pm} install)`);
     try {
-      await installDependencies(projectDir);
+      await installDependencies(projectDir, pm);
       installSpinner.stop("Dependencies installed");
       depsInstalled = true;
     } catch {
-      installSpinner.stop("Dependency install skipped (run npm install manually)");
+      installSpinner.stop(`Dependency install skipped (run ${pm} install manually)`);
     }
   }
   if (args.git !== false) {
@@ -1085,12 +1154,19 @@ Target directory "${selections.projectName}" exists and is not empty. Aborting.`
   }
   logger.success(`
 \u2714 Created ${pc.bold(selections.projectName)} (${optionLabel(selections.architecture)})`);
-  logNextSteps({ projectDir, selections, depsInstalled });
+  logNextSteps({ projectDir, selections, depsInstalled, pm });
 }
 
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
+var stackOptions = DIMENSIONS.map((d) => {
+  const isList = d === "interfaces";
+  const values = STABLE_VALUES[d].join(isList ? "," : " | ");
+  const suffix = isList ? "   (comma-separated; `--interfaces=` for none)" : "";
+  return `  ${`--${d} <value>`.padEnd(24)} ${values}${suffix}`;
+}).join("\n");
+var defaults = DIMENSIONS.map((d) => DEFAULT_VALUES[d]).join(", ");
 var HELP = `
 create-stackrjs \u2014 scaffold a runnable full-stack Next.js project.
 
@@ -1098,16 +1174,16 @@ Usage:
   npm create stackrjs@latest [name] -- [options]
   npx create-stackrjs [name] [options]
 
-Options:
-  --architecture <a>   monolith            (monorepo/microservices/bff: coming soon)
-  --database <db>      postgres            (mysql/sqlite/mongodb: coming soon)
-  --orm <orm>          prisma              (drizzle/mongoose: coming soon)
-  --auth <auth>        nextauth            (clerk/supabase/jwt: coming soon)
-  --styling <s>        tailwind            (css-modules/styled-components/shadcn: coming soon)
-  --interfaces <list>  comma-separated; v1: auth-pages
+Stack options:
+${stackOptions}
+
+  Defaults: ${defaults}.
+  Incompatible combinations are rejected with an explanation.
+
+Other options:
   -y, --yes            skip the wizard, use flags + defaults
   --ci                 non-interactive: implies --yes --no-install --no-git
-  --no-install         do not run npm install
+  --no-install         do not run the dependency install
   --no-git             do not initialize a git repository
   -h, --help           show this help
   -v, --version        show version
@@ -1130,6 +1206,11 @@ async function main() {
   await runCreate(args);
 }
 main().catch((err) => {
-  logger.error("\n" + (err instanceof Error ? err.stack ?? err.message : String(err)));
+  if (err instanceof UsageError) {
+    logger.error("\n" + err.message);
+    logger.dim("Run `create-stackrjs --help` to see the available options.\n");
+  } else {
+    logger.error("\n" + (err instanceof Error ? err.stack ?? err.message : String(err)));
+  }
   process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-stackrjs",
-  "version": "1.4.0",
+  "version": "2.0.0",
   "description": "Scaffold a runnable full-stack Next.js project in one command",
   "type": "module",
   "bin": {
@@ -11,7 +11,7 @@
     "template"
   ],
   "engines": {
-    "node": ">=18.18.0"
+    "node": ">=20.9.0"
   },
   "scripts": {
     "build": "tsup",
@@ -21,6 +21,7 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "smoke": "tsx scripts/smoke.ts",
+    "gen:web": "tsx scripts/gen-web-registry.ts",
     "release": "semantic-release",
     "prepublishOnly": "npm run build"
   },

package/template/extras/auth-pages/src/components/auth/ui.tsx

@@ -1,57 +0,0 @@
-import type { ComponentProps, ReactNode } from "react";
-import Link from "next/link";
-
-/** Centered card shell shared by all auth pages. */
-export function AuthShell({ title, children }: { title: string; children: ReactNode }) {
-  return (
-    <main className="flex min-h-screen items-center justify-center bg-gray-50 p-4">
-      <div className="w-full max-w-sm rounded-xl border border-gray-200 bg-white p-8 shadow-sm">
-        <h1 className="mb-6 text-2xl font-semibold tracking-tight">{title}</h1>
-        {children}
-      </div>
-    </main>
-  );
-}
-
-export function Field({ label, ...props }: { label: string } & ComponentProps<"input">) {
-  return (
-    <label className="mb-4 block">
-      <span className="mb-1 block text-sm font-medium text-gray-700">{label}</span>
-      <input
-        {...props}
-        className="w-full rounded-md border border-gray-300 px-3 py-2 text-sm outline-none focus:border-gray-900"
-      />
-    </label>
-  );
-}
-
-export function SubmitButton({ children }: { children: ReactNode }) {
-  return (
-    <button
-      type="submit"
-      className="w-full rounded-md bg-gray-900 px-3 py-2 text-sm font-medium text-white transition hover:bg-gray-700"
-    >
-      {children}
-    </button>
-  );
-}
-
-export function Alert({ kind, children }: { kind: "error" | "success"; children: ReactNode }) {
-  const styles =
-    kind === "error"
-      ? "bg-red-50 text-red-700 border-red-200"
-      : "bg-green-50 text-green-700 border-green-200";
-  return <p className={`mb-4 rounded-md border px-3 py-2 text-sm ${styles}`}>{children}</p>;
-}
-
-export function FooterLinks({ children }: { children: ReactNode }) {
-  return <div className="mt-6 space-y-1 text-center text-sm text-gray-500">{children}</div>;
-}
-
-export function TextLink({ href, children }: { href: string; children: ReactNode }) {
-  return (
-    <Link href={href} className="font-medium text-gray-900 underline-offset-2 hover:underline">
-      {children}
-    </Link>
-  );
-}

package/template/extras/supabase/src/components/auth/ui.tsx

@@ -1,58 +0,0 @@
-import type { ComponentProps, ReactNode } from "react";
-import Link from "next/link";
-
-/** Centered card shell shared by all auth pages. */
-export function AuthShell({ title, children }: { title: string; children: ReactNode }) {
-  return (
-    <main className="flex min-h-screen items-center justify-center bg-gray-50 p-4">
-      <div className="w-full max-w-sm rounded-xl border border-gray-200 bg-white p-8 shadow-sm">
-        <h1 className="mb-6 text-2xl font-semibold tracking-tight">{title}</h1>
-        {children}
-      </div>
-    </main>
-  );
-}
-
-export function Field({ label, ...props }: { label: string } & ComponentProps<"input">) {
-  return (
-    <label className="mb-4 block">
-      <span className="mb-1 block text-sm font-medium text-gray-700">{label}</span>
-      <input
-        {...props}
-        className="w-full rounded-md border border-gray-300 px-3 py-2 text-sm outline-none focus:border-gray-900"
-      />
-    </label>
-  );
-}
-
-export function SubmitButton({ children, ...props }: ComponentProps<"button">) {
-  return (
-    <button
-      {...props}
-      type="submit"
-      className="w-full rounded-md bg-gray-900 px-3 py-2 text-sm font-medium text-white transition hover:bg-gray-700 disabled:opacity-60"
-    >
-      {children}
-    </button>
-  );
-}
-
-export function Alert({ kind, children }: { kind: "error" | "success"; children: ReactNode }) {
-  const styles =
-    kind === "error"
-      ? "bg-red-50 text-red-700 border-red-200"
-      : "bg-green-50 text-green-700 border-green-200";
-  return <p className={`mb-4 rounded-md border px-3 py-2 text-sm ${styles}`}>{children}</p>;
-}
-
-export function FooterLinks({ children }: { children: ReactNode }) {
-  return <div className="mt-6 space-y-1 text-center text-sm text-gray-500">{children}</div>;
-}
-
-export function TextLink({ href, children }: { href: string; children: ReactNode }) {
-  return (
-    <Link href={href} className="font-medium text-gray-900 underline-offset-2 hover:underline">
-      {children}
-    </Link>
-  );
-}