create-lacspace-app 2.7.0 → 2.8.0

package/README.md

@@ -20,6 +20,13 @@ 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.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
+> - **`blog`** → blog + content + search · **`docs-ai`** → docs + RAG + search · **`internal-tool`** → dashboard + auth + analytics + email
+>
+> `npx create-lacspace-app my-app --recipe ai-saas`. Explicit `--template`/`--with`/`--fullstack` still merge on top. Also on the lib API: `listRecipes()` / `getRecipe()`.
+
 > **New in v2.7 — payments & email add-ons.**
 > - **`payments`** — a checkout wired to **eSewa & Khalti**: orders, integer-safe money (`@lacspace/money`), and the signed eSewa flow that **works end-to-end in test mode with NO credentials**. Khalti activates when you add `KHALTI_SECRET`.
 > - **`email`** — transactional email: a ready mail service (`@lacspace/mailer`) with beautiful templates (`@lacspace/email-templates`) + address validation. **Logs emails to the console until you add SMTP** — so it runs out-of-the-box, then delivers for real with one env change.

package/dist/index.js

@@ -29,14 +29,15 @@ var TEMPLATES = [
   { key: "marketplace", label: "Marketplace / commerce", description: "A real storefront wired to the Lacspace commerce packages \u2014 cart, checkout, tax, shipping, orders, invoices and Nepal payments.", accent: ["#0d9488", "#6366f1"], siteName: "LSBazaar", siteDescription: "A modern storefront \u2014 cart to checkout, wired end to end." }
 ];
 function resolveContext(options = {}) {
-  const base = TEMPLATES.find((t) => t.key === options.template) ?? TEMPLATES[0];
+  const recipe = options.recipe ? RECIPES.find((r) => r.key === String(options.recipe).toLowerCase()) : void 0;
+  const base = TEMPLATES.find((t) => t.key === (options.template ?? recipe?.template)) ?? TEMPLATES[0];
   const accent = resolveAccent(options.theme);
   const template = accent ? { ...base, accent } : base;
   const raw = options.name ?? "my-app";
   const seg = raw.split(/[\\/]/).filter(Boolean).pop() ?? "my-app";
   const name = seg.toLowerCase().replace(/[^a-z0-9-_]/g, "-").replace(/^-+|-+$/g, "") || "my-app";
-  const features = normalizeFeatures(options.features);
-  let mode = options.mode === "dynamic" ? "dynamic" : "static";
+  const features = normalizeFeatures([...recipe?.features ?? [], ...options.features ?? []]);
+  let mode = options.mode === "dynamic" ? "dynamic" : options.mode === "static" ? "static" : recipe?.mode ?? "static";
   if (mode === "static" && features.some((f) => f.requiresBackend)) mode = "dynamic";
   return { name, template, features, mode };
 }
@@ -5252,6 +5253,13 @@ var faqSection = (ctx) => {
         </div>
       </section>`;
 };
+var RECIPES = [
+  { key: "ai-saas", label: "AI SaaS", description: "SaaS landing + accounts + payments + a streaming AI chat + analytics.", template: "saas", mode: "dynamic", features: ["auth-pages", "payments", "ai-chat", "analytics"] },
+  { key: "store", label: "Online store", description: "E-commerce storefront + eSewa/Khalti checkout + transactional email + analytics.", template: "ecommerce", mode: "dynamic", features: ["payments", "email", "analytics"] },
+  { key: "blog", label: "Blog", description: "A blog with a Markdown content section, RSS/llms.txt and instant search.", template: "blog", features: ["content", "search"] },
+  { key: "internal-tool", label: "Internal tool", description: "An admin dashboard with accounts (2FA), analytics and email \u2014 full-stack.", template: "dashboard", mode: "dynamic", features: ["auth-pages", "analytics", "email"] },
+  { key: "docs-ai", label: "AI docs", description: "A documentation site with chat-with-your-docs RAG and instant search.", template: "docs", features: ["rag", "search"] }
+];
 var contentLib = () => `import fs from "node:fs";
 import path from "node:path";
 import { parseFrontmatter, markdownToHtml, excerpt } from "@lacspace/markdown";
@@ -7228,7 +7236,9 @@ function parseArgs(list) {
     } else if (arg.startsWith("--mode=")) {
       const m = arg.slice(7).toLowerCase();
       a.mode = m === "dynamic" ? "dynamic" : "static";
-    } else if (arg === "-h" || arg === "--help") a.help = true;
+    } else if (arg === "--recipe") a.recipe = next();
+    else if (arg.startsWith("--recipe=")) a.recipe = arg.slice(9);
+    else if (arg === "-h" || arg === "--help") a.help = true;
     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);
