tailar 0.4.0 → 0.5.0

package/dist/types/wizard.js

@@ -3,9 +3,58 @@
  *
  * Shared types for the Tailar init guided wizard.
  */
+/** Install order of modules. */
+export const MODULE_ORDER = [
+    'database',
+    'email',
+    'auth',
+    'payments',
+    'storage',
+    'ai',
+];
+/** Registry feature that installs each module. */
+export const MODULE_FEATURES = {
+    database: 'db',
+    email: 'emails',
+    auth: 'auth',
+    payments: 'payments',
+    storage: 'storage',
+    ai: 'ai',
+};
 /**
- * Normalize multiselect result: enforce Auth → DB+Email, Payments → Auth+DB+Email;
- * deselecting DB/Email drops Auth+Payments; deselecting Auth drops Payments.
+ * Direct module dependencies. Kept in step with `featureDependencies` in
+ * components/registry.json by test/wizard.test.ts; update both together.
+ */
+export const MODULE_REQUIRES = {
+    database: [],
+    email: [],
+    auth: ['database', 'email'],
+    payments: ['auth', 'database', 'email'],
+    storage: ['auth', 'database', 'email'],
+    ai: [],
+};
+export function formatModuleLabel(id) {
+    switch (id) {
+        case 'database':
+            return 'Database';
+        case 'email':
+            return 'Email';
+        case 'auth':
+            return 'Authentication';
+        case 'payments':
+            return 'Payments';
+        case 'storage':
+            return 'Storage';
+        case 'ai':
+            return 'AI';
+        default:
+            return id;
+    }
+}
+/**
+ * Normalize a module selection: every selected module pulls in what it
+ * requires (see MODULE_REQUIRES), so deselecting a dependency cannot leave a
+ * module that would not run.
  */
 export function normalizeModuleSelection(raw) {
     const notes = [];
@@ -14,46 +63,31 @@ export function normalizeModuleSelection(raw) {
             notes.push(s);
     };
     const set = new Set(raw);
-    if (set.has('payments')) {
-        if (!set.has('auth')) {
-            set.add('auth');
-            addNote('Payments requires Authentication — enabled automatically.');
-        }
-        if (!set.has('database')) {
-            set.add('database');
-            addNote('Payments requires Database — enabled automatically.');
-        }
-        if (!set.has('email')) {
-            set.add('email');
-            addNote('Payments requires Email — enabled automatically.');
-        }
-    }
-    if (set.has('auth')) {
-        if (!set.has('database')) {
-            set.add('database');
-            addNote('Authentication requires Database — enabled automatically.');
-        }
-        if (!set.has('email')) {
-            set.add('email');
-            addNote('Authentication requires Email — enabled automatically.');
+    // Dependents first, so a note names the module the user actually picked.
+    const pending = [...MODULE_ORDER].reverse().filter((m) => set.has(m));
+    while (pending.length > 0) {
+        const module = pending.shift();
+        for (const required of MODULE_REQUIRES[module]) {
+            if (set.has(required))
+                continue;
+            set.add(required);
+            pending.push(required);
+            addNote(`${formatModuleLabel(module)} requires ${formatModuleLabel(required)} — enabled automatically.`);
         }
     }
-    if (!set.has('database') || !set.has('email')) {
-        if (set.has('auth')) {
-            set.delete('auth');
-            addNote('Authentication requires Database and Email — disabled automatically.');
-        }
-        if (set.has('payments')) {
-            set.delete('payments');
-            addNote('Payments requires Auth, Database, and Email — disabled automatically.');
-        }
-    }
-    if (!set.has('auth') && set.has('payments')) {
-        set.delete('payments');
-        addNote('Payments requires Authentication — disabled automatically.');
-    }
-    const order = ['database', 'email', 'auth', 'payments'];
-    const modules = order.filter((m) => set.has(m));
+    const modules = MODULE_ORDER.filter((m) => set.has(m));
     return { modules, autoNotes: notes };
 }
+export const ATTACHMENTS_HINT = 'Chat attachments need the Storage module (it also installs Database and Auth).';
+/**
+ * Advice about a module selection that is valid but leaves something out.
+ * Never changes the selection.
+ */
+export function moduleSelectionHints(modules) {
+    const hints = [];
+    if (modules.includes('ai') && !modules.includes('storage')) {
+        hints.push(ATTACHMENTS_HINT);
+    }
+    return hints;
+}
 //# sourceMappingURL=wizard.js.map

package/dist/types/wizard.js.map

@@ -1 +1 @@
-{"version":3,"file":"wizard.js","sourceRoot":"","sources":["../../src/types/wizard.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmCH;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAmB;IAI1D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,EAAE;QAC5B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC;IACF,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAEzB,IAAI,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACrB,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAChB,OAAO,CAAC,2DAA2D,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACzB,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YACpB,OAAO,CAAC,qDAAqD,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACtB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACjB,OAAO,CAAC,kDAAkD,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IACD,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACpB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACzB,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YACpB,OAAO,CAAC,2DAA2D,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACtB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACjB,OAAO,CAAC,wDAAwD,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9C,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACpB,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACnB,OAAO,CACL,sEAAsE,CACvE,CAAC;QACJ,CAAC;QACD,IAAI,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACxB,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YACvB,OAAO,CACL,uEAAuE,CACxE,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5C,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACvB,OAAO,CAAC,4DAA4D,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,KAAK,GAAmB,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IACxE,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AACvC,CAAC"}
+{"version":3,"file":"wizard.js","sourceRoot":"","sources":["../../src/types/wizard.ts"],"names":[],"mappings":"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"}

package/dist/utils/clack-wizard.d.ts

@@ -1,13 +1,15 @@
 import { TailarInitWizardState } from '../types/wizard.js';
 import type { PackageManager } from '../types/index.js';
 export declare function clackTextInput(message: string, defaultValue?: string): Promise<string | undefined>;
-export declare function runInitWizard(): Promise<TailarInitWizardState | null>;
+export declare function runInitWizard(initialProjectName?: string): Promise<TailarInitWizardState | null>;
 export declare function runGenerationFromWizardConfig(projectPath: string, wizard: TailarInitWizardState, opts?: {
     verbose?: boolean;
     /** Skip npm install and post-install shell commands (tests and CI). */
     skipInstall?: boolean;
     /** Skip printing env and instruction next-steps (playground writes .env itself). */
     skipNextSteps?: boolean;
+    /** Id of the recipe this app is scaffolded from; recorded in .tailar.json. */
+    recipeId?: string;
     /** Runs after files are in place and before post-install commands. */
     beforePostInstall?: (projectRoot: string) => Promise<void>;
 }): Promise<{

package/dist/utils/clack-wizard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clack-wizard.d.ts","sourceRoot":"","sources":["../../src/utils/clack-wizard.ts"],"names":[],"mappings":"AAIA,OAAO,EAML,qBAAqB,EAEtB,MAAM,oBAAoB,CAAC;AAS5B,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,mBAAmB,CAAC;AAkCvE,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAW7B;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAyI3E;AAED,wBAAsB,6BAA6B,CACjD,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,qBAAqB,EAC7B,IAAI,GAAE;IACJ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uEAAuE;IACvE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oFAAoF;IACpF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD,GACL,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,cAAc,CAAA;CAAE,CAAC,CA6MlE"}
+{"version":3,"file":"clack-wizard.d.ts","sourceRoot":"","sources":["../../src/utils/clack-wizard.ts"],"names":[],"mappings":"AAIA,OAAO,EAOL,qBAAqB,EAMtB,MAAM,oBAAoB,CAAC;AAkB5B,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,mBAAmB,CAAC;AAwBvE,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAW7B;AAiBD,wBAAsB,aAAa,CACjC,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAuLvC;AAED,wBAAsB,6BAA6B,CACjD,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,qBAAqB,EAC7B,IAAI,GAAE;IACJ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uEAAuE;IACvE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oFAAoF;IACpF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD,GACL,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,cAAc,CAAA;CAAE,CAAC,CA2RlE"}

package/dist/utils/clack-wizard.js

@@ -2,38 +2,32 @@ import * as p from '@clack/prompts';
 import { copyFileSync, existsSync, mkdirSync, readdirSync } from 'fs';
 import { dirname, join } from 'path';
 import { fileURLToPath } from 'url';
-import { normalizeModuleSelection, } from '../types/wizard.js';
+import { MODULE_FEATURES, MODULE_ORDER, formatModuleLabel, normalizeModuleSelection, moduleSelectionHints, } from '../types/wizard.js';
+import { loadRegistry } from '../registry/loader.js';
+import { getEntry } from '../registry/query.js';
+import { featureNames, featureProviderChoices, getPresets, missingRequirements, } from './presets.js';
 import { createInitialConfig, writeConfig, } from './config.js';
 import { detectPackageManager, } from './package-manager.js';
 import { detectProjectStructure } from './validation.js';
 import { installFeature } from '../installers/install-feature.js';
 import { runInstall } from '../installers/dependencies.js';
 import { executePostInstallSteps } from '../installers/post-install.js';
+import { SETUP_FILE } from '../installers/setup-guide.js';
 import { readConfig } from './config.js';
 // Resolve the bundled favicon.ico relative to this compiled module.
 // In the dist tree: dist/utils/clack-wizard.js → ../../assets/favicon.ico
 const _thisFile = fileURLToPath(import.meta.url);
 const BUNDLED_FAVICON = join(dirname(_thisFile), '../../assets/favicon.ico');
-const CORE_MODULES = ['database', 'email', 'auth', 'payments'];
-function formatModuleLabel(id) {
-    switch (id) {
-        case 'database':
-            return 'Database';
-        case 'email':
-            return 'Email';
-        case 'auth':
-            return 'Authentication';
-        case 'payments':
-            return 'Payments';
-        default:
-            return id;
-    }
-}
 function formatModuleSummary(modules) {
     if (modules.length === 0)
         return 'No modules selected';
     return modules.map((m) => formatModuleLabel(m)).join(', ');
 }
+const MODULE_HINTS = {
+    auth: 'requires Database, Email',
+    payments: 'requires Auth, Database, Email',
+    storage: 'requires Auth, Database, Email',
+};
 export async function clackTextInput(message, defaultValue) {
     const result = await p.text({
         message,
@@ -46,41 +40,59 @@ export async function clackTextInput(message, defaultValue) {
     const value = typeof result === 'string' ? result.trim() : undefined;
     return value || defaultValue;
 }
-export async function runInitWizard() {
-    p.intro('Tailar Init — Guided Wizard');
-    const projectType = await p.select({
-        message: 'What kind of project are you building?',
-        options: [
-            { value: 'saas', label: 'SaaS product' },
-            { value: 'ai', label: 'AI product (coming soon)' },
-        ],
+async function selectProvider(registry, featureName, message, fallback, fallbackDefault) {
+    const choices = featureProviderChoices(registry, featureName);
+    return p.select({
+        message,
+        options: choices?.values ?? fallback,
+        initialValue: choices?.default ?? fallbackDefault,
     });
-    if (p.isCancel(projectType)) {
-        p.cancel('Initialization cancelled.');
-        return null;
+}
+export async function runInitWizard(initialProjectName) {
+    p.intro('Tailar Init — Guided Wizard');
+    // The registry is optional here: without it the wizard uses built-in presets and providers.
+    let registry;
+    try {
+        registry = await loadRegistry();
     }
-    if (projectType === 'ai') {
-        p.outro('AI product templates are coming soon. No files were generated.');
-        return null;
+    catch {
+        registry = undefined;
+    }
+    const presets = getPresets(registry);
+    const features = featureNames(registry);
+    let preset = presets[0];
+    for (;;) {
+        const choice = await p.select({
+            message: 'What kind of project are you building?',
+            options: presets.map((candidate) => {
+                const missing = missingRequirements(candidate, features);
+                return {
+                    value: candidate.id,
+                    label: missing.length > 0 ? `${candidate.label} (coming soon)` : candidate.label,
+                    hint: candidate.description,
+                };
+            }),
+        });
+        if (p.isCancel(choice)) {
+            p.cancel('Initialization cancelled.');
+            return null;
+        }
+        preset = presets.find((candidate) => candidate.id === choice);
+        if (missingRequirements(preset, features).length === 0)
+            break;
+        p.note(`${preset.label} is coming soon. Pick another project type.`, 'Not available yet');
     }
-    const projectName = (await clackTextInput('Project name:', 'my-app')) ?? 'my-app';
+    const projectName = initialProjectName ||
+        ((await clackTextInput('Project name:', 'my-app')) ?? 'my-app');
+    const available = MODULE_ORDER.filter((m) => !features || features.includes(MODULE_FEATURES[m]));
     const rawSelection = await p.multiselect({
         message: 'Select modules to include (space to toggle, enter to submit):',
-        options: [
-            { value: 'database', label: 'Database' },
-            { value: 'email', label: 'Email' },
-            {
-                value: 'auth',
-                label: 'Authentication',
-                hint: 'requires Database, Email',
-            },
-            {
-                value: 'payments',
-                label: 'Payments',
-                hint: 'requires Auth, Database, Email (Stripe)',
-            },
-        ],
-        initialValues: [...CORE_MODULES],
+        options: available.map((m) => ({
+            value: m,
+            label: formatModuleLabel(m),
+            hint: MODULE_HINTS[m],
+        })),
+        initialValues: available.filter((m) => preset.modules.includes(m)),
         required: false,
     });
     if (p.isCancel(rawSelection)) {
@@ -91,19 +103,20 @@ export async function runInitWizard() {
     if (autoNotes.length > 0) {
         p.note(autoNotes.join('\n'), 'Selection adjusted');
     }
-    p.note('Storage and Analytics — coming soon.', 'Roadmap');
+    const hints = moduleSelectionHints(modules);
+    if (hints.length > 0) {
+        p.note(hints.join('\n'), 'Hint');
+    }
+    p.note('Analytics — coming soon.', 'Roadmap');
     const providers = {
         authProvider: 'better-auth',
     };
     if (modules.includes('database')) {
-        const db = await p.select({
-            message: 'Database provider:',
-            options: [
-                { value: 'postgres', label: 'PostgreSQL' },
-                { value: 'mysql', label: 'MySQL' },
-                { value: 'mongodb', label: 'MongoDB' },
-            ],
-        });
+        const db = await selectProvider(registry, MODULE_FEATURES.database, 'Database provider:', [
+            { value: 'postgres', label: 'PostgreSQL' },
+            { value: 'mysql', label: 'MySQL' },
+            { value: 'mongodb', label: 'MongoDB' },
+        ], 'postgres');
         if (p.isCancel(db)) {
             p.cancel('Initialization cancelled.');
             return null;
@@ -111,14 +124,11 @@ export async function runInitWizard() {
         providers.database = db;
     }
     if (modules.includes('email')) {
-        const email = await p.select({
-            message: 'Email provider:',
-            options: [
-                { value: 'resend', label: 'Resend' },
-                { value: 'postmark', label: 'Postmark' },
-                { value: 'sendgrid', label: 'SendGrid' },
-            ],
-        });
+        const email = await selectProvider(registry, MODULE_FEATURES.email, 'Email provider:', [
+            { value: 'resend', label: 'Resend' },
+            { value: 'postmark', label: 'Postmark' },
+            { value: 'sendgrid', label: 'SendGrid' },
+        ], 'resend');
         if (p.isCancel(email)) {
             p.cancel('Initialization cancelled.');
             return null;
@@ -140,17 +150,32 @@ export async function runInitWizard() {
         providers.authStructure = structure;
     }
     if (modules.includes('payments')) {
-        providers.payments = 'stripe';
+        const payments = await selectProvider(registry, MODULE_FEATURES.payments, 'Billing provider:', [{ value: 'stripe', label: 'Stripe' }], 'stripe');
+        if (p.isCancel(payments)) {
+            p.cancel('Initialization cancelled.');
+            return null;
+        }
+        providers.payments = payments;
+    }
+    if (modules.includes('storage')) {
+        const storage = await selectProvider(registry, MODULE_FEATURES.storage, 'Storage provider:', [{ value: 'r2', label: 'Cloudflare R2' }], 'r2');
+        if (p.isCancel(storage)) {
+            p.cancel('Initialization cancelled.');
+            return null;
+        }
+        providers.storage = storage;
     }
     return {
-        projectType: 'saas',
+        preset: preset.id,
         projectName,
         modules,
         providers,
+        items: preset.items ?? [],
+        template: preset.template,
     };
 }
 export async function runGenerationFromWizardConfig(projectPath, wizard, opts = {}) {
-    p.intro('Scaffolding Tailar SaaS project...');
+    p.intro(`Scaffolding Tailar project (${wizard.preset})...`);
     const projectName = wizard.projectName || 'my-app';
     const actualProjectPath = join(projectPath, projectName);
     // ── Create the project directory ──────────────────────────────────────────
@@ -171,10 +196,11 @@ export async function runGenerationFromWizardConfig(projectPath, wizard, opts =
     const structure = { hasSrcFolder: false, hasAppFolder: true };
     const packageManager = detectPackageManager(actualProjectPath);
     const meta = {
-        projectType: wizard.projectType,
+        preset: wizard.preset,
         modules: wizard.modules,
         providers: wizard.providers,
         packageManager,
+        ...(opts.recipeId ? { recipe: opts.recipeId } : {}),
     };
     const baseConfig = createInitialConfig({
         name: projectName,
@@ -189,8 +215,11 @@ export async function runGenerationFromWizardConfig(projectPath, wizard, opts =
     // ── Install base scaffold from registry ───────────────────────────────────
     const allPostInstall = [];
     let needsInstall = false;
+    // @clack/prompts 0.7 registers five process listeners every time p.spinner() is
+    // created and never removes them, so one shared spinner avoids the
+    // MaxListenersExceededWarning that one spinner per step caused.
+    const sp = p.spinner();
     const runInstallStep = async (label, fn) => {
-        const sp = p.spinner();
         sp.start(label);
         try {
             const r = await fn();
@@ -218,50 +247,93 @@ export async function runGenerationFromWizardConfig(projectPath, wizard, opts =
     }
     await runInstallStep('Installing Shared UI (Tailar base)…', () => installFeature(actualProjectPath, 'shared', { yes: true }));
     await runInstallStep('Installing i18n (next-intl)…', () => installFeature(actualProjectPath, 'i18n', { yes: true }));
-    if (wizard.modules.includes('database') && wizard.providers.database) {
-        await runInstallStep('Installing Database (Prisma)…', () => installFeature(actualProjectPath, 'db', {
-            yes: true,
+    // Features present so far; a template is applied only when its dependencies are here.
+    const installed = new Set(['base', 'shared', 'i18n']);
+    const moduleSteps = [
+        {
+            module: 'database',
+            label: 'Installing Database (Prisma)…',
+            when: Boolean(wizard.providers.database),
             presetAnswers: { dbProvider: wizard.providers.database },
-        }));
-    }
-    if (wizard.modules.includes('email') && wizard.providers.email) {
-        await runInstallStep('Installing Email…', () => installFeature(actualProjectPath, 'emails', {
-            yes: true,
+        },
+        {
+            module: 'email',
+            label: 'Installing Email…',
+            when: Boolean(wizard.providers.email),
             presetAnswers: { emailProvider: wizard.providers.email },
-        }));
-    }
-    if (wizard.modules.includes('auth') && wizard.providers.authStructure) {
-        await runInstallStep('Installing Authentication (Better Auth)…', () => installFeature(actualProjectPath, 'auth', {
-            yes: true,
+        },
+        {
+            module: 'auth',
+            label: 'Installing Authentication (Better Auth)…',
+            when: Boolean(wizard.providers.authStructure),
             presetAnswers: {
                 organizationBased: wizard.providers.authStructure === 'org-based',
             },
+        },
+        {
+            module: 'payments',
+            label: 'Installing Payments…',
+            when: true,
+            presetAnswers: wizard.providers.payments
+                ? { billingProvider: wizard.providers.payments }
+                : undefined,
+        },
+        {
+            module: 'storage',
+            label: 'Installing Storage…',
+            when: true,
+            presetAnswers: wizard.providers.storage
+                ? { storageProvider: wizard.providers.storage }
+                : undefined,
+        },
+        {
+            module: 'ai',
+            label: 'Installing AI…',
+            when: true,
+        },
+    ];
+    // Modules selected for this run, so `when` can see features installed later.
+    const planned = moduleSteps
+        .filter((step) => wizard.modules.includes(step.module) && step.when)
+        .map((step) => MODULE_FEATURES[step.module]);
+    for (const step of moduleSteps) {
+        if (!wizard.modules.includes(step.module) || !step.when)
+            continue;
+        const feature = MODULE_FEATURES[step.module];
+        await runInstallStep(step.label, () => installFeature(actualProjectPath, feature, {
+            yes: true,
+            plannedFeatures: planned,
+            ...(step.presetAnswers ? { presetAnswers: step.presetAnswers } : {}),
         }));
+        installed.add(feature);
     }
-    if (wizard.modules.includes('payments')) {
-        await runInstallStep('Installing Payments (Stripe)…', () => installFeature(actualProjectPath, 'payments', { yes: true }));
-    }
-    let sidebarVariant = 'default';
-    if (wizard.modules.includes('auth') && wizard.providers.authStructure) {
-        sidebarVariant =
-            wizard.providers.authStructure === 'org-based' ? 'org-based' : 'user-based';
-    }
-    await runInstallStep('Installing App Sidebar…', () => installFeature(actualProjectPath, 'app-sidebar', {
-        yes: true,
-        variant: sidebarVariant,
-    }));
-    if (wizard.modules.includes('auth')) {
-        await runInstallStep('Applying SaaS root page template…', () => installFeature(actualProjectPath, 'saas', {
+    for (const item of wizard.items) {
+        // The sidebar follows the auth structure; other items have one variant.
+        const variant = item === 'app-sidebar'
+            ? wizard.modules.includes('auth') && wizard.providers.authStructure
+                ? wizard.providers.authStructure
+                : 'default'
+            : undefined;
+        await runInstallStep(`Installing ${item}…`, () => installFeature(actualProjectPath, item, {
             yes: true,
+            plannedFeatures: planned,
+            ...(variant ? { variant } : {}),
         }));
     }
+    if (wizard.template) {
+        const registry = await loadRegistry();
+        const template = getEntry(registry, wizard.template);
+        const missing = (template?.featureDependencies ?? []).filter((dependency) => !installed.has(dependency));
+        if (template && missing.length === 0) {
+            await runInstallStep(`Applying ${template.label} root page template…`, () => installFeature(actualProjectPath, wizard.template, { yes: true }));
+        }
+    }
     if (needsInstall && !opts.skipInstall) {
         if (opts.verbose) {
             console.log('Installing npm dependencies…');
             await runInstall(actualProjectPath, packageManager, { silent: false });
         }
         else {
-            const sp = p.spinner();
             sp.start('Installing npm dependencies…');
             await runInstall(actualProjectPath, packageManager, { silent: true });
             sp.stop('Dependencies installed.');
@@ -270,6 +342,13 @@ export async function runGenerationFromWizardConfig(projectPath, wizard, opts =
     if (opts.beforePostInstall) {
         await opts.beforePostInstall(actualProjectPath);
     }
+    const pmRunDev = packageManager === 'yarn'
+        ? 'yarn dev'
+        : packageManager === 'pnpm'
+            ? 'pnpm dev'
+            : packageManager === 'bun'
+                ? 'bun dev'
+                : 'npm run dev';
     const config = await readConfig(actualProjectPath);
     if (config && allPostInstall.length > 0) {
         const detectedStructure = detectProjectStructure(actualProjectPath);
@@ -279,25 +358,44 @@ export async function runGenerationFromWizardConfig(projectPath, wizard, opts =
             structure: detectedStructure,
             config,
         };
-        await executePostInstallSteps(actualProjectPath, allPostInstall, ctx, { skipCommands: opts.skipInstall, skipNextSteps: opts.skipNextSteps });
+        await executePostInstallSteps(actualProjectPath, allPostInstall, ctx, {
+            skipCommands: opts.skipInstall,
+            skipNextSteps: opts.skipNextSteps,
+            setupGuide: {
+                projectName,
+                preset: wizard.preset,
+                hasDatabase: wizard.modules.includes('database'),
+                runDevCommand: pmRunDev,
+                print: opts.verbose,
+            },
+        });
     }
+    const hasGuide = !opts.skipNextSteps && existsSync(join(actualProjectPath, SETUP_FILE));
     p.outro([
-        'Tailar SaaS project created successfully.',
+        'Tailar project created successfully.',
         '',
         `Project directory: ${projectName}`,
+        `Preset: ${wizard.preset}`,
+        ...(opts.recipeId ? [`Recipe: ${opts.recipeId}`] : []),
         `Modules: ${formatModuleSummary(wizard.modules)}`,
     ].join('\n'));
-    const pmRunDev = packageManager === 'yarn'
-        ? 'yarn dev'
-        : packageManager === 'pnpm'
-            ? 'pnpm dev'
-            : packageManager === 'bun'
-                ? 'bun dev'
-                : 'npm run dev';
     console.log('');
     console.log('Next steps:');
-    console.log(`  • cd ${projectName}`);
-    console.log(`  • ${pmRunDev}`);
+    if (hasGuide) {
+        const steps = [
+            `cd ${projectName}`,
+            `Fill in .env (the variables and where to get them are in ${SETUP_FILE})`,
+            ...(wizard.modules.includes('database') ? ['npx prisma db push'] : []),
+            pmRunDev,
+        ];
+        steps.forEach((step, index) => console.log(`  ${index + 1}. ${step}`));
+        console.log('');
+        console.log(`Setup guide for the modules you picked: ${SETUP_FILE}`);
+    }
+    else {
+        console.log(`  • cd ${projectName}`);
+        console.log(`  • ${pmRunDev}`);
+    }
     return { projectRoot: actualProjectPath, packageManager };
 }
 //# sourceMappingURL=clack-wizard.js.map