create-lacspace-app 2.8.0 → 2.9.0

package/README.md

@@ -20,6 +20,11 @@ npx create-lacspace-app my-app --template saas --fullstack
 
 You choose the *kind* of site you're building. It writes a **real Next.js 15 + React 19 + Tailwind v4 app** — not a hello-world, but a genuinely **polished, modern site**: a fluid `clamp()` type scale, tight display headings, a refined light **and** dark palette, glass chrome, soft layered shadows, a smooth logo marquee, animated counters, scroll reveals and a shimmering primary CTA — every page filled in, an SEO stack wired end-to-end, and a **26-component UI kit** you can drop in anywhere.
 
+> **New in v2.9 — guided & discoverable.** Made for newcomers:
+> - **Guided start** — the interactive prompt now offers a **recipe** first ("what are you building?"), so you can ship a whole product without knowing the flags.
+> - **`list`** — `npx create-lacspace-app list` shows every template, add-on and recipe. **`explain <name>`** describes what any add-on or recipe gives you (packages, next steps, docs link).
+> - **`--dry-run`** prints the exact files a command would create without writing anything. `--brand "#hex"` is an alias for `--theme`.
+
 > **New in v2.8 — recipes.** Scaffold a whole *kind of product* in one command with `--recipe <key>` (a curated template + full-stack mode + add-on stack):
 > - **`ai-saas`** → SaaS + accounts + payments + AI chat + analytics
 > - **`store`** → e-commerce + eSewa/Khalti checkout + email + analytics

package/dist/index.js

