create-propelkit 1.0.2 → 1.0.4

package/package.json

@@ -1,31 +1,31 @@
-{
-  "name": "create-propelkit",
-  "version": "1.0.2",
-  "description": "Initialize a PropelKit SaaS project with AI PM",
-  "bin": "./bin/cli.js",
-  "main": "./src/index.js",
-  "type": "commonjs",
-  "files": [
-    "bin",
-    "src"
-  ],
-  "keywords": [
-    "propelkit",
-    "saas",
-    "boilerplate",
-    "india",
-    "razorpay",
-    "supabase"
-  ],
-  "author": "PropelKit",
-  "license": "MIT",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "dependencies": {
-    "chalk": "^4.1.2",
-    "command-exists": "^1.2.9",
-    "inquirer": "^8.2.6",
-    "zod": "^4.3.6"
-  }
-}
+{
+  "name": "create-propelkit",
+  "version": "1.0.4",
+  "description": "Initialize a PropelKit SaaS project with AI PM",
+  "bin": "./bin/cli.js",
+  "main": "./src/index.js",
+  "type": "commonjs",
+  "files": [
+    "bin",
+    "src"
+  ],
+  "keywords": [
+    "propelkit",
+    "saas",
+    "boilerplate",
+    "india",
+    "razorpay",
+    "supabase"
+  ],
+  "author": "PropelKit",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "command-exists": "^1.2.9",
+    "inquirer": "^8.2.6",
+    "zod": "^4.3.6"
+  }
+}

package/src/blueprint-manager.js

@@ -0,0 +1,144 @@
+const fs = require('fs');
+const path = require('path');
+const chalk = require('chalk');
+
+/**
+ * Blueprint schema (for reference):
+ * {
+ *   name: string,
+ *   createdAt: string (ISO),
+ *   setupVersion: string,
+ *   tier: 'starter' | 'pro',
+ *   paymentProcessor: 'stripe' | 'razorpay' | 'both',
+ *   envVarsReady: boolean,
+ *   stripeCLIInstalled: boolean,
+ *   // ... other fields (colorScheme, visualStyle, etc.)
+ * }
+ */
+
+/**
+ * Read blueprint.json from project directory
+ * @param {string} projectDir - Project directory path
+ * @returns {object|null} Blueprint object or null if not found
+ */
+function readBlueprint(projectDir) {
+  const blueprintPath = path.join(projectDir, 'blueprint.json');
+  if (!fs.existsSync(blueprintPath)) {
+    return null;
+  }
+  try {
+    return JSON.parse(fs.readFileSync(blueprintPath, 'utf-8'));
+  } catch (err) {
+    console.log(chalk.yellow('Warning: Could not parse blueprint.json'));
+    return null;
+  }
+}
+
+/**
+ * Write blueprint.json to project directory
+ * @param {string} projectDir - Project directory path
+ * @param {object} blueprint - Blueprint object to write
+ */
+function writeBlueprint(projectDir, blueprint) {
+  const blueprintPath = path.join(projectDir, 'blueprint.json');
+  fs.writeFileSync(blueprintPath, JSON.stringify(blueprint, null, 2) + '\n');
+  console.log(chalk.dim('Updated blueprint.json'));
+}
+
+/**
+ * Update blueprint.json with new fields (merge, not replace)
+ * @param {string} projectDir - Project directory path
+ * @param {object} updates - Fields to update/add
+ * @returns {object} Updated blueprint
+ */
+function updateBlueprint(projectDir, updates) {
+  const existing = readBlueprint(projectDir) || {};
+  const updated = { ...existing, ...updates };
+  writeBlueprint(projectDir, updated);
+  return updated;
+}
+
+/**
+ * Write payment API keys to .env.local
+ * Only writes keys that were provided (processor-specific)
+ * @param {string} projectDir - Project directory path
+ * @param {object} paymentConfig - Payment configuration with keys
+ */
+function writePaymentEnvVars(projectDir, paymentConfig) {
+  if (!paymentConfig || !paymentConfig.hasKeys || !paymentConfig.keys) {
+    return; // No keys to write
+  }
+
+  const envPath = path.join(projectDir, '.env.local');
+  let envContent = '';
+
+  // Read existing .env.local if it exists
+  if (fs.existsSync(envPath)) {
+    envContent = fs.readFileSync(envPath, 'utf-8');
+    if (!envContent.endsWith('\n')) {
+      envContent += '\n';
+    }
+  }
+
+  const keys = paymentConfig.keys;
+  const processor = paymentConfig.processor;
+
+  // Add Stripe keys if provided
+  if ((processor === 'stripe' || processor === 'both') && keys.stripeSecretKey) {
+    envContent += `\n# Stripe (added by setup wizard)\n`;
+    envContent += `STRIPE_SECRET_KEY=${keys.stripeSecretKey}\n`;
+    if (keys.stripePublishableKey) {
+      envContent += `NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=${keys.stripePublishableKey}\n`;
+    }
+    if (keys.stripeWebhookSecret) {
+      envContent += `STRIPE_WEBHOOK_SECRET=${keys.stripeWebhookSecret}\n`;
+    }
+  }
+
+  // Add Razorpay keys if provided
+  if ((processor === 'razorpay' || processor === 'both') && keys.razorpayKeyId) {
+    envContent += `\n# Razorpay (added by setup wizard)\n`;
+    envContent += `NEXT_PUBLIC_RAZORPAY_KEY_ID=${keys.razorpayKeyId}\n`;
+    if (keys.razorpayKeySecret) {
+      envContent += `RAZORPAY_KEY_SECRET=${keys.razorpayKeySecret}\n`;
+    }
+    if (keys.razorpayWebhookSecret) {
+      envContent += `RAZORPAY_WEBHOOK_SECRET=${keys.razorpayWebhookSecret}\n`;
+    }
+  }
+
+  fs.writeFileSync(envPath, envContent);
+  console.log(chalk.dim('Updated .env.local with payment keys'));
+}
+
+/**
+ * Ensure blueprint has required payment fields
+ * @param {string} projectDir - Project directory path
+ * @param {object} paymentConfig - Payment configuration from wizard
+ * @param {string} tier - License tier (starter/pro)
+ */
+function persistPaymentConfig(projectDir, paymentConfig, tier) {
+  if (!paymentConfig) {
+    // Starter tier or no payment config - just set tier
+    updateBlueprint(projectDir, { tier });
+    return;
+  }
+
+  updateBlueprint(projectDir, {
+    tier,
+    paymentProcessor: paymentConfig.processor,
+    envVarsReady: paymentConfig.hasKeys,
+    stripeCLIInstalled: paymentConfig.stripeCLIInstalled || false
+  });
+
+  // Write env vars if keys provided
+  writePaymentEnvVars(projectDir, paymentConfig);
+}
+
+module.exports = {
+  readBlueprint,
+  writeBlueprint,
+  updateBlueprint,
+  persistPaymentConfig,
+  writePaymentEnvVars
+};

