@mars-stack/cli 7.0.6 → 8.0.0

package/README.md

@@ -26,11 +26,21 @@ Scaffold a new project. Walks through four interactive prompt groups:
 
 Outputs a complete Next.js application with auth, design tokens, database schema, agent infrastructure (AGENTS.md, skills, rules, docs), and a working dev environment.
 
+**Non-interactive shortcuts**
+
+- `mars create my-app --defaults` — same choices as the default interactive path (minimal feature set, local/console providers).
+- `mars create my-app --starter saas` — deterministic **SaaS** preset: enables common product flags (billing, notifications, search, analytics, etc.) with local/`console`/`none` stubs so you are not prompted for every toggle. Use `mars create --help` for the current `--starter` list.
+
+`--defaults` and `--starter` cannot be combined.
+
 ```bash
 mars create my-app
 # → interactive prompts
 # → scaffolds ~200 files
 # → prints next steps
+
+mars create my-app --starter saas
+# → same scaffold path, preset feature + service choices (no feature/theme prompts)
 ```
 
 ### `mars add feature <name>`

package/dist/index.js

@@ -6538,6 +6538,94 @@ async function promptTheme() {
   };
 }
 
+// src/prompts/starter-presets.ts
+var BUILTIN_STARTER_NAMES = ["minimal", "saas"];
+function minimalPreset() {
+  const features = getDefaultFeatures();
+  return {
+    name: "minimal",
+    displayName: "Minimal",
+    description: "Same defaults as interactive blank setup (matches --defaults)",
+    features,
+    services: getDefaultServices(features),
+    theme: getDefaultTheme()
+  };
+}
+function saasPreset() {
+  const features = {
+    auth: true,
+    googleOAuth: false,
+    emailVerification: true,
+    magicLinks: false,
+    twoFactor: false,
+    admin: true,
+    darkMode: true,
+    notifications: true,
+    onboarding: true,
+    multiTenancy: false,
+    teams: false,
+    billing: true,
+    blog: false,
+    seo: true,
+    comingSoon: false,
+    cookieConsent: true,
+    analytics: true,
+    sentry: true,
+    ai: false,
+    fileUpload: true,
+    search: true,
+    realtime: true,
+    commandPalette: true,
+    featureFlags: true
+  };
+  const services = {
+    email: { provider: "console" },
+    storage: { provider: "local" },
+    database: { provider: "local" },
+    payments: { provider: "stripe" },
+    analytics: { provider: "vercel" },
+    monitoring: { provider: "sentry" },
+    ai: { provider: "none" },
+    search: { provider: "postgres" },
+    realtime: { provider: "sse" },
+    jobs: { provider: "none" }
+  };
+  return {
+    name: "saas",
+    displayName: "SaaS",
+    description: "Common product features: billing, notifications, search, analytics, and more (local/console stubs)",
+    features,
+    services,
+    theme: getDefaultTheme()
+  };
+}
+var BUILTIN = {
+  minimal: minimalPreset(),
+  saas: saasPreset()
+};
+function listBuiltinStarterNames() {
+  return BUILTIN_STARTER_NAMES;
+}
+function getBuiltinStarterDefinition(name) {
+  if (name === "minimal" || name === "saas") {
+    return BUILTIN[name];
+  }
+  return void 0;
+}
+function formatUnknownStarterMessage(name) {
+  const valid = listBuiltinStarterNames().join(", ");
+  return `Unknown starter "${name}". Valid starters: ${valid}`;
+}
+function applyBuiltinStarterToConfig(base, starterName) {
+  const def = BUILTIN[starterName];
+  return {
+    ...base,
+    features: { ...def.features },
+    services: structuredClone(def.services),
+    theme: { ...def.theme }
+  };
+}
+
 // src/generators/scaffold.ts
 init_logger();
 import fs4 from "fs-extra";