@@ -7217,7 +7217,7 @@ function backendFiles(ctx) {
 }
 var splitList = (s) => s.split(",").map((x) => x.trim()).filter(Boolean);
 function parseArgs(list) {
-  const a = { features: [], yes: false, install: true, git: true, pm: "npm", help: false };
+  const a = { features: [], yes: false, install: true, git: true, pm: "npm", help: false, dryRun: false };
   for (let i = 0; i < list.length; i++) {
     const arg = list[i];
     const next = () => list[++i] ?? "";
@@ -7225,8 +7225,9 @@ function parseArgs(list) {
     else if (arg === "-y" || arg === "--yes") a.yes = true;
     else if (arg === "--no-install") a.install = false;
     else if (arg === "--no-git") a.git = false;
+    else if (arg === "--dry-run" || arg === "--dry") a.dryRun = true;
     else if (arg === "--pm") a.pm = next();
-    else if (arg === "--theme" || arg === "--accent") a.theme = next();
+    else if (arg === "--theme" || arg === "--accent" || arg === "--brand") a.theme = next();
     else if (arg === "--with" || arg === "--features") a.features.push(...splitList(next()));
     else if (arg === "--fullstack" || arg === "--full-stack" || arg === "--dynamic") a.mode = "dynamic";
     else if (arg === "--static") a.mode = "static";
@@ -7242,6 +7243,7 @@ function parseArgs(list) {
     else if (arg.startsWith("--template=")) a.template = arg.slice(11);
     else if (arg.startsWith("--theme=")) a.theme = arg.slice(8);
     else if (arg.startsWith("--accent=")) a.theme = arg.slice(9);
+    else if (arg.startsWith("--brand=")) a.theme = arg.slice(8);
     else if (arg.startsWith("--with=")) a.features.push(...splitList(arg.slice(7)));
     else if (arg.startsWith("--features=")) a.features.push(...splitList(arg.slice(11)));
     else if (!arg.startsWith("-") && !a.name) a.name = arg;
@@ -7332,6 +7334,8 @@ ${c("bold", "Usage")}
   npm create lacspace-app@latest <name> [options]
   npx create-lacspace-app <name> --template <key>
   npx create-lacspace-app add <section...>   ${c("dim", "# grow an existing app")}
+  npx create-lacspace-app list                ${c("dim", "# templates, add-ons & recipes")}
+  npx create-lacspace-app explain <name>      ${c("dim", "# what an add-on/recipe gives you")}
 
 ${c("bold", "Templates")}
 ${TEMPLATES.map((t) => `  ${t.key.padEnd(10)} ${t.description}`).join("\n")}
@@ -7343,8 +7347,9 @@ ${c("bold", "Options")}
                          ${c("dim", "(alias --dynamic; default is --static, a single Next.js app)")}
   --with <a,b>           Feature add-ons, comma-separated (alias --features)
   --recipe <key>         Start from a curated stack (${RECIPES.map((r) => r.key).join(" | ")})
-  --theme <name|hex>     Accent: a preset, a "#hex", or "from,to" (e.g. --theme lacspace)
+  --theme <name|hex>     Accent: a preset, a "#hex", or "from,to" (alias --brand)
   --pm <npm|pnpm|yarn|bun>  Package manager (default npm)
+  --dry-run              Print the files that would be created; write nothing
   --no-install           Skip installing dependencies
   --no-git               Skip git init
   -y, --yes              Accept defaults (needs <name>)
@@ -7720,12 +7725,103 @@ ${c("bold", "Use them")} \u2014 import into any page:
     return;
   }
 }
+function runList() {
+  stdout.write(`
+${c("bold", c("magenta", "\u25C6 create-lacspace-app"))} ${c("dim", "\u2014 what you can build")}
+`);
+  stdout.write(`
+${c("bold", "Templates")} ${c("dim", "(-t / --template)")}
+`);
+  for (const t of TEMPLATES) stdout.write(`  ${c("cyan", t.key.padEnd(12))} ${c("dim", t.description)}
+`);
+  stdout.write(`
+${c("bold", "Add-ons")} ${c("dim", "(--with) \u2014 free & keyless")}
+`);
+  for (const f of FEATURES) stdout.write(`  ${c("cyan", f.key.padEnd(12))} ${c("dim", f.description)}${f.requiresBackend ? c("green", "  [full-stack]") : ""}
+`);
+  stdout.write(`
+${c("bold", "Recipes")} ${c("dim", "(--recipe) \u2014 a whole product in one command")}
+`);
+  for (const r of RECIPES) stdout.write(`  ${c("cyan", r.key.padEnd(14))} ${c("dim", r.description)}
+`);
+  stdout.write(`
+  ${c("dim", "Learn one:")} ${c("cyan", "npx create-lacspace-app explain <name>")}
+
+`);
+}
+function runExplain(rawNames) {
+  const name = rawNames.find((n) => !n.startsWith("-"))?.toLowerCase();
+  if (!name) {
+    stdout.write(`Usage: ${c("cyan", "npx create-lacspace-app explain <template|add-on|recipe>")}
+
+`);
+    runList();
+    return;
+  }
+  const feat = FEATURES.find((f) => f.key === name);
+  const recipe = RECIPES.find((r) => r.key === name);
+  const tmpl = TEMPLATES.find((t) => t.key === name);
+  stdout.write("\n");
+  if (feat) {
+    stdout.write(`${c("bold", c("magenta", "add-on: " + feat.key))} ${feat.requiresBackend ? c("green", "[full-stack]") : c("dim", "[frontend]")}
+
+${feat.description}
+`);
+    const deps = { ...feat.deps, ...feat.backend?.({ name: "app", template: TEMPLATES[0], features: [], mode: "dynamic" })?.deps ?? {} };
+    if (Object.keys(deps).length) stdout.write(`
+${c("bold", "Packages")}: ${Object.keys(deps).map((d) => c("cyan", d)).join(", ")}
+`);
+    stdout.write(`
+${c("bold", "Next steps")}:
+`);
+    for (const s of feat.nextSteps) stdout.write(`  ${c("dim", "\u2022")} ${s}
+`);
+    if (feat.learn) stdout.write(`
+Learn more \u2192 ${c("cyan", feat.learn)}
+`);
+    stdout.write(`
+Add it: ${c("cyan", "npx create-lacspace-app my-app --with " + feat.key)}
+
+`);
+  } else if (recipe) {
+    stdout.write(`${c("bold", c("magenta", "recipe: " + recipe.key))}
+
+${recipe.description}
+
+${c("bold", "Template")}: ${c("cyan", recipe.template)}${recipe.mode ? c("dim", " \xB7 " + recipe.mode) : ""}
+${c("bold", "Add-ons")}: ${recipe.features.map((f) => c("cyan", f)).join(", ")}
+
+Use it: ${c("cyan", "npx create-lacspace-app my-app --recipe " + recipe.key)}
+
+`);
+  } else if (tmpl) {
+    stdout.write(`${c("bold", c("magenta", "template: " + tmpl.key))}
+
+${tmpl.description}
+
+Use it: ${c("cyan", "npx create-lacspace-app my-app --template " + tmpl.key)}
+
+`);
+  } else {
+    stdout.write(c("yellow", `Unknown "${name}".
+`));
+    runList();
+  }
+}
 async function main() {
   const raw = argv.slice(2);
   if (raw[0] === "add") {
     runAdd(raw.slice(1));
     return;
   }
+  if (raw[0] === "list" || raw[0] === "ls") {
+    runList();
+    return;
+  }
+  if (raw[0] === "explain" || raw[0] === "info") {
+    runExplain(raw.slice(1));
+    return;
+  }
   const args = parseArgs(raw);
   if (args.help) {
     stdout.write(HELP + "\n");
@@ -7744,10 +7840,32 @@ ${c("bold", c("magenta", "\u25C6 create-lacspace-app"))} ${c("dim", "\u2014 a go
   let templateKey = args.template ?? recipe?.template;
   let mode = args.mode ?? recipe?.mode ?? "static";
   const featureKeys = [...recipe?.features ?? [], ...args.features];
+  let usedRecipe = Boolean(recipe);
   if (!args.yes && stdin.isTTY) {
     const rl = createInterface({ input: stdin, output: stdout });
     try {
       if (!name) name = (await rl.question(`${c("green", "?")} Project name ${c("dim", "(my-app)")}: `)).trim() || "my-app";
+      if (!usedRecipe && !templateKey && featureKeys.length === 0) {
+        stdout.write(`
+  Start from a recipe? ${c("dim", "(a template + add-ons, ready to go)")}
+`);
+        RECIPES.forEach((r, i) => stdout.write(`   ${c("cyan", String(i + 1))}. ${c("bold", r.label)} ${c("dim", "\u2014 " + r.description)}
+`));
+        stdout.write(`   ${c("cyan", "0")}. ${c("dim", "No recipe \u2014 I'll choose a template myself")}
+`);
+        const ans = (await rl.question(`
+${c("green", "?")} Recipe ${c("dim", "(0)")}: `)).trim() || "0";
+        const idx = /^\d+$/.test(ans) ? parseInt(ans, 10) - 1 : RECIPES.findIndex((r) => r.key === ans);
+        const chosen = ans === "0" ? void 0 : RECIPES[idx];
+        if (chosen) {
+          usedRecipe = true;
+          templateKey = chosen.template;
+          mode = chosen.mode ?? mode;
+          for (const k of chosen.features) if (!featureKeys.includes(k)) featureKeys.push(k);
+          stdout.write(`  ${c("green", "\u2714")} Recipe ${c("cyan", chosen.key)}
+`);
+        }
+      }
       if (!templateKey) {
         stdout.write(`
   Choose a template:
@@ -7759,7 +7877,7 @@ ${c("green", "?")} Template ${c("dim", "(1)")}: `)).trim() || "1";
         const idx = /^\d+$/.test(ans) ? parseInt(ans, 10) - 1 : TEMPLATES.findIndex((t) => t.key === ans);
         templateKey = TEMPLATES[idx]?.key ?? "personal";
       }
-      if (args.mode === void 0 && !recipe) {
+      if (args.mode === void 0 && !usedRecipe) {
         stdout.write(`
   What kind of app?
 `);
@@ -7818,6 +7936,19 @@ ${c("green", "?")} Add features? ${c("dim", "(comma-separated numbers, or Enter
 `);
   }
   const files = buildFiles({ name: projectName, template, features, mode });
+  if (args.dryRun) {
+    const keys = Object.keys(files).sort();
+    stdout.write(`
+  ${c("bold", "Dry run")} ${c("dim", `\u2014 ${keys.length} files (${mode}${features.length ? ", +" + features.map((f) => f.key).join(",") : ""}), nothing written`)}
+`);
+    for (const rel of keys) stdout.write(`    ${c("dim", "+ " + rel)}
+`);
+    stdout.write(`
+  ${c("dim", "Remove --dry-run to create the project.")}
+
+`);
+    return;
+  }
   for (const [rel, content] of Object.entries(files)) {
     const full = join(dir, rel);
     mkdirSync(dirname(full), { recursive: true });

package/dist/lib.cjs

@@ -7221,7 +7221,7 @@ function backendFiles(ctx) {
 }
 var splitList = (s) => s.split(",").map((x) => x.trim()).filter(Boolean);
 function parseArgs(list) {
-  const a = { features: [], yes: false, install: true, git: true, pm: "npm", help: false };
+  const a = { features: [], yes: false, install: true, git: true, pm: "npm", help: false, dryRun: false };
   for (let i = 0; i < list.length; i++) {
     const arg = list[i];
     const next = () => list[++i] ?? "";
@@ -7229,8 +7229,9 @@ function parseArgs(list) {
     else if (arg === "-y" || arg === "--yes") a.yes = true;
     else if (arg === "--no-install") a.install = false;
     else if (arg === "--no-git") a.git = false;
+    else if (arg === "--dry-run" || arg === "--dry") a.dryRun = true;
     else if (arg === "--pm") a.pm = next();
-    else if (arg === "--theme" || arg === "--accent") a.theme = next();
+    else if (arg === "--theme" || arg === "--accent" || arg === "--brand") a.theme = next();
     else if (arg === "--with" || arg === "--features") a.features.push(...splitList(next()));
     else if (arg === "--fullstack" || arg === "--full-stack" || arg === "--dynamic") a.mode = "dynamic";
     else if (arg === "--static") a.mode = "static";
@@ -7246,6 +7247,7 @@ function parseArgs(list) {
     else if (arg.startsWith("--template=")) a.template = arg.slice(11);
     else if (arg.startsWith("--theme=")) a.theme = arg.slice(8);
     else if (arg.startsWith("--accent=")) a.theme = arg.slice(9);
+    else if (arg.startsWith("--brand=")) a.theme = arg.slice(8);
     else if (arg.startsWith("--with=")) a.features.push(...splitList(arg.slice(7)));
     else if (arg.startsWith("--features=")) a.features.push(...splitList(arg.slice(11)));
     else if (!arg.startsWith("-") && !a.name) a.name = arg;
@@ -7336,6 +7338,8 @@ ${c("bold", "Usage")}
   npm create lacspace-app@latest <name> [options]
   npx create-lacspace-app <name> --template <key>
   npx create-lacspace-app add <section...>   ${c("dim", "# grow an existing app")}
+  npx create-lacspace-app list                ${c("dim", "# templates, add-ons & recipes")}
+  npx create-lacspace-app explain <name>      ${c("dim", "# what an add-on/recipe gives you")}
 
 ${c("bold", "Templates")}
 ${TEMPLATES.map((t) => `  ${t.key.padEnd(10)} ${t.description}`).join("\n")}
@@ -7347,8 +7351,9 @@ ${c("bold", "Options")}
                          ${c("dim", "(alias --dynamic; default is --static, a single Next.js app)")}
   --with <a,b>           Feature add-ons, comma-separated (alias --features)
   --recipe <key>         Start from a curated stack (${RECIPES.map((r) => r.key).join(" | ")})
-  --theme <name|hex>     Accent: a preset, a "#hex", or "from,to" (e.g. --theme lacspace)
+  --theme <name|hex>     Accent: a preset, a "#hex", or "from,to" (alias --brand)
   --pm <npm|pnpm|yarn|bun>  Package manager (default npm)
+  --dry-run              Print the files that would be created; write nothing
   --no-install           Skip installing dependencies
   --no-git               Skip git init
   -y, --yes              Accept defaults (needs <name>)
@@ -7724,12 +7729,103 @@ ${c("bold", "Use them")} \u2014 import into any page:
     return;
   }
 }
+function runList() {
+  process$1.stdout.write(`
+${c("bold", c("magenta", "\u25C6 create-lacspace-app"))} ${c("dim", "\u2014 what you can build")}
+`);
+  process$1.stdout.write(`
+${c("bold", "Templates")} ${c("dim", "(-t / --template)")}
+`);
+  for (const t of TEMPLATES) process$1.stdout.write(`  ${c("cyan", t.key.padEnd(12))} ${c("dim", t.description)}
+`);
+  process$1.stdout.write(`
+${c("bold", "Add-ons")} ${c("dim", "(--with) \u2014 free & keyless")}
+`);
+  for (const f of FEATURES) process$1.stdout.write(`  ${c("cyan", f.key.padEnd(12))} ${c("dim", f.description)}${f.requiresBackend ? c("green", "  [full-stack]") : ""}
+`);
+  process$1.stdout.write(`
+${c("bold", "Recipes")} ${c("dim", "(--recipe) \u2014 a whole product in one command")}
+`);
+  for (const r of RECIPES) process$1.stdout.write(`  ${c("cyan", r.key.padEnd(14))} ${c("dim", r.description)}
+`);
+  process$1.stdout.write(`
+  ${c("dim", "Learn one:")} ${c("cyan", "npx create-lacspace-app explain <name>")}
+
+`);
+}
+function runExplain(rawNames) {
+  const name = rawNames.find((n) => !n.startsWith("-"))?.toLowerCase();
+  if (!name) {
+    process$1.stdout.write(`Usage: ${c("cyan", "npx create-lacspace-app explain <template|add-on|recipe>")}
+
+`);
+    runList();
+    return;
+  }
+  const feat = FEATURES.find((f) => f.key === name);
+  const recipe = RECIPES.find((r) => r.key === name);
+  const tmpl = TEMPLATES.find((t) => t.key === name);
+  process$1.stdout.write("\n");
+  if (feat) {
+    process$1.stdout.write(`${c("bold", c("magenta", "add-on: " + feat.key))} ${feat.requiresBackend ? c("green", "[full-stack]") : c("dim", "[frontend]")}
+
+${feat.description}
+`);
+    const deps = { ...feat.deps, ...feat.backend?.({ name: "app", template: TEMPLATES[0], features: [], mode: "dynamic" })?.deps ?? {} };
+    if (Object.keys(deps).length) process$1.stdout.write(`
+${c("bold", "Packages")}: ${Object.keys(deps).map((d) => c("cyan", d)).join(", ")}
+`);
+    process$1.stdout.write(`
+${c("bold", "Next steps")}:
+`);
+    for (const s of feat.nextSteps) process$1.stdout.write(`  ${c("dim", "\u2022")} ${s}
+`);
+    if (feat.learn) process$1.stdout.write(`
+Learn more \u2192 ${c("cyan", feat.learn)}
+`);
+    process$1.stdout.write(`
+Add it: ${c("cyan", "npx create-lacspace-app my-app --with " + feat.key)}
+
+`);
+  } else if (recipe) {
+    process$1.stdout.write(`${c("bold", c("magenta", "recipe: " + recipe.key))}
+
+${recipe.description}
+
+${c("bold", "Template")}: ${c("cyan", recipe.template)}${recipe.mode ? c("dim", " \xB7 " + recipe.mode) : ""}
+${c("bold", "Add-ons")}: ${recipe.features.map((f) => c("cyan", f)).join(", ")}
+
+Use it: ${c("cyan", "npx create-lacspace-app my-app --recipe " + recipe.key)}
+
+`);
+  } else if (tmpl) {
+    process$1.stdout.write(`${c("bold", c("magenta", "template: " + tmpl.key))}
+
+${tmpl.description}
+
+Use it: ${c("cyan", "npx create-lacspace-app my-app --template " + tmpl.key)}
+
+`);
+  } else {
+    process$1.stdout.write(c("yellow", `Unknown "${name}".
+`));
+    runList();
+  }
+}
 async function main() {
   const raw = process$1.argv.slice(2);
   if (raw[0] === "add") {
     runAdd(raw.slice(1));
     return;
   }
+  if (raw[0] === "list" || raw[0] === "ls") {
+    runList();
+    return;
+  }
+  if (raw[0] === "explain" || raw[0] === "info") {
+    runExplain(raw.slice(1));
+    return;
+  }
   const args = parseArgs(raw);
   if (args.help) {
     process$1.stdout.write(HELP + "\n");
@@ -7748,10 +7844,32 @@ ${c("bold", c("magenta", "\u25C6 create-lacspace-app"))} ${c("dim", "\u2014 a go
   let templateKey = args.template ?? recipe?.template;
   let mode = args.mode ?? recipe?.mode ?? "static";
   const featureKeys = [...recipe?.features ?? [], ...args.features];
+  let usedRecipe = Boolean(recipe);
   if (!args.yes && process$1.stdin.isTTY) {
     const rl = promises.createInterface({ input: process$1.stdin, output: process$1.stdout });
     try {
       if (!name) name = (await rl.question(`${c("green", "?")} Project name ${c("dim", "(my-app)")}: `)).trim() || "my-app";
+      if (!usedRecipe && !templateKey && featureKeys.length === 0) {
+        process$1.stdout.write(`
+  Start from a recipe? ${c("dim", "(a template + add-ons, ready to go)")}
+`);
+        RECIPES.forEach((r, i) => process$1.stdout.write(`   ${c("cyan", String(i + 1))}. ${c("bold", r.label)} ${c("dim", "\u2014 " + r.description)}
+`));
+        process$1.stdout.write(`   ${c("cyan", "0")}. ${c("dim", "No recipe \u2014 I'll choose a template myself")}
+`);
+        const ans = (await rl.question(`
+${c("green", "?")} Recipe ${c("dim", "(0)")}: `)).trim() || "0";
+        const idx = /^\d+$/.test(ans) ? parseInt(ans, 10) - 1 : RECIPES.findIndex((r) => r.key === ans);
+        const chosen = ans === "0" ? void 0 : RECIPES[idx];
+        if (chosen) {
+          usedRecipe = true;
+          templateKey = chosen.template;
+          mode = chosen.mode ?? mode;
+          for (const k of chosen.features) if (!featureKeys.includes(k)) featureKeys.push(k);
+          process$1.stdout.write(`  ${c("green", "\u2714")} Recipe ${c("cyan", chosen.key)}
+`);
+        }
+      }
       if (!templateKey) {
         process$1.stdout.write(`
   Choose a template:
@@ -7763,7 +7881,7 @@ ${c("green", "?")} Template ${c("dim", "(1)")}: `)).trim() || "1";
         const idx = /^\d+$/.test(ans) ? parseInt(ans, 10) - 1 : TEMPLATES.findIndex((t) => t.key === ans);
         templateKey = TEMPLATES[idx]?.key ?? "personal";
       }
-      if (args.mode === void 0 && !recipe) {
+      if (args.mode === void 0 && !usedRecipe) {
         process$1.stdout.write(`
   What kind of app?
 `);
@@ -7822,6 +7940,19 @@ ${c("green", "?")} Add features? ${c("dim", "(comma-separated numbers, or Enter
 `);
   }
   const files = buildFiles({ name: projectName, template, features, mode });
+  if (args.dryRun) {
+    const keys = Object.keys(files).sort();
+    process$1.stdout.write(`
+  ${c("bold", "Dry run")} ${c("dim", `\u2014 ${keys.length} files (${mode}${features.length ? ", +" + features.map((f) => f.key).join(",") : ""}), nothing written`)}
+`);
+    for (const rel of keys) process$1.stdout.write(`    ${c("dim", "+ " + rel)}
+`);
+    process$1.stdout.write(`
+  ${c("dim", "Remove --dry-run to create the project.")}
+
+`);
+    return;
+  }
   for (const [rel, content] of Object.entries(files)) {
     const full = path.join(dir, rel);
     fs.mkdirSync(path.dirname(full), { recursive: true });

package/dist/lib.js

@@ -7218,7 +7218,7 @@ function backendFiles(ctx) {
 }
 var splitList = (s) => s.split(",").map((x) => x.trim()).filter(Boolean);
 function parseArgs(list) {
-  const a = { features: [], yes: false, install: true, git: true, pm: "npm", help: false };
+  const a = { features: [], yes: false, install: true, git: true, pm: "npm", help: false, dryRun: false };
   for (let i = 0; i < list.length; i++) {
     const arg = list[i];
     const next = () => list[++i] ?? "";
@@ -7226,8 +7226,9 @@ function parseArgs(list) {
     else if (arg === "-y" || arg === "--yes") a.yes = true;
     else if (arg === "--no-install") a.install = false;
     else if (arg === "--no-git") a.git = false;
+    else if (arg === "--dry-run" || arg === "--dry") a.dryRun = true;
     else if (arg === "--pm") a.pm = next();
-    else if (arg === "--theme" || arg === "--accent") a.theme = next();
+    else if (arg === "--theme" || arg === "--accent" || arg === "--brand") a.theme = next();
     else if (arg === "--with" || arg === "--features") a.features.push(...splitList(next()));
     else if (arg === "--fullstack" || arg === "--full-stack" || arg === "--dynamic") a.mode = "dynamic";
     else if (arg === "--static") a.mode = "static";
@@ -7243,6 +7244,7 @@ function parseArgs(list) {
     else if (arg.startsWith("--template=")) a.template = arg.slice(11);
     else if (arg.startsWith("--theme=")) a.theme = arg.slice(8);
     else if (arg.startsWith("--accent=")) a.theme = arg.slice(9);
+    else if (arg.startsWith("--brand=")) a.theme = arg.slice(8);
     else if (arg.startsWith("--with=")) a.features.push(...splitList(arg.slice(7)));
     else if (arg.startsWith("--features=")) a.features.push(...splitList(arg.slice(11)));
     else if (!arg.startsWith("-") && !a.name) a.name = arg;
@@ -7333,6 +7335,8 @@ ${c("bold", "Usage")}
   npm create lacspace-app@latest <name> [options]
   npx create-lacspace-app <name> --template <key>
   npx create-lacspace-app add <section...>   ${c("dim", "# grow an existing app")}
+  npx create-lacspace-app list                ${c("dim", "# templates, add-ons & recipes")}
+  npx create-lacspace-app explain <name>      ${c("dim", "# what an add-on/recipe gives you")}
 
 ${c("bold", "Templates")}
 ${TEMPLATES.map((t) => `  ${t.key.padEnd(10)} ${t.description}`).join("\n")}
@@ -7344,8 +7348,9 @@ ${c("bold", "Options")}
                          ${c("dim", "(alias --dynamic; default is --static, a single Next.js app)")}
   --with <a,b>           Feature add-ons, comma-separated (alias --features)
   --recipe <key>         Start from a curated stack (${RECIPES.map((r) => r.key).join(" | ")})
-  --theme <name|hex>     Accent: a preset, a "#hex", or "from,to" (e.g. --theme lacspace)
+  --theme <name|hex>     Accent: a preset, a "#hex", or "from,to" (alias --brand)
   --pm <npm|pnpm|yarn|bun>  Package manager (default npm)
+  --dry-run              Print the files that would be created; write nothing
   --no-install           Skip installing dependencies
   --no-git               Skip git init
   -y, --yes              Accept defaults (needs <name>)
@@ -7721,12 +7726,103 @@ ${c("bold", "Use them")} \u2014 import into any page:
     return;
   }
 }
+function runList() {
+  stdout.write(`
+${c("bold", c("magenta", "\u25C6 create-lacspace-app"))} ${c("dim", "\u2014 what you can build")}
+`);
+  stdout.write(`
+${c("bold", "Templates")} ${c("dim", "(-t / --template)")}
+`);
+  for (const t of TEMPLATES) stdout.write(`  ${c("cyan", t.key.padEnd(12))} ${c("dim", t.description)}
+`);
+  stdout.write(`
+${c("bold", "Add-ons")} ${c("dim", "(--with) \u2014 free & keyless")}
+`);
+  for (const f of FEATURES) stdout.write(`  ${c("cyan", f.key.padEnd(12))} ${c("dim", f.description)}${f.requiresBackend ? c("green", "  [full-stack]") : ""}
+`);
+  stdout.write(`
+${c("bold", "Recipes")} ${c("dim", "(--recipe) \u2014 a whole product in one command")}
+`);
+  for (const r of RECIPES) stdout.write(`  ${c("cyan", r.key.padEnd(14))} ${c("dim", r.description)}
+`);
+  stdout.write(`
+  ${c("dim", "Learn one:")} ${c("cyan", "npx create-lacspace-app explain <name>")}
+
+`);
+}
+function runExplain(rawNames) {
+  const name = rawNames.find((n) => !n.startsWith("-"))?.toLowerCase();
+  if (!name) {
+    stdout.write(`Usage: ${c("cyan", "npx create-lacspace-app explain <template|add-on|recipe>")}
+
+`);
+    runList();
+    return;
+  }
+  const feat = FEATURES.find((f) => f.key === name);
+  const recipe = RECIPES.find((r) => r.key === name);
+  const tmpl = TEMPLATES.find((t) => t.key === name);
+  stdout.write("\n");
+  if (feat) {
+    stdout.write(`${c("bold", c("magenta", "add-on: " + feat.key))} ${feat.requiresBackend ? c("green", "[full-stack]") : c("dim", "[frontend]")}
+
+${feat.description}
+`);
+    const deps = { ...feat.deps, ...feat.backend?.({ name: "app", template: TEMPLATES[0], features: [], mode: "dynamic" })?.deps ?? {} };
+    if (Object.keys(deps).length) stdout.write(`
+${c("bold", "Packages")}: ${Object.keys(deps).map((d) => c("cyan", d)).join(", ")}
+`);
+    stdout.write(`
+${c("bold", "Next steps")}:
+`);
+    for (const s of feat.nextSteps) stdout.write(`  ${c("dim", "\u2022")} ${s}
+`);
+    if (feat.learn) stdout.write(`
+Learn more \u2192 ${c("cyan", feat.learn)}
+`);
+    stdout.write(`
+Add it: ${c("cyan", "npx create-lacspace-app my-app --with " + feat.key)}
+
+`);
+  } else if (recipe) {
+    stdout.write(`${c("bold", c("magenta", "recipe: " + recipe.key))}
+
+${recipe.description}
+
+${c("bold", "Template")}: ${c("cyan", recipe.template)}${recipe.mode ? c("dim", " \xB7 " + recipe.mode) : ""}
+${c("bold", "Add-ons")}: ${recipe.features.map((f) => c("cyan", f)).join(", ")}
+
+Use it: ${c("cyan", "npx create-lacspace-app my-app --recipe " + recipe.key)}
+
+`);
+  } else if (tmpl) {
+    stdout.write(`${c("bold", c("magenta", "template: " + tmpl.key))}
+
+${tmpl.description}
+
+Use it: ${c("cyan", "npx create-lacspace-app my-app --template " + tmpl.key)}
+
+`);
+  } else {
+    stdout.write(c("yellow", `Unknown "${name}".
+`));
+    runList();
+  }
+}
 async function main() {
   const raw = argv.slice(2);
   if (raw[0] === "add") {
     runAdd(raw.slice(1));
     return;
   }
+  if (raw[0] === "list" || raw[0] === "ls") {
+    runList();
+    return;
+  }
+  if (raw[0] === "explain" || raw[0] === "info") {
+    runExplain(raw.slice(1));
+    return;
+  }
   const args = parseArgs(raw);
   if (args.help) {
     stdout.write(HELP + "\n");
@@ -7745,10 +7841,32 @@ ${c("bold", c("magenta", "\u25C6 create-lacspace-app"))} ${c("dim", "\u2014 a go
   let templateKey = args.template ?? recipe?.template;
   let mode = args.mode ?? recipe?.mode ?? "static";
   const featureKeys = [...recipe?.features ?? [], ...args.features];
+  let usedRecipe = Boolean(recipe);
   if (!args.yes && stdin.isTTY) {
     const rl = createInterface({ input: stdin, output: stdout });
     try {
       if (!name) name = (await rl.question(`${c("green", "?")} Project name ${c("dim", "(my-app)")}: `)).trim() || "my-app";
+      if (!usedRecipe && !templateKey && featureKeys.length === 0) {
+        stdout.write(`
+  Start from a recipe? ${c("dim", "(a template + add-ons, ready to go)")}
+`);
+        RECIPES.forEach((r, i) => stdout.write(`   ${c("cyan", String(i + 1))}. ${c("bold", r.label)} ${c("dim", "\u2014 " + r.description)}
+`));
+        stdout.write(`   ${c("cyan", "0")}. ${c("dim", "No recipe \u2014 I'll choose a template myself")}
+`);
+        const ans = (await rl.question(`
+${c("green", "?")} Recipe ${c("dim", "(0)")}: `)).trim() || "0";
+        const idx = /^\d+$/.test(ans) ? parseInt(ans, 10) - 1 : RECIPES.findIndex((r) => r.key === ans);
+        const chosen = ans === "0" ? void 0 : RECIPES[idx];
+        if (chosen) {
+          usedRecipe = true;
+          templateKey = chosen.template;
+          mode = chosen.mode ?? mode;
+          for (const k of chosen.features) if (!featureKeys.includes(k)) featureKeys.push(k);
+          stdout.write(`  ${c("green", "\u2714")} Recipe ${c("cyan", chosen.key)}
+`);
+        }
+      }
       if (!templateKey) {
         stdout.write(`
   Choose a template:
@@ -7760,7 +7878,7 @@ ${c("green", "?")} Template ${c("dim", "(1)")}: `)).trim() || "1";
         const idx = /^\d+$/.test(ans) ? parseInt(ans, 10) - 1 : TEMPLATES.findIndex((t) => t.key === ans);
         templateKey = TEMPLATES[idx]?.key ?? "personal";
       }
-      if (args.mode === void 0 && !recipe) {
+      if (args.mode === void 0 && !usedRecipe) {
         stdout.write(`
   What kind of app?
 `);
@@ -7819,6 +7937,19 @@ ${c("green", "?")} Add features? ${c("dim", "(comma-separated numbers, or Enter
 `);
   }
   const files = buildFiles({ name: projectName, template, features, mode });
+  if (args.dryRun) {
+    const keys = Object.keys(files).sort();
+    stdout.write(`
+  ${c("bold", "Dry run")} ${c("dim", `\u2014 ${keys.length} files (${mode}${features.length ? ", +" + features.map((f) => f.key).join(",") : ""}), nothing written`)}
+`);
+    for (const rel of keys) stdout.write(`    ${c("dim", "+ " + rel)}
+`);
+    stdout.write(`
+  ${c("dim", "Remove --dry-run to create the project.")}
+
+`);
+    return;
+  }
   for (const [rel, content] of Object.entries(files)) {
     const full = join(dir, rel);
     mkdirSync(dirname(full), { recursive: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-lacspace-app",
-  "version": "2.8.0",
+  "version": "2.9.0",
   "description": "Scaffold a beautiful, production-ready Next.js app from a Lacspace template — portfolio, business, e-commerce, SaaS, blog, docs, dashboard, restaurant or marketplace — pre-wired with SEO, security headers, sitemap and robots. Use it as a CLI (like create-next-app, but you start gorgeous) or import it as a library to generate projects programmatically.",
   "type": "module",
   "bin": {