package/src/cli-detector.js

@@ -1,5 +1,6 @@
 const commandExists = require('command-exists');
 const inquirer = require('inquirer');
+const os = require('os');
 
 const CLI_DEFINITIONS = [
   {
@@ -22,6 +23,18 @@ const CLI_DEFINITIONS = [
     installUrl: 'https://cli.github.com/',
     required: false,
     benefit: 'Enables automatic repo creation and commits'
+  },
+  {
+    name: 'stripe',
+    label: 'Stripe CLI',
+    installUrl: {
+      win32: 'https://docs.stripe.com/stripe-cli#install',
+      darwin: 'brew install stripe/stripe-cli/stripe',
+      linux: 'https://docs.stripe.com/stripe-cli#install'
+    },
+    required: false,
+    benefit: 'Enables AI PM to auto-create Stripe products and prices',
+    displayInInitial: false // Not shown in initial CLI detection
   }
 ];
 
@@ -95,10 +108,77 @@ function getCLIByName(clis, name) {
   return clis.find(cli => cli.name === name);
 }
 
+/**
+ * Detect Stripe CLI on-demand after payment processor selection
+ * @param {string} paymentProcessor - 'stripe', 'razorpay', or 'both'
+ * @returns {Promise<{required: boolean, installed: boolean}>}
+ */
+async function detectStripeCLI(paymentProcessor) {
+  // Stripe CLI not required for Razorpay-only projects
+  if (paymentProcessor === 'razorpay') {
+    return { required: false, installed: true };
+  }
+
+  // Stripe or both - detect Stripe CLI
+  const installed = await commandExists('stripe')
+    .then(() => true)
+    .catch(() => false);
+
+  return { required: true, installed };
+}
+
+/**
+ * Display Stripe CLI installation guidance with platform-specific instructions
+ * @param {object} chalk - Chalk instance for styling
+ * @returns {Promise<boolean>} - Whether user wants to continue without Stripe CLI
+ */
+async function displayStripeGuidance(chalk) {
+  const platform = os.platform();
+
+  console.log('');
+  console.log(chalk.yellow.bold('⚠ Stripe CLI Not Found'));
+  console.log(chalk.dim('-'.repeat(50)));
+  console.log('');
+  console.log('The AI PM can automatically create Stripe products and prices');
+  console.log('if the Stripe CLI is installed and authenticated.');
+  console.log('');
+  console.log(chalk.cyan.bold('Installation:'));
+
+  if (platform === 'win32') {
+    console.log(chalk.white('  Windows (via Scoop):'));
+    console.log(chalk.dim('    scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git'));
+    console.log(chalk.dim('    scoop install stripe'));
+  } else if (platform === 'darwin') {
+    console.log(chalk.white('  macOS (via Homebrew):'));
+    console.log(chalk.dim('    brew install stripe/stripe-cli/stripe'));
+  } else {
+    console.log(chalk.white('  Linux:'));
+    console.log(chalk.dim('    See: https://docs.stripe.com/stripe-cli#install'));
+  }
+
+  console.log('');
+  console.log(chalk.cyan.bold('After installation:'));
+  console.log(chalk.dim('  stripe login'));
+  console.log('');
+
+  const { continueWithout } = await inquirer.prompt([
+    {
+      type: 'confirm',
+      name: 'continueWithout',
+      message: 'Continue without Stripe CLI? (You can configure manually later)',
+      default: true
+    }
+  ]);
+
+  return continueWithout;
+}
+
 module.exports = {
   detectCLIs,
   displayCLIStatus,
   askGitHubConnection,
   getCLIByName,
+  detectStripeCLI,
+  displayStripeGuidance,
   CLI_DEFINITIONS
 };

package/src/index.js

@@ -1,136 +1,133 @@
-const chalk = require('chalk');
-const path = require('path');
-const fs = require('fs');
-const inquirer = require('inquirer');
-const { detectCLIs, displayCLIStatus, getCLIByName, askGitHubConnection } = require('./cli-detector');
-const { handleScenario } = require('./scenarios');
-const { runDesignFlow } = require('./design-flow');
-const { runSetupWizard } = require('./setup-wizard');
-const { launchClaude } = require('./launcher');
-const { validateLicense } = require('./license-validator');
-const messages = require('./messages');
-
-async function main() {
-  // Step 1: Welcome
-  messages.welcome();
-
-  // Step 2: LICENSE VALIDATION (first thing after welcome)
-  console.log('');
-  const { licenseKey } = await inquirer.prompt([
-    {
-      type: 'input',
-      name: 'licenseKey',
-      message: 'License key:',
-      validate: input => input.trim() ? true : 'License key is required'
-    }
-  ]);
-
-  console.log(chalk.dim('Validating license...'));
-  const validation = await validateLicense(licenseKey.trim());
-
-  if (!validation.valid) {
-    messages.licenseInvalid(validation.message);
-    process.exit(1);
-  }
-
-  const tier = validation.tier; // 'starter' or 'pro'
-
-  if (tier === 'starter') {
-    messages.starterLicenseValid();
-  } else {
-    messages.proLicenseValid();
-  }
-
-  // Step 3: Detect CLIs
-  messages.detectingCLIs();
-  const clis = await detectCLIs();
-  displayCLIStatus(clis, chalk);
-
-  // Step 4: Check for Claude Code (required for PRO only)
-  const claudeCli = getCLIByName(clis, 'claude');
-  if (tier === 'pro' && !claudeCli.installed) {
-    messages.claudeRequired(claudeCli.installUrl);
-    process.exit(1);
-  }
-
-  // Step 5: Show benefits for missing optional CLIs
-  const supabaseCli = getCLIByName(clis, 'supabase');
-  const ghCli = getCLIByName(clis, 'gh');
-
-  if (!supabaseCli.installed) {
-    messages.supabaseBenefits();
-  }
-
-  if (!ghCli.installed) {
-    messages.githubBenefits();
-  }
-
-  // Step 6: GitHub connection (for Pro tier, or if user wants it for Starter)
-  const useGitHub = tier === 'pro' ? await askGitHubConnection(ghCli, chalk) : false;
-
-  // Step 7: Clone scenario (pass tier first)
-  let projectDir;
-  try {
-    projectDir = await handleScenario(tier, clis, useGitHub);
-  } catch (error) {
-    if (error.message === 'Aborted by user') {
-      console.log('');
-      console.log(chalk.dim('Goodbye!'));
-      process.exit(0);
-    }
-    throw error;
-  }
-
-  // Step 8: TIER-SPECIFIC POST-CLONE FLOW
-  if (tier === 'starter') {
-    // Starter: Run setup wizard, then done
-    await runSetupWizard(projectDir);
-    messages.starterWizardComplete();
-  } else {
-    // Pro: Run design flow, then launch Claude Code
-    console.log('');
-    const designResult = await runDesignFlow(
-      path.basename(projectDir),
-      projectDir
-    );
-
-    // Store design result in config.json
-    const configPath = path.join(projectDir, '.planning', 'config.json');
-    let config = {};
-    if (fs.existsSync(configPath)) {
-      config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-    }
-    config.designFlow = designResult;
-
-    const planningDir = path.dirname(configPath);
-    if (!fs.existsSync(planningDir)) {
-      fs.mkdirSync(planningDir, { recursive: true });
-    }
-    fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
-
-    // Launch Claude Code
-    messages.proLaunchingAIPM(projectDir);
-
-    // Give user time to read the instructions
-    await inquirer.prompt([
-      {
-        type: 'input',
-        name: 'continue',
-        message: chalk.dim('Press Enter to launch Claude Code...'),
-      }
-    ]);
-
-    try {
-      await launchClaude(projectDir);
-    } catch (error) {
-      if (error.message === 'CLAUDE_NOT_FOUND') {
-        const claudeInfo = getCLIByName(clis, 'claude');
-        messages.claudeRequired(claudeInfo.installUrl);
-        process.exit(1);
-      }
-      throw error;
-    }
-  }
-}
-
-module.exports = { main };
+const chalk = require('chalk');
+const path = require('path');
+const fs = require('fs');
+const inquirer = require('inquirer');
+const { detectCLIs, displayCLIStatus, getCLIByName, detectStripeCLI, displayStripeGuidance } = require('./cli-detector');
+const { handleScenario } = require('./scenarios');
+const { runSetupWizard } = require('./setup-wizard');
+const { launchClaude } = require('./launcher');
+const { validateLicense } = require('./license-validator');
+const { askPaymentProcessor, askPaymentKeys } = require('./payment-config');
+const messages = require('./messages');
+
+async function main() {
+  // Step 1: Welcome
+  messages.welcome();
+
+  // Step 2: LICENSE VALIDATION
+  console.log('');
+  const { licenseKey } = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'licenseKey',
+      message: 'License key:',
+      validate: input => input.trim() ? true : 'License key is required'
+    }
+  ]);
+
+  console.log(chalk.dim('Validating license...'));
+  const validation = await validateLicense(licenseKey.trim());
+
+  if (!validation.valid) {
+    messages.licenseInvalid(validation.message);
+    process.exit(1);
+  }
+
+  const tier = validation.tier; // 'starter' or 'pro'
+
+  if (tier === 'starter') {
+    messages.starterLicenseValid();
+  } else {
+    messages.proLicenseValid();
+  }
+
+  // Step 3: Detect CLIs (quick check)
+  messages.detectingCLIs();
+  const clis = await detectCLIs();
+  displayCLIStatus(clis, chalk);
+
+  // Step 4: Check for Claude Code (required for PRO only)
+  const claudeCli = getCLIByName(clis, 'claude');
+  if (tier === 'pro' && !claudeCli.installed) {
+    messages.claudeRequired(claudeCli.installUrl);
+    process.exit(1);
+  }
+
+  // Step 4.5: Payment configuration (PRO only)
+  let paymentConfig = null;
+  if (tier === 'pro') {
+    messages.paymentProcessorPrompt();
+    const processor = await askPaymentProcessor();
+
+    // Detect Stripe CLI if Stripe is selected
+    const stripeCLI = await detectStripeCLI(processor);
+    if (stripeCLI.required && !stripeCLI.installed) {
+      const continueWithout = await displayStripeGuidance(chalk);
+      if (!continueWithout) {
+        console.log('');
+        console.log(chalk.dim('Setup cancelled. Install Stripe CLI and try again.'));
+        process.exit(0);
+      }
+    }
+
+    const keysResult = await askPaymentKeys(processor);
+
+    paymentConfig = {
+      processor,
+      hasKeys: keysResult.hasKeys,
+      keys: keysResult.keys,
+      stripeCLIInstalled: stripeCLI.installed
+    };
+
+    if (keysResult.hasKeys) {
+      messages.paymentKeysReceived(processor);
+    } else {
+      messages.paymentKeysSkipped();
+    }
+  }
+
+  // Step 5: Clone scenario
+  let projectDir;
+  try {
+    projectDir = await handleScenario(tier, clis, false, paymentConfig); // useGitHub = false, AI PM will handle
+  } catch (error) {
+    if (error.message === 'Aborted by user') {
+      console.log('');
+      console.log(chalk.dim('Goodbye!'));
+      process.exit(0);
+    }
+    throw error;
+  }
+
+  // Step 6: TIER-SPECIFIC POST-CLONE FLOW
+  if (tier === 'starter') {
+    // Starter: Run setup wizard, then done
+    await runSetupWizard(projectDir);
+    messages.starterWizardComplete();
+  } else {
+    // Pro: Launch Claude Code directly - AI PM handles everything
+    messages.proLaunchingAIPM(projectDir);
+
+    // Give user time to read the instructions
+    await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'continue',
+        message: chalk.dim('Press Enter to launch Claude Code...'),
+      }
+    ]);
+
+    try {
+      await launchClaude(projectDir);
+    } catch (error) {
+      if (error.message === 'CLAUDE_NOT_FOUND') {
+        const claudeInfo = getCLIByName(clis, 'claude');
+        messages.claudeRequired(claudeInfo.installUrl);
+        process.exit(1);
+      }
+      throw error;
+    }
+  }
+}
+
+module.exports = { main };