@@ -7263,7 +7351,13 @@ var PROJECT_NAME_REGEX = /^[a-z0-9][a-z0-9-]*[a-z0-9]$/;
 var MAX_PROJECT_NAME_LENGTH = 214;
 async function createCommand(projectName, options) {
   const useDefaults = options?.defaults === true;
+  const starterArg = options?.starter?.trim();
+  const useStarter = Boolean(starterArg);
   log.banner();
+  if (useDefaults && useStarter) {
+    log.error("Cannot combine --defaults with --starter. Use one preset path.");
+    return;
+  }
   if (projectName) {
     if (!PROJECT_NAME_REGEX.test(projectName) && projectName.length > 1) {
       log.error("Project name must be lowercase letters, numbers, and hyphens only.");
@@ -7282,7 +7376,21 @@ async function createCommand(projectName, options) {
     log.error("Project name is required when using --defaults.");
     return;
   }
-  const projectInfo = useDefaults ? getDefaultProjectInfo(projectName) : await promptProjectInfo(projectName);
+  if (useStarter && starterArg) {
+    const preset = getBuiltinStarterDefinition(starterArg);
+    if (!preset) {
+      log.error(formatUnknownStarterMessage(starterArg));
+      log.info(`Valid starters: ${listBuiltinStarterNames().join(", ")}`);
+      return;
+    }
+  }
+  if (useStarter && !projectName) {
+    log.error(
+      "Project name is required when using --starter (non-interactive). Example: mars create my-app --starter saas"
+    );
+    return;
+  }
+  const projectInfo = useDefaults || useStarter ? getDefaultProjectInfo(projectName) : await promptProjectInfo(projectName);
   if (!projectInfo) return;
   const targetDir = resolveProjectPath(projectInfo.name);
   if (await fs23.pathExists(targetDir)) {
@@ -7292,28 +7400,44 @@ async function createCommand(projectName, options) {
       return;
     }
   }
-  const features = useDefaults ? getDefaultFeatures() : await promptFeatures();
-  if (!features) return;
-  const services = useDefaults ? getDefaultServices(features) : await promptServices(features);
-  if (!services) return;
-  const theme = useDefaults ? getDefaultTheme() : await promptTheme();
-  if (!theme) return;
-  const config = {
-    ...projectInfo,
-    features,
-    services,
-    theme
-  };
+  let config;
+  if (useStarter && starterArg) {
+    const preset = getBuiltinStarterDefinition(starterArg);
+    config = applyBuiltinStarterToConfig(projectInfo, preset.name);
+  } else if (useDefaults) {
+    const features = getDefaultFeatures();
+    config = {
+      ...projectInfo,
+      features,
+      services: getDefaultServices(features),
+      theme: getDefaultTheme()
+    };
+  } else {
+    const features = await promptFeatures();
+    if (!features) return;
+    const services = await promptServices(features);
+    if (!services) return;
+    const theme = await promptTheme();
+    if (!theme) return;
+    config = {
+      ...projectInfo,
+      features,
+      services,
+      theme
+    };
+  }
   log.blank();
   log.title("Summary");
   log.info(`Project:    ${pc2.bold(config.displayName)} (${config.name})`);
   log.info(`URL:        ${config.url}`);
-  log.info(`Features:   ${countEnabled(features)} enabled`);
-  log.info(`Database:   ${services.database.provider}`);
-  log.info(`Email:      ${services.email.provider}`);
-  log.info(`Theme:      ${theme.primaryColor}, ${theme.font}, ${theme.designDirection}`);
+  log.info(`Features:   ${countEnabled(config.features)} enabled`);
+  log.info(`Database:   ${config.services.database.provider}`);
+  log.info(`Email:      ${config.services.email.provider}`);
+  log.info(
+    `Theme:      ${config.theme.primaryColor}, ${config.theme.font}, ${config.theme.designDirection}`
+  );
   log.blank();
-  if (!useDefaults) {
+  if (!useDefaults && !useStarter) {
     const { confirmed } = await prompts5(
       {
         type: "confirm",
@@ -7350,10 +7474,12 @@ async function createCommand(projectName, options) {
     spinner.succeed(`Scaffolded ${pc2.bold(String(fileCount))} files`);
     const generatedFeatures = await generateSelectedFeatures(targetDir, config.features);
     if (generatedFeatures.length > 0) {
-      log.success(`Generated ${generatedFeatures.length} additional feature(s): ${generatedFeatures.join(", ")}`);
+      log.success(
+        `Generated ${generatedFeatures.length} additional feature(s): ${generatedFeatures.join(", ")}`
+      );
     }
     trackEvent("create", {
-      features: Object.keys(features).filter((f) => features[f]).join(",")
+      features: Object.keys(config.features).filter((f) => config.features[f]).join(",")
     });
     log.blank();
     log.title("Next Steps");
@@ -8771,7 +8897,10 @@ init_feature_flags();
 init_logger();
 var program = new Command();
 program.name("mars").description("MARS CLI: scaffold, configure, and maintain SaaS apps").version(getCliVersion(), "-v, --version", "Print the current mars CLI version").option("-u, --upgrade", "Upgrade Mars packages to latest versions");
-program.command("create").description("Create a new MARS project").argument("[name]", "Project name (kebab-case)").option("--defaults", "Skip prompts, use default configuration").action(async (name, options) => {
+program.command("create").description("Create a new MARS project").argument("[name]", "Project name (kebab-case)").option("--defaults", "Skip prompts, use default configuration").option(
+  "--starter <name>",
+  "Use a named preset (minimal, saas). Skips feature/service/theme prompts; requires project name"
+).action(async (name, options) => {
   await createCommand(name, options);
 });
 var add = program.command("add").description("Add a feature, page, model, component, or email template to your project");
@@ -8790,32 +8919,50 @@ add.command("component").description("Create a new UI component").argument("<nam
 add.command("email").description("Create a new email template").argument("<name>", "Template name in kebab-case (e.g., invoice, team-invite)").action(async (name) => {
   await addEmailCommand(name);
 });
-var generate = program.command("generate").description("Generate a feature with full scaffolding (pages, components, server logic, config)");
+var generate = program.command("generate").description(
+  "Generate a feature with full scaffolding (pages, components, server logic, config)"
+);
 generate.command("blog").description("Add an MDX-based blog with listing, post pages, RSS feed, and SEO").action(async () => {
   await generateBlog(process.cwd());
 });
-generate.command("dark-mode").description("Add dark mode with ThemeProvider, theme toggle, system preference detection, and FOUC prevention").action(async () => {
+generate.command("dark-mode").description(
+  "Add dark mode with ThemeProvider, theme toggle, system preference detection, and FOUC prevention"
+).action(async () => {
   await generateDarkMode(process.cwd());
 });
-generate.command("notifications").description("Add in-app notifications with Prisma model, API routes, bell component, and polling hook").action(async () => {
+generate.command("notifications").description(
+  "Add in-app notifications with Prisma model, API routes, bell component, and polling hook"
+).action(async () => {
   await generateNotifications(process.cwd());
 });
-generate.command("analytics").description("Add analytics with Vercel/PostHog/Google providers, consent banner, and unified tracking API").action(async () => {
+generate.command("analytics").description(
+  "Add analytics with Vercel/PostHog/Google providers, consent banner, and unified tracking API"
+).action(async () => {
   await generateAnalytics(process.cwd());
 });
-generate.command("command-palette").description("Add a Cmd+K command palette with fuzzy search, action registry, and keyboard navigation").action(async () => {
+generate.command("command-palette").description(
+  "Add a Cmd+K command palette with fuzzy search, action registry, and keyboard navigation"
+).action(async () => {
   await generateCommandPalette(process.cwd());
 });
-generate.command("onboarding").description("Add multi-step user onboarding with progress tracking, skip/complete, and redirect logic").action(async () => {
+generate.command("onboarding").description(
+  "Add multi-step user onboarding with progress tracking, skip/complete, and redirect logic"
+).action(async () => {
   await generateOnboarding(process.cwd());
 });
-generate.command("search").description("Add search with Postgres full-text, Algolia, or Meilisearch providers and debounced hook").action(async () => {
+generate.command("search").description(
+  "Add search with Postgres full-text, Algolia, or Meilisearch providers and debounced hook"
+).action(async () => {
   await generateSearch(process.cwd());
 });
-generate.command("realtime").description("Add realtime updates with SSE (default), Pusher, or Ably providers and client hooks").action(async () => {
+generate.command("realtime").description(
+  "Add realtime updates with SSE (default), Pusher, or Ably providers and client hooks"
+).action(async () => {
   await generateRealtime(process.cwd());
 });
-generate.command("ai").description("Add AI integration with OpenAI/Anthropic providers, streaming chat API, and useChat hook").action(async () => {
+generate.command("ai").description(
+  "Add AI integration with OpenAI/Anthropic providers, streaming chat API, and useChat hook"
+).action(async () => {
   await generateAI(process.cwd());
 });
 generate.command("cookie-consent").description("Add a cookie consent banner with preferences dialog and useConsent hook").action(async () => {
@@ -8827,10 +8974,15 @@ generate.command("coming-soon").description("Add a coming soon landing page with
 generate.command("sentry").description("Add Sentry error tracking with client/server init and ErrorBoundary component").action(async () => {
   await generateSentry(process.cwd());
 });
-generate.command("feature-flags").description("Add feature flags with local JSON provider, server getFlag, client hook, and FeatureGate component").action(async () => {
+generate.command("feature-flags").description(
+  "Add feature flags with local JSON provider, server getFlag, client hook, and FeatureGate component"
+).action(async () => {
   await generateFeatureFlags(process.cwd());
 });
-program.command("configure").description("Configure a service provider (email, payments, storage, etc.)").argument("[service]", "Service to configure (email, payments, storage, analytics, monitoring, auth)").action(async (service) => {
+program.command("configure").description("Configure a service provider (email, payments, storage, etc.)").argument(
+  "[service]",
+  "Service to configure (email, payments, storage, analytics, monitoring, auth)"
+).action(async (service) => {
   await configureCommand(service);
 });
 program.command("deploy").description("Deploy your project to Vercel").action(async () => {
@@ -8855,7 +9007,9 @@ program.command("telemetry").description("Manage anonymous usage telemetry").arg
 program.hook("preAction", (thisCommand) => {
   const globalOpts = program.opts();
   if (globalOpts.upgrade && thisCommand !== program) {
-    log.error('Cannot combine --upgrade with other commands. Use "mars -u" or "mars upgrade" alone.');
+    log.error(
+      'Cannot combine --upgrade with other commands. Use "mars -u" or "mars upgrade" alone.'
+    );
     process.exit(1);
   }
 });