@@ -7332,6 +7342,7 @@ ${c("bold", "Options")}
                          MongoDB/Redis backend (JWT auth + CRUD) + shared types
                          ${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)
   --pm <npm|pnpm|yarn|bun>  Package manager (default npm)
   --no-install           Skip installing dependencies
@@ -7340,9 +7351,13 @@ ${c("bold", "Options")}
   -h, --help             Show this help
 
 ${c("bold", "Feature add-ons")} ${c("dim", "(--with) \u2014 free & keyless, local by default")}
-${FEATURES.map((f) => `  ${f.key.padEnd(10)} ${f.description}`).join("\n")}
+${FEATURES.map((f) => `  ${f.key.padEnd(11)} ${f.description}`).join("\n")}
   ${c("dim", "e.g. npx create-lacspace-app my-app --template saas --with ai-chat,rag")}
 
+${c("bold", "Recipes")} ${c("dim", "(--recipe) \u2014 a whole product in one command")}
+${RECIPES.map((r) => `  ${r.key.padEnd(14)} ${r.description}`).join("\n")}
+  ${c("dim", "e.g. npx create-lacspace-app my-app --recipe ai-saas")}
+
 ${c("bold", "Themes")} ${c("dim", "(--theme)")}
   ${Object.keys(THEMES).join(" \xB7 ")}
   ${c("dim", 'or a custom colour: --theme "#ff6a00"  \xB7  --theme "#0bb9d9,#7c3aed"')}