package/src/launcher.js

@@ -1,43 +1,43 @@
-const { spawn } = require('child_process');
-const path = require('path');
-const messages = require('./messages');
-
-/**
- * Launch Claude Code in the specified directory
- * @param {string} projectDir - Absolute path to project directory
- * @param {object} options - Launch options
- * @returns {Promise<void>}
- */
-function launchClaude(projectDir, _options = {}) {
-  return new Promise((resolve, reject) => {
-    const resolvedDir = path.resolve(projectDir);
-
-    messages.launchingClaude(resolvedDir);
-
-    // Launch with the /propelkit:new-project command pre-filled
-    const claude = spawn('claude', ['/propelkit:new-project'], {
-      cwd: resolvedDir,
-      stdio: 'inherit',  // User sees Claude's I/O directly
-      shell: true        // Required for Windows compatibility
-    });
-
-    claude.on('error', (err) => {
-      if (err.code === 'ENOENT') {
-        reject(new Error('CLAUDE_NOT_FOUND'));
-      } else {
-        reject(new Error(`Failed to launch Claude Code: ${err.message}`));
-      }
-    });
-
-    claude.on('exit', (code) => {
-      if (code === 0) {
-        resolve();
-      } else {
-        // Non-zero exit is fine - user may have quit normally
-        resolve();
-      }
-    });
-  });
-}
-
-module.exports = { launchClaude };
+const { spawn } = require('child_process');
+const path = require('path');
+const messages = require('./messages');
+
+/**
+ * Launch Claude Code in the specified directory
+ * @param {string} projectDir - Absolute path to project directory
+ * @param {object} options - Launch options
+ * @returns {Promise<void>}
+ */
+function launchClaude(projectDir, _options = {}) {
+  return new Promise((resolve, reject) => {
+    const resolvedDir = path.resolve(projectDir);
+
+    messages.launchingClaude(resolvedDir);
+
+    // Launch with the /propelkit:new-project command pre-filled
+    const claude = spawn('claude', ['/propelkit:new-project'], {
+      cwd: resolvedDir,
+      stdio: 'inherit',  // User sees Claude's I/O directly
+      shell: true        // Required for Windows compatibility
+    });
+
+    claude.on('error', (err) => {
+      if (err.code === 'ENOENT') {
+        reject(new Error('CLAUDE_NOT_FOUND'));
+      } else {
+        reject(new Error(`Failed to launch Claude Code: ${err.message}`));
+      }
+    });
+
+    claude.on('exit', (code) => {
+      if (code === 0) {
+        resolve();
+      } else {
+        // Non-zero exit is fine - user may have quit normally
+        resolve();
+      }
+    });
+  });
+}
+
+module.exports = { launchClaude };

package/src/messages.js

@@ -1,119 +1,143 @@
-const chalk = require('chalk');
-
-const messages = {
-  welcome: () => {
-    console.log('');
-    console.log(chalk.cyan.bold('PropelKit'));
-    console.log(chalk.dim('AI-powered SaaS boilerplate for India'));
-    console.log('');
-  },
-
-  detectingCLIs: () => {
-    console.log(chalk.dim('Detecting installed tools...'));
-  },
-
-  claudeRequired: (installUrl) => {
-    console.log('');
-    console.log(chalk.red.bold('Claude Code is required to use PropelKit'));
-    console.log('');
-    console.log('PropelKit uses Claude Code as the AI PM to build your project.');
-    console.log('');
-    console.log(chalk.cyan('Install Claude Code:'));
-    console.log(chalk.dim(`  ${installUrl}`));
-    console.log('');
-    console.log('After installing, run this command again.');
-    console.log('');
-  },
-
-  supabaseBenefits: () => {
-    console.log(chalk.cyan('Supabase CLI Benefits:'));
-    console.log(chalk.dim('  - Automatic database migrations after each phase'));
-    console.log(chalk.dim('  - No need to manually copy SQL to Supabase dashboard'));
-    console.log(chalk.dim('  - Local development with supabase start'));
-    console.log('');
-    console.log(chalk.dim('Without Supabase CLI:'));
-    console.log(chalk.dim('  - SQL will be shown inline for you to paste manually'));
-    console.log(chalk.dim('  - Migration files saved to supabase/migrations/'));
-    console.log('');
-  },
-
-  githubBenefits: () => {
-    console.log(chalk.cyan('GitHub CLI Benefits:'));
-    console.log(chalk.dim('  - Automatic repo creation'));
-    console.log(chalk.dim('  - Automatic push after each phase'));
-    console.log(chalk.dim('  - Branch management'));
-    console.log('');
-    console.log(chalk.dim('Without GitHub CLI:'));
-    console.log(chalk.dim('  - Local git commits still happen'));
-    console.log(chalk.dim('  - You push to remote manually'));
-    console.log('');
-  },
-
-  launchingClaude: (projectDir) => {
-    console.log('');
-    console.log(chalk.cyan.bold('Launching Claude Code...'));
-    console.log(chalk.dim(`Directory: ${projectDir}`));
-    console.log('');
-    console.log(chalk.yellow('When Claude Code opens, type:'));
-    console.log(chalk.white.bold('  /propelkit:new-project'));
-    console.log('');
-    console.log(chalk.dim('This starts the AI PM conversation to build your project.'));
-    console.log('');
-  },
-
-  cloneInstructions: (repoUrl, targetDir) => {
-    console.log('');
-    console.log(chalk.cyan('Cloning PropelKit...'));
-    console.log(chalk.dim(`  From: ${repoUrl}`));
-    console.log(chalk.dim(`  To: ${targetDir}`));
-    console.log('');
-  },
-
-  resumeInstructions: (command) => {
-    console.log('');
-    console.log(chalk.yellow('To resume, run:'));
-    console.log(chalk.white.bold(`  ${command}`));
-    console.log('');
-  },
-
-  starterLicenseValid: () => {
-    console.log(chalk.green('License validated: STARTER'));
-    console.log('');
-  },
-
-  proLicenseValid: () => {
-    console.log(chalk.green('License validated: PRO'));
-    console.log('');
-  },
-
-  licenseInvalid: (message) => {
-    console.log('');
-    console.log(chalk.red('License validation failed'));
-    console.log(chalk.dim(message || 'Invalid license key'));
-    console.log('');
-    console.log(`Purchase a license at: ${chalk.cyan('https://propelkit.dev')}`);
-    console.log('');
-  },
-
-  starterWizardComplete: () => {
-    console.log('');
-    console.log(chalk.green.bold('PropelKit Starter is ready!'));
-    console.log('');
-    console.log(chalk.dim('Run these commands to start:'));
-    console.log(chalk.cyan('  npm install'));
-    console.log(chalk.cyan('  npm run dev'));
-    console.log('');
-  },
-
-  proLaunchingAIPM: (projectDir) => {
-    console.log('');
-    console.log(chalk.cyan.bold('Launching AI PM in Claude Code...'));
-    console.log(chalk.dim(`Project: ${projectDir}`));
-    console.log('');
-    console.log(chalk.dim('Claude will start with /propelkit:new-project'));
-    console.log(chalk.dim('Just press Enter to begin the AI PM conversation.'));
-    console.log('');
-  }
-};
-
-module.exports = messages;
+const chalk = require('chalk');
+
+const messages = {
+  welcome: () => {
+    console.log('');
+    console.log(chalk.cyan.bold('PropelKit'));
+    console.log(chalk.dim('AI-powered SaaS boilerplate for India'));
+    console.log('');
+  },
+
+  detectingCLIs: () => {
+    console.log(chalk.dim('Detecting installed tools...'));
+  },
+
+  claudeRequired: (installUrl) => {
+    console.log('');
+    console.log(chalk.red.bold('Claude Code is required to use PropelKit'));
+    console.log('');
+    console.log('PropelKit uses Claude Code as the AI PM to build your project.');
+    console.log('');
+    console.log(chalk.cyan('Install Claude Code:'));
+    console.log(chalk.dim(`  ${installUrl}`));
+    console.log('');
+    console.log('After installing, run this command again.');
+    console.log('');
+  },
+
+  supabaseBenefits: () => {
+    console.log(chalk.cyan('Supabase CLI Benefits:'));
+    console.log(chalk.dim('  - Automatic database migrations after each phase'));
+    console.log(chalk.dim('  - No need to manually copy SQL to Supabase dashboard'));
+    console.log(chalk.dim('  - Local development with supabase start'));
+    console.log('');
+    console.log(chalk.dim('Without Supabase CLI:'));
+    console.log(chalk.dim('  - SQL will be shown inline for you to paste manually'));
+    console.log(chalk.dim('  - Migration files saved to supabase/migrations/'));
+    console.log('');
+  },
+
+  githubBenefits: () => {
+    console.log(chalk.cyan('GitHub CLI Benefits:'));
+    console.log(chalk.dim('  - Automatic repo creation'));
+    console.log(chalk.dim('  - Automatic push after each phase'));
+    console.log(chalk.dim('  - Branch management'));
+    console.log('');
+    console.log(chalk.dim('Without GitHub CLI:'));
+    console.log(chalk.dim('  - Local git commits still happen'));
+    console.log(chalk.dim('  - You push to remote manually'));
+    console.log('');
+  },
+
+  launchingClaude: (projectDir) => {
+    console.log('');
+    console.log(chalk.cyan.bold('Launching Claude Code...'));
+    console.log(chalk.dim(`Directory: ${projectDir}`));
+    console.log('');
+    console.log(chalk.yellow('When Claude Code opens, type:'));
+    console.log(chalk.white.bold('  /propelkit:new-project'));
+    console.log('');
+    console.log(chalk.dim('This starts the AI PM conversation to build your project.'));
+    console.log('');
+  },
+
+  cloneInstructions: (repoUrl, targetDir) => {
+    console.log('');
+    console.log(chalk.cyan('Cloning PropelKit...'));
+    console.log(chalk.dim(`  From: ${repoUrl}`));
+    console.log(chalk.dim(`  To: ${targetDir}`));
+    console.log('');
+  },
+
+  resumeInstructions: (command) => {
+    console.log('');
+    console.log(chalk.yellow('To resume, run:'));
+    console.log(chalk.white.bold(`  ${command}`));
+    console.log('');
+  },
+
+  starterLicenseValid: () => {
+    console.log(chalk.green('License validated: STARTER'));
+    console.log('');
+  },
+
+  proLicenseValid: () => {
+    console.log(chalk.green('License validated: PRO'));
+    console.log('');
+  },
+
+  licenseInvalid: (message) => {
+    console.log('');
+    console.log(chalk.red('License validation failed'));
+    console.log(chalk.dim(message || 'Invalid license key'));
+    console.log('');
+    console.log(`Purchase a license at: ${chalk.cyan('https://propelkit.dev')}`);
+    console.log('');
+  },
+
+  starterWizardComplete: () => {
+    console.log('');
+    console.log(chalk.green.bold('PropelKit Starter is ready!'));
+    console.log('');
+    console.log(chalk.dim('Run these commands to start:'));
+    console.log(chalk.cyan('  npm install'));
+    console.log(chalk.cyan('  npm run dev'));
+    console.log('');
+  },
+
+  proLaunchingAIPM: (projectDir) => {
+    console.log('');
+    console.log(chalk.cyan.bold('Launching AI PM in Claude Code...'));
+    console.log(chalk.dim(`Project: ${projectDir}`));
+    console.log('');
+    console.log(chalk.dim('Claude will start with /propelkit:new-project'));
+    console.log(chalk.dim('Just press Enter to begin the AI PM conversation.'));
+    console.log('');
+  },
+
+  paymentProcessorPrompt: () => {
+    console.log('');
+    console.log(chalk.cyan.bold('Payment Configuration'));
+    console.log(chalk.dim('-'.repeat(50)));
+    console.log('');
+    console.log(chalk.dim('PropelKit supports multiple payment processors:'));
+    console.log(chalk.dim('  - Stripe for international payments'));
+    console.log(chalk.dim('  - Razorpay for India (INR + UPI)'));
+    console.log(chalk.dim('  - Both for global SaaS with auto-routing'));
+    console.log('');
+  },
+
+  paymentKeysSkipped: () => {
+    console.log('');
+    console.log(chalk.dim('API keys skipped. AI PM will generate .env template.'));
+    console.log('');
+  },
+
+  paymentKeysReceived: (processor) => {
+    console.log('');
+    console.log(chalk.green(`${processor} keys saved.`));
+    console.log('');
+  }
+};
+
+module.exports = messages;