@@ -7719,11 +7734,16 @@ async function main() {
   stdout.write(`
 ${c("bold", c("magenta", "\u25C6 create-lacspace-app"))} ${c("dim", "\u2014 a gorgeous Next.js starter, batteries wired")}
 
+`);
+  const recipe = args.recipe ? RECIPES.find((r) => r.key === args.recipe.toLowerCase()) : void 0;
+  if (args.recipe && !recipe) stdout.write(c("yellow", `  ! Unknown recipe "${args.recipe}" \u2014 ignoring. Try: ${RECIPES.map((r) => r.key).join(", ")}
+`));
+  if (recipe) stdout.write(`  ${c("green", "\u2714")} Recipe ${c("cyan", recipe.key)} ${c("dim", "\u2014 " + recipe.description)}
 `);
   let name = args.name;
-  let templateKey = args.template;
-  let mode = args.mode ?? "static";
-  const featureKeys = [...args.features];
+  let templateKey = args.template ?? recipe?.template;
+  let mode = args.mode ?? recipe?.mode ?? "static";
+  const featureKeys = [...recipe?.features ?? [], ...args.features];
   if (!args.yes && stdin.isTTY) {
     const rl = createInterface({ input: stdin, output: stdout });
     try {
@@ -7739,7 +7759,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) {
+      if (args.mode === void 0 && !recipe) {
         stdout.write(`
   What kind of app?
 `);
@@ -7792,6 +7812,11 @@ ${c("green", "?")} Add features? ${c("dim", "(comma-separated numbers, or Enter
     return;
   }
   const features = normalizeFeatures(featureKeys);
+  if (mode === "static" && features.some((f) => f.requiresBackend)) {
+    mode = "dynamic";
+    stdout.write(`  ${c("dim", "\u2191 a selected add-on needs a backend \u2014 building full-stack")}
+`);
+  }
   const files = buildFiles({ name: projectName, template, features, mode });
   for (const [rel, content] of Object.entries(files)) {
     const full = join(dir, rel);
@@ -7880,4 +7905,4 @@ if (invokedAsCli) {
   });
 }
 
-export { FEATURES, SECTIONS, TEMPLATES, applyFeatures, buildFiles, normalizeFeatures, resolveContext };
+export { FEATURES, RECIPES, SECTIONS, TEMPLATES, applyFeatures, buildFiles, normalizeFeatures, resolveContext };

package/dist/lib.cjs

@@ -33,14 +33,15 @@ var TEMPLATES = [
   { key: "marketplace", label: "Marketplace / commerce", description: "A real storefront wired to the Lacspace commerce packages \u2014 cart, checkout, tax, shipping, orders, invoices and Nepal payments.", accent: ["#0d9488", "#6366f1"], siteName: "LSBazaar", siteDescription: "A modern storefront \u2014 cart to checkout, wired end to end." }
 ];
 function resolveContext(options = {}) {
-  const base = TEMPLATES.find((t) => t.key === options.template) ?? TEMPLATES[0];
+  const recipe = options.recipe ? RECIPES.find((r) => r.key === String(options.recipe).toLowerCase()) : void 0;
+  const base = TEMPLATES.find((t) => t.key === (options.template ?? recipe?.template)) ?? TEMPLATES[0];
   const accent = resolveAccent(options.theme);
   const template = accent ? { ...base, accent } : base;
   const raw = options.name ?? "my-app";
   const seg = raw.split(/[\\/]/).filter(Boolean).pop() ?? "my-app";
   const name = seg.toLowerCase().replace(/[^a-z0-9-_]/g, "-").replace(/^-+|-+$/g, "") || "my-app";
-  const features = normalizeFeatures(options.features);
-  let mode = options.mode === "dynamic" ? "dynamic" : "static";
+  const features = normalizeFeatures([...recipe?.features ?? [], ...options.features ?? []]);
+  let mode = options.mode === "dynamic" ? "dynamic" : options.mode === "static" ? "static" : recipe?.mode ?? "static";
   if (mode === "static" && features.some((f) => f.requiresBackend)) mode = "dynamic";
   return { name, template, features, mode };
 }
@@ -5256,6 +5257,13 @@ var faqSection = (ctx) => {
         </div>
       </section>`;
 };
+var RECIPES = [
+  { key: "ai-saas", label: "AI SaaS", description: "SaaS landing + accounts + payments + a streaming AI chat + analytics.", template: "saas", mode: "dynamic", features: ["auth-pages", "payments", "ai-chat", "analytics"] },
+  { key: "store", label: "Online store", description: "E-commerce storefront + eSewa/Khalti checkout + transactional email + analytics.", template: "ecommerce", mode: "dynamic", features: ["payments", "email", "analytics"] },
+  { key: "blog", label: "Blog", description: "A blog with a Markdown content section, RSS/llms.txt and instant search.", template: "blog", features: ["content", "search"] },
+  { key: "internal-tool", label: "Internal tool", description: "An admin dashboard with accounts (2FA), analytics and email \u2014 full-stack.", template: "dashboard", mode: "dynamic", features: ["auth-pages", "analytics", "email"] },
+  { key: "docs-ai", label: "AI docs", description: "A documentation site with chat-with-your-docs RAG and instant search.", template: "docs", features: ["rag", "search"] }
+];
 var contentLib = () => `import fs from "node:fs";
 import path from "node:path";
 import { parseFrontmatter, markdownToHtml, excerpt } from "@lacspace/markdown";
@@ -7232,7 +7240,9 @@ function parseArgs(list) {
     } else if (arg.startsWith("--mode=")) {
       const m = arg.slice(7).toLowerCase();
       a.mode = m === "dynamic" ? "dynamic" : "static";
-    } else if (arg === "-h" || arg === "--help") a.help = true;
+    } else if (arg === "--recipe") a.recipe = next();
+    else if (arg.startsWith("--recipe=")) a.recipe = arg.slice(9);
+    else if (arg === "-h" || arg === "--help") a.help = true;
     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);
@@ -7336,6 +7346,7 @@ ${c("bold", "Options")}
                          MongoDB/Redis backend (JWT auth + CRUD) + shared types
                          ${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)
   --pm <npm|pnpm|yarn|bun>  Package manager (default npm)
   --no-install           Skip installing dependencies
@@ -7344,9 +7355,13 @@ ${c("bold", "Options")}
   -h, --help             Show this help
 
 ${c("bold", "Feature add-ons")} ${c("dim", "(--with) \u2014 free & keyless, local by default")}
-${FEATURES.map((f) => `  ${f.key.padEnd(10)} ${f.description}`).join("\n")}
+${FEATURES.map((f) => `  ${f.key.padEnd(11)} ${f.description}`).join("\n")}
   ${c("dim", "e.g. npx create-lacspace-app my-app --template saas --with ai-chat,rag")}
 
+${c("bold", "Recipes")} ${c("dim", "(--recipe) \u2014 a whole product in one command")}
+${RECIPES.map((r) => `  ${r.key.padEnd(14)} ${r.description}`).join("\n")}
+  ${c("dim", "e.g. npx create-lacspace-app my-app --recipe ai-saas")}
+
 ${c("bold", "Themes")} ${c("dim", "(--theme)")}
   ${Object.keys(THEMES).join(" \xB7 ")}
   ${c("dim", 'or a custom colour: --theme "#ff6a00"  \xB7  --theme "#0bb9d9,#7c3aed"')}
@@ -7723,11 +7738,16 @@ async function main() {
   process$1.stdout.write(`
 ${c("bold", c("magenta", "\u25C6 create-lacspace-app"))} ${c("dim", "\u2014 a gorgeous Next.js starter, batteries wired")}
 
+`);
+  const recipe = args.recipe ? RECIPES.find((r) => r.key === args.recipe.toLowerCase()) : void 0;
+  if (args.recipe && !recipe) process$1.stdout.write(c("yellow", `  ! Unknown recipe "${args.recipe}" \u2014 ignoring. Try: ${RECIPES.map((r) => r.key).join(", ")}
+`));
+  if (recipe) process$1.stdout.write(`  ${c("green", "\u2714")} Recipe ${c("cyan", recipe.key)} ${c("dim", "\u2014 " + recipe.description)}
 `);
   let name = args.name;
-  let templateKey = args.template;
-  let mode = args.mode ?? "static";
-  const featureKeys = [...args.features];
+  let templateKey = args.template ?? recipe?.template;
+  let mode = args.mode ?? recipe?.mode ?? "static";
+  const featureKeys = [...recipe?.features ?? [], ...args.features];
   if (!args.yes && process$1.stdin.isTTY) {
     const rl = promises.createInterface({ input: process$1.stdin, output: process$1.stdout });
     try {
@@ -7743,7 +7763,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) {
+      if (args.mode === void 0 && !recipe) {
         process$1.stdout.write(`
   What kind of app?
 `);
@@ -7796,6 +7816,11 @@ ${c("green", "?")} Add features? ${c("dim", "(comma-separated numbers, or Enter
     return;
   }
   const features = normalizeFeatures(featureKeys);
+  if (mode === "static" && features.some((f) => f.requiresBackend)) {
+    mode = "dynamic";
+    process$1.stdout.write(`  ${c("dim", "\u2191 a selected add-on needs a backend \u2014 building full-stack")}
+`);
+  }
   const files = buildFiles({ name: projectName, template, features, mode });
   for (const [rel, content] of Object.entries(files)) {
     const full = path.join(dir, rel);
@@ -7907,6 +7932,13 @@ function getFeature(key) {
   const f = FEATURES.find((x) => x.key === key);
   return f ? { ...f } : void 0;
 }
+function listRecipes() {
+  return RECIPES.map((r) => ({ ...r, features: [...r.features] }));
+}
+function getRecipe(key) {
+  const r = RECIPES.find((x) => x.key === key);
+  return r ? { ...r, features: [...r.features] } : void 0;
+}
 function generateProject(options = {}) {
   return buildFiles(resolveContext(options));
 }
@@ -7924,9 +7956,11 @@ async function scaffold(options = {}) {
 
 exports.generateProject = generateProject;
 exports.getFeature = getFeature;
+exports.getRecipe = getRecipe;
 exports.getSection = getSection;
 exports.getTemplate = getTemplate;
 exports.listFeatures = listFeatures;
+exports.listRecipes = listRecipes;
 exports.listSections = listSections;
 exports.listTemplates = listTemplates;
 exports.scaffold = scaffold;

package/dist/lib.d.cts

@@ -104,6 +104,28 @@ interface GenerateOptions {
      * changes.
      */
     mode?: "static" | "dynamic";
+    /**
+     * A one-shot **recipe** (see {@link RECIPES}) — a curated bundle of template +
+     * mode + feature add-ons for a whole kind of product, e.g. `"ai-saas"` or
+     * `"store"`. Explicit `template`/`features`/`mode` still win and are merged on
+     * top. Omit for no recipe.
+     */
+    recipe?: string;
+}
+/**
+ * A one-command **recipe**: a curated template + mode + add-on stack for a whole
+ * kind of product. `npx create-lacspace-app my-app --recipe ai-saas`.
+ */
+interface RecipeDef {
+    key: string;
+    label: string;
+    description: string;
+    /** The template this recipe starts from. */
+    template: string;
+    /** Force full-stack when the stack needs a backend (add-ons can also force it). */
+    mode?: "static" | "dynamic";
+    /** The add-ons this recipe layers on. */
+    features: string[];
 }
 
 /** A project file map: relative path → file contents. */
@@ -131,6 +153,13 @@ declare function getSection(name: string): string | undefined;
 declare function listFeatures(): FeatureDef[];
 /** Look up one feature add-on's definition by key, or `undefined`. */
 declare function getFeature(key: string): FeatureDef | undefined;
+/**
+ * The built-in one-shot recipes (see {@link RecipeDef}) — curated template + mode +
+ * add-on bundles you can pass as `options.recipe` or request with `--recipe <key>`.
+ */
+declare function listRecipes(): RecipeDef[];
+/** Look up one recipe's definition by key, or `undefined`. */
+declare function getRecipe(key: string): RecipeDef | undefined;
 /**
  * Generate a full project as an in-memory file map (relative path → contents).
  *
@@ -162,4 +191,4 @@ interface ScaffoldResult {
  */
 declare function scaffold(options?: ScaffoldOptions): Promise<ScaffoldResult>;
 
-export { type FeatureBackend, type FeatureDef, type FeatureRoute, type GenerateOptions, type ProjectFiles, type ScaffoldOptions, type ScaffoldResult, type TemplateDef, generateProject, getFeature, getSection, getTemplate, listFeatures, listSections, listTemplates, scaffold, templateKeys, templates };
+export { type FeatureBackend, type FeatureDef, type FeatureRoute, type GenerateOptions, type ProjectFiles, type RecipeDef, type ScaffoldOptions, type ScaffoldResult, type TemplateDef, generateProject, getFeature, getRecipe, getSection, getTemplate, listFeatures, listRecipes, listSections, listTemplates, scaffold, templateKeys, templates };

package/dist/lib.d.ts

@@ -104,6 +104,28 @@ interface GenerateOptions {
      * changes.
      */
     mode?: "static" | "dynamic";
+    /**
+     * A one-shot **recipe** (see {@link RECIPES}) — a curated bundle of template +
+     * mode + feature add-ons for a whole kind of product, e.g. `"ai-saas"` or
+     * `"store"`. Explicit `template`/`features`/`mode` still win and are merged on
+     * top. Omit for no recipe.
+     */
+    recipe?: string;
+}
+/**
+ * A one-command **recipe**: a curated template + mode + add-on stack for a whole
+ * kind of product. `npx create-lacspace-app my-app --recipe ai-saas`.
+ */
+interface RecipeDef {
+    key: string;
+    label: string;
+    description: string;
+    /** The template this recipe starts from. */
+    template: string;
+    /** Force full-stack when the stack needs a backend (add-ons can also force it). */
+    mode?: "static" | "dynamic";
+    /** The add-ons this recipe layers on. */
+    features: string[];
 }
 
 /** A project file map: relative path → file contents. */
@@ -131,6 +153,13 @@ declare function getSection(name: string): string | undefined;
 declare function listFeatures(): FeatureDef[];
 /** Look up one feature add-on's definition by key, or `undefined`. */
 declare function getFeature(key: string): FeatureDef | undefined;
+/**
+ * The built-in one-shot recipes (see {@link RecipeDef}) — curated template + mode +
+ * add-on bundles you can pass as `options.recipe` or request with `--recipe <key>`.
+ */
+declare function listRecipes(): RecipeDef[];
+/** Look up one recipe's definition by key, or `undefined`. */
+declare function getRecipe(key: string): RecipeDef | undefined;
 /**
  * Generate a full project as an in-memory file map (relative path → contents).
  *
@@ -162,4 +191,4 @@ interface ScaffoldResult {
  */
 declare function scaffold(options?: ScaffoldOptions): Promise<ScaffoldResult>;
 
-export { type FeatureBackend, type FeatureDef, type FeatureRoute, type GenerateOptions, type ProjectFiles, type ScaffoldOptions, type ScaffoldResult, type TemplateDef, generateProject, getFeature, getSection, getTemplate, listFeatures, listSections, listTemplates, scaffold, templateKeys, templates };
+export { type FeatureBackend, type FeatureDef, type FeatureRoute, type GenerateOptions, type ProjectFiles, type RecipeDef, type ScaffoldOptions, type ScaffoldResult, type TemplateDef, generateProject, getFeature, getRecipe, getSection, getTemplate, listFeatures, listRecipes, listSections, listTemplates, scaffold, templateKeys, templates };

package/dist/lib.js

@@ -30,14 +30,15 @@ var TEMPLATES = [
   { key: "marketplace", label: "Marketplace / commerce", description: "A real storefront wired to the Lacspace commerce packages \u2014 cart, checkout, tax, shipping, orders, invoices and Nepal payments.", accent: ["#0d9488", "#6366f1"], siteName: "LSBazaar", siteDescription: "A modern storefront \u2014 cart to checkout, wired end to end." }
 ];
 function resolveContext(options = {}) {
-  const base = TEMPLATES.find((t) => t.key === options.template) ?? TEMPLATES[0];
+  const recipe = options.recipe ? RECIPES.find((r) => r.key === String(options.recipe).toLowerCase()) : void 0;
+  const base = TEMPLATES.find((t) => t.key === (options.template ?? recipe?.template)) ?? TEMPLATES[0];
   const accent = resolveAccent(options.theme);
   const template = accent ? { ...base, accent } : base;
   const raw = options.name ?? "my-app";
   const seg = raw.split(/[\\/]/).filter(Boolean).pop() ?? "my-app";
   const name = seg.toLowerCase().replace(/[^a-z0-9-_]/g, "-").replace(/^-+|-+$/g, "") || "my-app";
-  const features = normalizeFeatures(options.features);
-  let mode = options.mode === "dynamic" ? "dynamic" : "static";
+  const features = normalizeFeatures([...recipe?.features ?? [], ...options.features ?? []]);
+  let mode = options.mode === "dynamic" ? "dynamic" : options.mode === "static" ? "static" : recipe?.mode ?? "static";
   if (mode === "static" && features.some((f) => f.requiresBackend)) mode = "dynamic";
   return { name, template, features, mode };
 }
@@ -5253,6 +5254,13 @@ var faqSection = (ctx) => {
         </div>
       </section>`;
 };
+var RECIPES = [
+  { key: "ai-saas", label: "AI SaaS", description: "SaaS landing + accounts + payments + a streaming AI chat + analytics.", template: "saas", mode: "dynamic", features: ["auth-pages", "payments", "ai-chat", "analytics"] },
+  { key: "store", label: "Online store", description: "E-commerce storefront + eSewa/Khalti checkout + transactional email + analytics.", template: "ecommerce", mode: "dynamic", features: ["payments", "email", "analytics"] },
+  { key: "blog", label: "Blog", description: "A blog with a Markdown content section, RSS/llms.txt and instant search.", template: "blog", features: ["content", "search"] },
+  { key: "internal-tool", label: "Internal tool", description: "An admin dashboard with accounts (2FA), analytics and email \u2014 full-stack.", template: "dashboard", mode: "dynamic", features: ["auth-pages", "analytics", "email"] },
+  { key: "docs-ai", label: "AI docs", description: "A documentation site with chat-with-your-docs RAG and instant search.", template: "docs", features: ["rag", "search"] }
+];
 var contentLib = () => `import fs from "node:fs";
 import path from "node:path";
 import { parseFrontmatter, markdownToHtml, excerpt } from "@lacspace/markdown";
@@ -7229,7 +7237,9 @@ function parseArgs(list) {
     } else if (arg.startsWith("--mode=")) {
       const m = arg.slice(7).toLowerCase();
       a.mode = m === "dynamic" ? "dynamic" : "static";
-    } else if (arg === "-h" || arg === "--help") a.help = true;
+    } else if (arg === "--recipe") a.recipe = next();
+    else if (arg.startsWith("--recipe=")) a.recipe = arg.slice(9);
+    else if (arg === "-h" || arg === "--help") a.help = true;
     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);
@@ -7333,6 +7343,7 @@ ${c("bold", "Options")}
                          MongoDB/Redis backend (JWT auth + CRUD) + shared types
                          ${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)
   --pm <npm|pnpm|yarn|bun>  Package manager (default npm)
   --no-install           Skip installing dependencies
@@ -7341,9 +7352,13 @@ ${c("bold", "Options")}
   -h, --help             Show this help
 
 ${c("bold", "Feature add-ons")} ${c("dim", "(--with) \u2014 free & keyless, local by default")}
-${FEATURES.map((f) => `  ${f.key.padEnd(10)} ${f.description}`).join("\n")}
+${FEATURES.map((f) => `  ${f.key.padEnd(11)} ${f.description}`).join("\n")}
   ${c("dim", "e.g. npx create-lacspace-app my-app --template saas --with ai-chat,rag")}
 
+${c("bold", "Recipes")} ${c("dim", "(--recipe) \u2014 a whole product in one command")}
+${RECIPES.map((r) => `  ${r.key.padEnd(14)} ${r.description}`).join("\n")}
+  ${c("dim", "e.g. npx create-lacspace-app my-app --recipe ai-saas")}
+
 ${c("bold", "Themes")} ${c("dim", "(--theme)")}
   ${Object.keys(THEMES).join(" \xB7 ")}
   ${c("dim", 'or a custom colour: --theme "#ff6a00"  \xB7  --theme "#0bb9d9,#7c3aed"')}
@@ -7720,11 +7735,16 @@ async function main() {
   stdout.write(`
 ${c("bold", c("magenta", "\u25C6 create-lacspace-app"))} ${c("dim", "\u2014 a gorgeous Next.js starter, batteries wired")}
 
+`);
+  const recipe = args.recipe ? RECIPES.find((r) => r.key === args.recipe.toLowerCase()) : void 0;
+  if (args.recipe && !recipe) stdout.write(c("yellow", `  ! Unknown recipe "${args.recipe}" \u2014 ignoring. Try: ${RECIPES.map((r) => r.key).join(", ")}
+`));
+  if (recipe) stdout.write(`  ${c("green", "\u2714")} Recipe ${c("cyan", recipe.key)} ${c("dim", "\u2014 " + recipe.description)}
 `);
   let name = args.name;
-  let templateKey = args.template;
-  let mode = args.mode ?? "static";
-  const featureKeys = [...args.features];
+  let templateKey = args.template ?? recipe?.template;
+  let mode = args.mode ?? recipe?.mode ?? "static";
+  const featureKeys = [...recipe?.features ?? [], ...args.features];
   if (!args.yes && stdin.isTTY) {
     const rl = createInterface({ input: stdin, output: stdout });
     try {
@@ -7740,7 +7760,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) {
+      if (args.mode === void 0 && !recipe) {
         stdout.write(`
   What kind of app?
 `);
@@ -7793,6 +7813,11 @@ ${c("green", "?")} Add features? ${c("dim", "(comma-separated numbers, or Enter
     return;
   }
   const features = normalizeFeatures(featureKeys);
+  if (mode === "static" && features.some((f) => f.requiresBackend)) {
+    mode = "dynamic";
+    stdout.write(`  ${c("dim", "\u2191 a selected add-on needs a backend \u2014 building full-stack")}
+`);
+  }
   const files = buildFiles({ name: projectName, template, features, mode });
   for (const [rel, content] of Object.entries(files)) {
     const full = join(dir, rel);
@@ -7904,6 +7929,13 @@ function getFeature(key) {
   const f = FEATURES.find((x) => x.key === key);
   return f ? { ...f } : void 0;
 }
+function listRecipes() {
+  return RECIPES.map((r) => ({ ...r, features: [...r.features] }));
+}
+function getRecipe(key) {
+  const r = RECIPES.find((x) => x.key === key);
+  return r ? { ...r, features: [...r.features] } : void 0;
+}
 function generateProject(options = {}) {
   return buildFiles(resolveContext(options));
 }
@@ -7919,4 +7951,4 @@ async function scaffold(options = {}) {
   return { dir: target, files: Object.keys(files) };
 }
 
-export { generateProject, getFeature, getSection, getTemplate, listFeatures, listSections, listTemplates, scaffold, templateKeys, templates };
+export { generateProject, getFeature, getRecipe, getSection, getTemplate, listFeatures, listRecipes, listSections, listTemplates, scaffold, templateKeys, templates };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-lacspace-app",
-  "version": "2.7.0",
+  "version": "2.8.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": {