package/src/payment-config.js

@@ -0,0 +1,119 @@
+const inquirer = require('inquirer');
+const chalk = require('chalk');
+
+/**
+ * Ask user to select payment processor
+ * @returns {Promise<'stripe'|'razorpay'|'both'>}
+ */
+async function askPaymentProcessor() {
+  const { processor } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'processor',
+      message: 'Which payment processor?',
+      choices: [
+        {
+          name: `${chalk.cyan('Stripe')} - International (USD, EUR, GBP)`,
+          value: 'stripe'
+        },
+        {
+          name: `${chalk.cyan('Razorpay')} - India (INR, UPI)`,
+          value: 'razorpay'
+        },
+        {
+          name: `${chalk.cyan('Both')} - Global with auto-routing`,
+          value: 'both'
+        }
+      ]
+    }
+  ]);
+
+  return processor;
+}
+
+/**
+ * Ask user for payment processor API keys
+ * @param {string} processor - 'stripe' | 'razorpay' | 'both'
+ * @returns {Promise<{hasKeys: boolean, keys: object|null}>}
+ */
+async function askPaymentKeys(processor) {
+  // First, ask if user has keys ready
+  const { hasKeys } = await inquirer.prompt([
+    {
+      type: 'confirm',
+      name: 'hasKeys',
+      message: `Do you have ${processor === 'both' ? 'your' : processor} API keys ready?`,
+      default: false
+    }
+  ]);
+
+  if (!hasKeys) {
+    return { hasKeys: false, keys: null };
+  }
+
+  // User has keys - prompt based on processor selection
+  const questions = [];
+
+  // Stripe keys (if needed)
+  if (processor === 'stripe' || processor === 'both') {
+    questions.push(
+      {
+        type: 'input',
+        name: 'STRIPE_SECRET_KEY',
+        message: 'Stripe Secret Key:',
+        when: () => processor === 'stripe' || processor === 'both',
+        validate: input => input.trim() ? true : 'Stripe Secret Key is required'
+      },
+      {
+        type: 'input',
+        name: 'STRIPE_PUBLISHABLE_KEY',
+        message: 'Stripe Publishable Key:',
+        when: () => processor === 'stripe' || processor === 'both',
+        validate: input => input.trim() ? true : 'Stripe Publishable Key is required'
+      },
+      {
+        type: 'input',
+        name: 'STRIPE_WEBHOOK_SECRET',
+        message: 'Stripe Webhook Secret (optional, can set up later):',
+        when: () => processor === 'stripe' || processor === 'both',
+        default: ''
+      }
+    );
+  }
+
+  // Razorpay keys (if needed)
+  if (processor === 'razorpay' || processor === 'both') {
+    questions.push(
+      {
+        type: 'input',
+        name: 'RAZORPAY_KEY_ID',
+        message: 'Razorpay Key ID:',
+        when: () => processor === 'razorpay' || processor === 'both',
+        validate: input => input.trim() ? true : 'Razorpay Key ID is required'
+      },
+      {
+        type: 'input',
+        name: 'RAZORPAY_KEY_SECRET',
+        message: 'Razorpay Key Secret:',
+        when: () => processor === 'razorpay' || processor === 'both',
+        validate: input => input.trim() ? true : 'Razorpay Key Secret is required'
+      },
+      {
+        type: 'input',
+        name: 'RAZORPAY_WEBHOOK_SECRET',
+        message: 'Razorpay Webhook Secret (optional, can set up later):',
+        when: () => processor === 'razorpay' || processor === 'both',
+        default: ''
+      }
+    );
+  }
+
+  const keys = await inquirer.prompt(questions);
+
+  return { hasKeys: true, keys };
+}
+
+module.exports = {
+  askPaymentProcessor,
+  askPaymentKeys
+};

package/src/scenarios.js

@@ -5,6 +5,7 @@ const inquirer = require('inquirer');
 const chalk = require('chalk');
 const _messages = require('./messages'); // Reserved for future use
 const { REPOS } = require('./config');
+const { persistPaymentConfig } = require('./blueprint-manager');
 
 /**
  * Ask user which scenario applies
@@ -36,9 +37,10 @@ async function askScenario() {
  * @param {string} tier - License tier ('starter' or 'pro')
  * @param {object} clis - CLI detection results
  * @param {boolean} useGitHub - Whether user wants GitHub integration (from CLI-03 prompt)
+ * @param {object} paymentConfig - Payment configuration from wizard (optional)
  * @returns {Promise<string>} - Path to project directory
  */
-async function handleFreshStart(tier, clis, useGitHub) {
+async function handleFreshStart(tier, clis, useGitHub, paymentConfig = null) {
   // Ask for project name/directory
   const { projectName } = await inquirer.prompt([
     {
@@ -87,6 +89,9 @@ async function handleFreshStart(tier, clis, useGitHub) {
     // Write initial config with CLI availability, useGitHub preference, and tier
     await writeInitialConfig(targetDir, clis, useGitHub, tier);
 
+    // Persist payment configuration to blueprint.json
+    persistPaymentConfig(targetDir, paymentConfig, tier);
+
     return targetDir;
   } catch (error) {
     throw new Error(`Failed to clone PropelKit: ${error.message}`);
@@ -98,9 +103,10 @@ async function handleFreshStart(tier, clis, useGitHub) {
  * @param {string} tier - License tier ('starter' or 'pro')
  * @param {object} clis - CLI detection results
  * @param {boolean} useGitHub - Whether user wants GitHub integration (from CLI-03 prompt)
+ * @param {object} paymentConfig - Payment configuration from wizard (optional)
  * @returns {Promise<string>} - Path to project directory
  */
-async function handleExistingClone(tier, clis, useGitHub) {
+async function handleExistingClone(tier, clis, useGitHub, paymentConfig = null) {
   const currentDir = process.cwd();
 
   // Check if this looks like a PropelKit project
@@ -137,6 +143,9 @@ async function handleExistingClone(tier, clis, useGitHub) {
   // Write config with CLI availability, useGitHub preference, and tier
   await writeInitialConfig(currentDir, clis, useGitHub, tier);
 
+  // Persist payment configuration to blueprint.json
+  persistPaymentConfig(currentDir, paymentConfig, tier);
+
   return currentDir;
 }
 
@@ -197,15 +206,16 @@ async function writeInitialConfig(projectDir, clis, useGitHub, tier) {
  * @param {string} tier - License tier ('starter' or 'pro')
  * @param {object[]} clis - CLI detection results
  * @param {boolean} useGitHub - Whether user wants GitHub integration (from CLI-03 prompt)
+ * @param {object} paymentConfig - Payment configuration from wizard (optional)
  * @returns {Promise<string>} - Path to project directory
  */
-async function handleScenario(tier, clis, useGitHub) {
+async function handleScenario(tier, clis, useGitHub, paymentConfig = null) {
   const scenario = await askScenario();
 
   if (scenario === 'fresh') {
-    return handleFreshStart(tier, clis, useGitHub);
+    return handleFreshStart(tier, clis, useGitHub, paymentConfig);
   } else {
-    return handleExistingClone(tier, clis, useGitHub);
+    return handleExistingClone(tier, clis, useGitHub, paymentConfig);
   }
 }