create-propelkit 1.0.4 → 1.0.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-propelkit",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "Initialize a PropelKit SaaS project with AI PM",
   "bin": "./bin/cli.js",
   "main": "./src/index.js",

package/src/config-generator.js

@@ -0,0 +1,68 @@
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Generates vercel.json configuration file for Vercel deployment
+ * @param {string} projectDir - Absolute path to project directory
+ * @param {object} chalk - Chalk instance for colored output
+ */
+function generateVercelJson(projectDir, chalk) {
+  const vercelJsonPath = path.join(projectDir, 'vercel.json');
+
+  // Check if vercel.json already exists
+  if (fs.existsSync(vercelJsonPath)) {
+    console.log(chalk.dim('  vercel.json exists, skipping'));
+    return;
+  }
+
+  const config = {
+    "$schema": "https://openapi.vercel.sh/vercel.json",
+    "framework": "nextjs",
+    "buildCommand": "npm run build",
+    "installCommand": "npm ci"
+  };
+
+  fs.writeFileSync(vercelJsonPath, JSON.stringify(config, null, 2) + '\n');
+  console.log(chalk.dim('  Created vercel.json'));
+}
+
+/**
+ * Generates railway.toml configuration file for Railway deployment
+ * @param {string} projectDir - Absolute path to project directory
+ * @param {object} chalk - Chalk instance for colored output
+ */
+function generateRailwayToml(projectDir, chalk) {
+  const railwayTomlPath = path.join(projectDir, 'railway.toml');
+
+  // Check if railway.toml already exists
+  if (fs.existsSync(railwayTomlPath)) {
+    console.log(chalk.dim('  railway.toml exists, skipping'));
+    return;
+  }
+
+  const config = `[build]
+builder = "NIXPACKS"
+
+[build.nixpacksPlan.phases.setup]
+nixPkgs = ["nodejs_20"]
+
+[build.nixpacksPlan.phases.install]
+cmds = ["npm ci"]
+
+[build.nixpacksPlan.phases.build]
+cmds = ["npm run build"]
+
+[deploy]
+startCommand = "npm run start"
+restartPolicyType = "on_failure"
+restartPolicyMaxRetries = 3
+`;
+
+  fs.writeFileSync(railwayTomlPath, config);
+  console.log(chalk.dim('  Created railway.toml'));
+}
+
+module.exports = {
+  generateVercelJson,
+  generateRailwayToml
+};

package/src/config.js

@@ -9,8 +9,8 @@ const API_ENDPOINTS = {
 };
 
 const LICENSE_PATTERNS = {
-  // PK-STARTER-2026-XXXXXX or PK-PRO-2026-XXXXXX
-  format: /^PK-(STARTER|PRO|AGENCY)-\d{4}-[A-Z0-9]{6}$/
+  // PK-STARTER-2026-XXXXXX (6 chars) or PK-PRO-2026-75AA835B178345DD (16 chars)
+  format: /^PK-(STARTER|PRO|AGENCY)-\d{4}-[A-Z0-9]{6,16}$/
 };
 
 const TIMEOUTS = {

package/src/deploy-command.js

@@ -0,0 +1,220 @@
+const inquirer = require('inquirer');
+const chalk = require('chalk');
+const path = require('path');
+const fs = require('fs');
+const { detectPlatformCLI } = require('./platform-detector');
+const { readEnvFile, getRequiredEnvVars, promptMissingEnvVars } = require('./env-mapper');
+const { generateVercelJson, generateRailwayToml } = require('./config-generator');
+const { checkVercelAuth, deployToVercel } = require('./vercel-deployer');
+const { deployToRailway } = require('./railway-deployer');
+const { displayWebhookGuidance } = require('./webhook-guidance');
+
+/**
+ * Main deployment command orchestrator
+ * Handles platform selection, CLI detection, env vars, and deployment
+ */
+async function deployCommand() {
+  // Step 1: Determine project directory
+  const projectDir = process.cwd();
+
+  // Step 2: Verify PropelKit project
+  const featuresPath = path.join(projectDir, 'src', 'config', 'features.ts');
+  if (!fs.existsSync(featuresPath)) {
+    throw new Error('Not a PropelKit project (src/config/features.ts not found)');
+  }
+
+  // Step 3: Read payment processor from features.ts
+  const featuresContent = fs.readFileSync(featuresPath, 'utf-8');
+  const processorMatch = featuresContent.match(/paymentProcessor:\s*['"](\w+)['"]/);
+  const paymentProcessor = processorMatch ? processorMatch[1] : 'razorpay';
+
+  // Step 4: Display header
+  console.log('');
+  console.log(chalk.cyan.bold('🚀 PropelKit Deployment'));
+  console.log(chalk.dim('Deploy your SaaS to the cloud'));
+  console.log('');
+
+  // Step 5: Platform selection prompt
+  const { platform } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'platform',
+      message: 'Select deployment platform:',
+      choices: [
+        { name: 'Vercel (Recommended)', value: 'vercel' },
+        { name: 'Railway', value: 'railway' },
+        { name: 'Manual (config files only)', value: 'manual' }
+      ]
+    }
+  ]);
+
+  // Step 6: Handle manual deployment
+  if (platform === 'manual') {
+    await handleManualDeploy(projectDir, paymentProcessor, chalk);
+    return;
+  }
+
+  // Step 7: CLI detection
+  const cliDetection = await detectPlatformCLI(platform);
+  if (!cliDetection.installed) {
+    console.log('');
+    console.log(chalk.red(`${cliDetection.config.label} is not installed.`));
+    console.log('');
+    console.log(chalk.yellow('Installation options:'));
+    Object.entries(cliDetection.config.installCommand).forEach(([method, command]) => {
+      console.log(chalk.dim(`  ${method}: ${command}`));
+    });
+    console.log('');
+    console.log(chalk.dim(`Documentation: ${cliDetection.config.docs}`));
+    console.log('');
+    process.exit(1);
+  }
+
+  // Step 8: Vercel authentication check
+  if (platform === 'vercel') {
+    const authCheck = await checkVercelAuth();
+    if (!authCheck.authenticated) {
+      console.log('');
+      console.log(chalk.red('Not authenticated with Vercel CLI.'));
+      console.log('');
+      console.log(chalk.yellow('Please run:'));
+      console.log(chalk.bold('  vercel login'));
+      console.log('');
+      process.exit(1);
+    }
+    console.log('');
+    console.log(chalk.green(`✓ Authenticated as ${authCheck.user}`));
+    console.log('');
+  }
+
+  // Step 9: Environment variables
+  const existingEnvVars = readEnvFile(projectDir) || {};
+  const requiredEnvVars = getRequiredEnvVars(paymentProcessor);
+  const envVars = await promptMissingEnvVars(existingEnvVars, requiredEnvVars, chalk);
+
+  // Step 10: Production confirmation prompt
+  let isProduction = false;
+  if (platform === 'vercel') {
+    const { production } = await inquirer.prompt([
+      {
+        type: 'confirm',
+        name: 'production',
+        message: 'Deploy to production? (No = preview/staging)',
+        default: false
+      }
+    ]);
+    isProduction = production;
+  }
+
+  // Step 11: Execute deployment
+  let deploymentResult;
+  try {
+    if (platform === 'vercel') {
+      deploymentResult = await deployToVercel(projectDir, envVars, isProduction, chalk);
+    } else if (platform === 'railway') {
+      deploymentResult = await deployToRailway(projectDir, envVars, chalk);
+    }
+  } catch (error) {
+    console.log('');
+    console.log(chalk.red('Deployment failed:'));
+    console.log(chalk.red(error.message));
+    console.log('');
+    process.exit(1);
+  }
+
+  // Step 12: Prompt for deployed URL
+  console.log('');
+  const { deployedUrl } = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'deployedUrl',
+      message: 'Enter your deployment URL:',
+      default: 'https://your-app.vercel.app',
+      validate: input => {
+        if (!input.trim()) return 'URL is required';
+        if (!input.startsWith('http')) return 'URL must start with http:// or https://';
+        return true;
+      }
+    }
+  ]);
+
+  // Step 13: Display webhook guidance
+  displayWebhookGuidance(
+    deployedUrl.trim(),
+    paymentProcessor,
+    platform,
+    Object.keys(envVars),
+    chalk
+  );
+}
+
+/**
+ * Handle manual deployment (config file generation only)
+ * @param {string} projectDir - Absolute path to project directory
+ * @param {string} paymentProcessor - Payment processor from features.ts
+ * @param {object} chalk - Chalk instance for colored output
+ */
+async function handleManualDeploy(projectDir, paymentProcessor, chalk) {
+  console.log('');
+  console.log(chalk.cyan('Manual Deployment Setup'));
+  console.log('');
+
+  // Checkbox prompt for config files
+  const { platforms } = await inquirer.prompt([
+    {
+      type: 'checkbox',
+      name: 'platforms',
+      message: 'Generate config files for:',
+      choices: [
+        { name: 'Vercel', value: 'vercel', checked: true },
+        { name: 'Railway', value: 'railway', checked: true }
+      ],
+      validate: input => input.length > 0 ? true : 'Select at least one platform'
+    }
+  ]);
+
+  // Generate selected config files
+  console.log('');
+  console.log(chalk.cyan('Generating configuration files...'));
+  console.log('');
+
+  if (platforms.includes('vercel')) {
+    generateVercelJson(projectDir, chalk);
+  }
+
+  if (platforms.includes('railway')) {
+    generateRailwayToml(projectDir, chalk);
+  }
+
+  // Display manual deployment instructions
+  console.log('');
+  console.log(chalk.yellow.bold('📋 Manual Deployment Steps:'));
+  console.log('');
+  console.log(chalk.white('1. Push your code to GitHub:'));
+  console.log(chalk.dim('   git add .'));
+  console.log(chalk.dim('   git commit -m "Add deployment config"'));
+  console.log(chalk.dim('   git push'));
+  console.log('');
+  console.log(chalk.white('2. Import project in platform dashboard:'));
+  if (platforms.includes('vercel')) {
+    console.log(chalk.dim('   Vercel: https://vercel.com/new'));
+  }
+  if (platforms.includes('railway')) {
+    console.log(chalk.dim('   Railway: https://railway.app/new'));
+  }
+  console.log('');
+  console.log(chalk.white('3. Set environment variables in dashboard:'));
+  const requiredEnvVars = getRequiredEnvVars(paymentProcessor);
+  requiredEnvVars.forEach(key => {
+    console.log(chalk.dim(`   • ${key}`));
+  });
+  console.log('');
+  console.log(chalk.white('4. Deploy from platform dashboard'));
+  console.log('');
+  console.log(chalk.green('✓ Config files generated successfully!'));
+  console.log('');
+}
+
+module.exports = {
+  deployCommand
+};

package/src/env-mapper.js

@@ -0,0 +1,140 @@
+const fs = require('fs');
+const path = require('path');
+const inquirer = require('inquirer');
+
+/**
+ * Reads environment variables from .env.local or .env
+ * @param {string} projectDir - Absolute path to project directory
+ * @returns {object|null} Object with env vars, or null if no file exists
+ */
+function readEnvFile(projectDir) {
+  const envLocalPath = path.join(projectDir, '.env.local');
+  const envPath = path.join(projectDir, '.env');
+
+  let envFilePath = null;
+  if (fs.existsSync(envLocalPath)) {
+    envFilePath = envLocalPath;
+  } else if (fs.existsSync(envPath)) {
+    envFilePath = envPath;
+  } else {
+    return null;
+  }
+
+  const content = fs.readFileSync(envFilePath, 'utf-8');
+  const envVars = {};
+
+  // Simple parser: KEY=VALUE lines
+  content.split('\n').forEach(line => {
+    const trimmed = line.trim();
+
+    // Skip comments and empty lines
+    if (!trimmed || trimmed.startsWith('#')) {
+      return;
+    }
+
+    const equalsIndex = trimmed.indexOf('=');
+    if (equalsIndex === -1) {
+      return;
+    }
+
+    const key = trimmed.substring(0, equalsIndex).trim();
+    const value = trimmed.substring(equalsIndex + 1).trim();
+
+    if (key) {
+      envVars[key] = value;
+    }
+  });
+
+  return envVars;
+}
+
+/**
+ * Gets list of required environment variables based on payment processor
+ * @param {string} paymentProcessor - 'stripe', 'razorpay', or 'both'
+ * @returns {string[]} Array of required env var names
+ */
+function getRequiredEnvVars(paymentProcessor) {
+  const baseVars = [
+    'NEXT_PUBLIC_APP_URL',
+    'NEXT_PUBLIC_SUPABASE_URL',
+    'NEXT_PUBLIC_SUPABASE_ANON_KEY',
+    'SUPABASE_SERVICE_ROLE_KEY',
+    'RESEND_API_KEY',
+    'INNGEST_EVENT_KEY',
+    'INNGEST_SIGNING_KEY'
+  ];
+
+  const stripeVars = [
+    'STRIPE_SECRET_KEY',
+    'NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY',
+    'STRIPE_WEBHOOK_SECRET'
+  ];
+
+  const razorpayVars = [
+    'NEXT_PUBLIC_RAZORPAY_KEY_ID',
+    'RAZORPAY_KEY_SECRET',
+    'RAZORPAY_WEBHOOK_SECRET'
+  ];
+
+  let required = [...baseVars];
+
+  if (paymentProcessor === 'stripe' || paymentProcessor === 'both') {
+    required = required.concat(stripeVars);
+  }
+
+  if (paymentProcessor === 'razorpay' || paymentProcessor === 'both') {
+    required = required.concat(razorpayVars);
+  }
+
+  return required;
+}
+
+/**
+ * Prompts user for missing environment variables
+ * @param {object} existing - Existing env vars from file
+ * @param {string[]} required - Array of required env var names
+ * @param {object} chalk - Chalk instance for colored output
+ * @returns {Promise<object>} Merged object with existing and new env vars
+ */
+async function promptMissingEnvVars(existing, required, chalk) {
+  // Filter for missing vars or vars with placeholder values
+  const missing = required.filter(key => {
+    if (!existing[key]) return true;
+    const value = existing[key];
+    // Check for placeholder values starting with 'your-'
+    if (value.startsWith('your-')) return true;
+    return false;
+  });
+
+  // No missing vars
+  if (missing.length === 0) {
+    return existing;
+  }
+
+  // Display missing vars
+  console.log('');
+  console.log(chalk.yellow('Missing required environment variables:'));
+  missing.forEach(key => {
+    console.log(chalk.yellow(`  - ${key}`));
+  });
+  console.log('');
+
+  // Prompt for each missing var
+  const questions = missing.map(key => ({
+    type: 'input',
+    name: key,
+    message: `${key}:`,
+    validate: input => input.trim() ? true : `${key} is required`
+  }));
+
+  const answers = await inquirer.prompt(questions);
+
+  // Merge existing with new answers
+  return { ...existing, ...answers };
+}
+
+module.exports = {
+  readEnvFile,
+  getRequiredEnvVars,
+  promptMissingEnvVars
+};

package/src/index.js

@@ -8,6 +8,14 @@ const { runSetupWizard } = require('./setup-wizard');
 const { launchClaude } = require('./launcher');
 const { validateLicense } = require('./license-validator');
 const { askPaymentProcessor, askPaymentKeys } = require('./payment-config');
+const { runLovableFlow } = require('./lovable-flow');
+const { generateVercelJson, generateRailwayToml } = require('./config-generator');
+const { readEnvFile, getRequiredEnvVars, promptMissingEnvVars } = require('./env-mapper');
+const { detectPlatformCLI, PLATFORM_CLIS } = require('./platform-detector');
+const { checkVercelAuth, deployToVercel } = require('./vercel-deployer');
+const { deployToRailway } = require('./railway-deployer');
+const { deployCommand } = require('./deploy-command');
+const { displayWebhookGuidance } = require('./webhook-guidance');
 const messages = require('./messages');
 
 async function main() {
@@ -105,7 +113,10 @@ async function main() {
     await runSetupWizard(projectDir);
     messages.starterWizardComplete();
   } else {
-    // Pro: Launch Claude Code directly - AI PM handles everything
+    // Pro: Step 6.1 - Lovable design choice
+    await runLovableFlow(projectDir);
+
+    // Pro: Step 6.2 - Launch Claude Code directly - AI PM handles everything
     messages.proLaunchingAIPM(projectDir);
 
     // Give user time to read the instructions
@@ -130,4 +141,18 @@ async function main() {
   }
 }
 
-module.exports = { main };
+module.exports = {
+  main,
+  generateVercelJson,
+  generateRailwayToml,
+  readEnvFile,
+  getRequiredEnvVars,
+  promptMissingEnvVars,
+  detectPlatformCLI,
+  PLATFORM_CLIS,
+  checkVercelAuth,
+  deployToVercel,
+  deployToRailway,
+  deployCommand,
+  displayWebhookGuidance
+};

package/src/lovable-flow.js

@@ -0,0 +1,167 @@
+/**
+ * Lovable Flow Module
+ *
+ * Handles Lovable UI design approach prompts for CLI wizard.
+ * Called during PRO tier setup, before launching AI PM.
+ *
+ * The CLI only asks a simple question here. The intelligent Lovable prompt
+ * generation happens AFTER the AI PM understands the full project scope
+ * (post-roadmap), inside new-project.md Phase 10.5.
+ */
+
+const inquirer = require('inquirer');
+const chalk = require('chalk');
+const fs = require('fs');
+const path = require('path');
+const { updateBlueprint } = require('./blueprint-manager');
+
+/**
+ * Ask user about Lovable UI design approach
+ * @returns {Promise<'make-new'|'have-existing'|'skip'>}
+ */
+async function askLovableChoice() {
+  console.log('');
+  console.log(chalk.cyan.bold('UI Design'));
+  console.log(chalk.dim('PropelKit can generate a tailored Lovable prompt for your project'));
+  console.log('');
+
+  const { choice } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'choice',
+      message: 'How would you like to handle UI?',
+      choices: [
+        {
+          name: 'Use Lovable - AI PM will craft a perfect prompt after understanding your project',
+          value: 'make-new'
+        },
+        {
+          name: 'I already have Lovable designs - Paste into lovable-designs/ folder',
+          value: 'have-existing'
+        },
+        {
+          name: 'Skip for now - Decide later (you can always add UI anytime)',
+          value: 'skip'
+        }
+      ]
+    }
+  ]);
+
+  return choice;
+}
+
+/**
+ * Display guidance based on Lovable choice
+ * @param {string} choice - 'make-new' | 'have-existing' | 'skip'
+ */
+function displayLovableGuidance(choice) {
+  console.log('');
+
+  if (choice === 'make-new') {
+    console.log(chalk.cyan('Great choice! Here\'s what will happen:'));
+    console.log('');
+    console.log(chalk.dim('  1. AI PM will deeply understand your project first'));
+    console.log(chalk.dim('  2. After planning all features, it generates an intelligent Lovable prompt'));
+    console.log(chalk.dim('  3. The prompt includes every page, feature, and style tailored to your project'));
+    console.log(chalk.dim('  4. You paste it into Lovable, generate UI, then paste output back'));
+    console.log(chalk.dim('  5. AI PM auto-wires everything into your Next.js app'));
+    console.log('');
+    console.log(chalk.dim('Pro tip: Have inspiration screenshots ready - the AI PM will ask for them!'));
+  } else if (choice === 'have-existing') {
+    console.log(chalk.cyan('Paste your Lovable output into lovable-designs/ when ready.'));
+    console.log('');
+    console.log(chalk.dim('The AI PM will auto-wire your designs:'));
+    console.log(chalk.dim('  - Translate React Router to Next.js App Router'));
+    console.log(chalk.dim('  - Connect to Supabase auth and database'));
+    console.log(chalk.dim('  - Wire up payment and email flows'));
+    console.log(chalk.dim('  - Apply your brand config'));
+    console.log('');
+    console.log(chalk.dim('You can paste code before or after AI PM starts.'));
+  } else {
+    console.log(chalk.yellow('No problem! You can add UI anytime.'));
+    console.log('');
+    console.log(chalk.dim('Options when you\'re ready:'));
+    console.log(chalk.dim('  - Run /propelkit:wire-ui to import and wire Lovable designs'));
+    console.log(chalk.dim('  - AI PM can generate a Lovable prompt during any session'));
+    console.log('');
+  }
+}
+
+/**
+ * Create lovable-designs directory in project
+ * @param {string} projectDir - Project directory path
+ */
+function createLovableDesignsDir(projectDir) {
+  const lovableDir = path.join(projectDir, 'lovable-designs');
+  if (!fs.existsSync(lovableDir)) {
+    fs.mkdirSync(lovableDir, { recursive: true });
+
+    // Add README to explain the folder
+    const readmePath = path.join(lovableDir, 'README.md');
+    const readmeContent = `# Lovable Designs
+
+Paste your Lovable-generated UI code here.
+
+## How it works
+
+1. AI PM generates a tailored prompt for your project (after understanding it fully)
+2. You paste the prompt into lovable.dev and generate your UI
+3. Export/download from Lovable and paste the output here
+4. Run \`/propelkit:wire-ui\` to auto-wire everything into your Next.js app
+
+## What the auto-wiring does
+
+- Translates React Router to Next.js App Router
+- Connects components to Supabase auth and database
+- Wires up payment flows (Stripe/Razorpay)
+- Applies your brand config from \`src/config/brand.ts\`
+- Generates an integration report
+
+## Folder structure
+
+Paste your Lovable export maintaining the original structure:
+\`\`\`
+lovable-designs/
++-- src/
+|   +-- components/
+|   +-- pages/
+|   +-- ...
++-- package.json
++-- ...
+\`\`\`
+`;
+    fs.writeFileSync(readmePath, readmeContent);
+
+    console.log(chalk.dim(`Created lovable-designs/ directory`));
+  }
+}
+
+/**
+ * Persist Lovable choice to blueprint.json
+ * @param {string} projectDir - Project directory path
+ * @param {string} choice - 'make-new' | 'have-existing' | 'skip'
+ */
+function persistLovableChoice(projectDir, choice) {
+  updateBlueprint(projectDir, { lovableChoice: choice });
+}
+
+/**
+ * Run complete Lovable flow in CLI wizard
+ * @param {string} projectDir - Project directory path
+ * @returns {Promise<string>} - The choice made ('make-new' | 'have-existing' | 'skip')
+ */
+async function runLovableFlow(projectDir) {
+  const choice = await askLovableChoice();
+  displayLovableGuidance(choice);
+  createLovableDesignsDir(projectDir);
+  persistLovableChoice(projectDir, choice);
+  return choice;
+}
+
+module.exports = {
+  askLovableChoice,
+  displayLovableGuidance,
+  createLovableDesignsDir,
+  persistLovableChoice,
+  runLovableFlow
+};

package/src/messages.js

@@ -4,7 +4,7 @@ const messages = {
   welcome: () => {
     console.log('');
     console.log(chalk.cyan.bold('PropelKit'));
-    console.log(chalk.dim('AI-powered SaaS boilerplate for India'));
+    console.log(chalk.dim('AI-powered SaaS boilerplate'));
     console.log('');
   },
 
@@ -122,7 +122,7 @@ const messages = {
     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('  - Razorpay (INR + UPI)'));
     console.log(chalk.dim('  - Both for global SaaS with auto-routing'));
     console.log('');
   },

package/src/page-mapper.js

@@ -23,7 +23,7 @@ const PAGE_TEMPLATES = {
   // Credits pages (optional - based on features.credits)
   credits: ['Usage Dashboard', 'Purchase Credits'],
 
-  // GST pages (always included for India)
+  // GST pages (optional - based on features.gst)
   gst: ['Invoice Settings'],
 
   // Admin pages (always included)
@@ -143,7 +143,7 @@ const PAGE_DETAILS = {
 
   // GST pages
   'Invoice Settings': {
-    purpose: 'Configure GST and invoice details for Indian billing',
+    purpose: 'Configure GST and invoice details for tax billing',
     elements: ['GST number input', 'Business name', 'Business address', 'State selector', 'Invoice preferences'],
     components: ['Form', 'Input', 'Select', 'Button', 'Alert'],
     userFlow: 'User enters GST details -> Saves settings -> Future invoices use these details'
@@ -175,7 +175,7 @@ function derivePages(featuresConfig) {
   // Payment pages (always included)
   PAGE_TEMPLATES.payments.forEach(page => pages.add(page));
 
-  // GST pages (always included for India-first SaaS)
+  // GST pages (included when GST feature is enabled)
   PAGE_TEMPLATES.gst.forEach(page => pages.add(page));
 
   // Admin pages (always included)

package/src/payment-config.js

@@ -17,7 +17,7 @@ async function askPaymentProcessor() {
           value: 'stripe'
         },
         {
-          name: `${chalk.cyan('Razorpay')} - India (INR, UPI)`,
+          name: `${chalk.cyan('Razorpay')} - (INR, UPI)`,
           value: 'razorpay'
         },
         {

package/src/platform-detector.js

@@ -0,0 +1,51 @@
+const commandExists = require('command-exists');
+
+const PLATFORM_CLIS = {
+  vercel: {
+    name: 'vercel',
+    label: 'Vercel CLI',
+    installCommand: {
+      global: 'npm install -g vercel',
+      npx: 'npx vercel'
+    },
+    docs: 'https://vercel.com/docs/cli'
+  },
+  railway: {
+    name: 'railway',
+    label: 'Railway CLI',
+    installCommand: {
+      global: 'npm install -g @railway/cli',
+      macos: 'brew install railway',
+      windows: 'scoop install railway'
+    },
+    docs: 'https://docs.railway.app/reference/cli-api'
+  }
+};
+
+/**
+ * Detect if a platform's CLI is installed
+ * @param {string} platform - 'vercel' or 'railway'
+ * @returns {Promise<{required: boolean, installed: boolean, config: object}>}
+ */
+async function detectPlatformCLI(platform) {
+  const config = PLATFORM_CLIS[platform];
+
+  if (!config) {
+    throw new Error(`Unknown platform: ${platform}`);
+  }
+
+  const installed = await commandExists(config.name)
+    .then(() => true)
+    .catch(() => false);
+
+  return {
+    required: true,
+    installed,
+    config
+  };
+}
+
+module.exports = {
+  detectPlatformCLI,
+  PLATFORM_CLIS
+};

package/src/railway-deployer.js

@@ -0,0 +1,65 @@
+const { spawn } = require('child_process');
+const path = require('path');
+const { generateRailwayToml } = require('./config-generator');
+
+/**
+ * Deploys project to Railway using Railway CLI
+ * @param {string} projectDir - Absolute path to project directory
+ * @param {object} envVars - Environment variables (keys returned for guidance, not passed to CLI)
+ * @param {object} chalk - Chalk instance for colored output
+ * @returns {Promise<{success: boolean, envVars: string[]}>}
+ */
+async function deployToRailway(projectDir, envVars, chalk) {
+  return new Promise((resolve, reject) => {
+    // Step 1: Generate railway.toml before deployment
+    generateRailwayToml(projectDir, chalk);
+
+    console.log('');
+    console.log(chalk.cyan('🚀 Deploying to Railway...'));
+    console.log('');
+    console.log(chalk.dim('Note: Set environment variables in Railway dashboard after deployment'));
+    console.log('');
+
+    // Step 2: Build args for railway CLI
+    const args = ['up', '--detach'];
+
+    // Step 3: Spawn railway command
+    const railwayProcess = spawn('railway', args, {
+      cwd: projectDir,
+      stdio: 'inherit',
+      shell: true // Required for Windows cross-platform compatibility
+    });
+
+    // Step 4: Set 5-minute timeout
+    const timeout = setTimeout(() => {
+      railwayProcess.kill();
+      reject(new Error('Railway deployment timed out after 5 minutes'));
+    }, 300000); // 300000ms = 5 minutes
+
+    // Step 5: Handle process completion
+    railwayProcess.on('error', (error) => {
+      clearTimeout(timeout);
+      if (error.code === 'ENOENT') {
+        reject(new Error('Railway CLI not found. Install it from: https://docs.railway.app/develop/cli'));
+      } else {
+        reject(new Error(`Railway deployment failed: ${error.message}`));
+      }
+    });
+
+    railwayProcess.on('exit', (code) => {
+      clearTimeout(timeout);
+      if (code === 0) {
+        resolve({
+          success: true,
+          envVars: Object.keys(envVars) // Return env var keys for post-deploy guidance
+        });
+      } else {
+        reject(new Error(`Railway deployment failed with exit code ${code}`));
+      }
+    });
+  });
+}
+
+module.exports = {
+  deployToRailway
+};

package/src/vercel-deployer.js

@@ -0,0 +1,115 @@
+const { spawn } = require('child_process');
+const path = require('path');
+
+/**
+ * Check if user is authenticated with Vercel CLI
+ * @returns {Promise<{authenticated: boolean, user?: string}>}
+ */
+async function checkVercelAuth() {
+  return new Promise((resolve) => {
+    const vercel = spawn('vercel', ['whoami'], {
+      stdio: 'pipe',
+      shell: true
+    });
+
+    let stdout = '';
+    let stderr = '';
+
+    vercel.stdout.on('data', (data) => {
+      stdout += data.toString();
+    });
+
+    vercel.stderr.on('data', (data) => {
+      stderr += data.toString();
+    });
+
+    vercel.on('close', (code) => {
+      if (code === 0 && stdout.trim()) {
+        resolve({ authenticated: true, user: stdout.trim() });
+      } else {
+        resolve({ authenticated: false });
+      }
+    });
+
+    vercel.on('error', (error) => {
+      resolve({ authenticated: false });
+    });
+  });
+}
+
+/**
+ * Deploy project to Vercel with environment variables
+ * @param {string} projectDir - Absolute path to project directory
+ * @param {object} envVars - Environment variables object
+ * @param {boolean} isProduction - Whether to deploy to production (--prod flag)
+ * @param {object} chalk - Chalk instance for colored output
+ * @returns {Promise<{success: boolean}>}
+ */
+async function deployToVercel(projectDir, envVars, isProduction, chalk) {
+  return new Promise((resolve, reject) => {
+    // Build args array
+    const args = ['--yes'];
+
+    if (isProduction) {
+      args.push('--prod');
+    }
+
+    // Allowed secret env vars (never exposed to browser)
+    const allowedSecrets = [
+      'STRIPE_SECRET_KEY',
+      'STRIPE_WEBHOOK_SECRET',
+      'RAZORPAY_KEY_SECRET',
+      'RAZORPAY_WEBHOOK_SECRET',
+      'SUPABASE_SERVICE_ROLE_KEY',
+      'RESEND_API_KEY',
+      'INNGEST_EVENT_KEY',
+      'INNGEST_SIGNING_KEY'
+    ];
+
+    // Filter and add env vars
+    Object.entries(envVars).forEach(([key, value]) => {
+      // Include if starts with NEXT_PUBLIC_ OR is in allowed secrets list
+      if (key.startsWith('NEXT_PUBLIC_') || allowedSecrets.includes(key)) {
+        args.push('--env', `${key}=${value}`);
+      }
+    });
+
+    console.log('');
+    console.log(chalk.cyan(`Deploying to Vercel ${isProduction ? '(production)' : '(preview)'}...`));
+    console.log(chalk.dim(`Environment variables: ${Object.keys(envVars).filter(key => key.startsWith('NEXT_PUBLIC_') || allowedSecrets.includes(key)).length} passed`));
+    console.log('');
+
+    const vercel = spawn('vercel', args, {
+      cwd: projectDir,
+      stdio: 'inherit', // Show real-time logs
+      shell: true
+    });
+
+    // 5-minute timeout
+    const timeout = setTimeout(() => {
+      vercel.kill();
+      reject(new Error('Deployment timed out after 5 minutes'));
+    }, 300000);
+
+    vercel.on('close', (code) => {
+      clearTimeout(timeout);
+      if (code === 0) {
+        console.log('');
+        console.log(chalk.green('Deployment successful!'));
+        resolve({ success: true });
+      } else {
+        reject(new Error(`Deployment failed with exit code ${code}`));
+      }
+    });
+
+    vercel.on('error', (error) => {
+      clearTimeout(timeout);
+      reject(new Error(`Deployment error: ${error.message}`));
+    });
+  });
+}
+
+module.exports = {
+  checkVercelAuth,
+  deployToVercel
+};

package/src/webhook-guidance.js

@@ -0,0 +1,84 @@
+/**
+ * Display post-deployment webhook configuration guidance
+ * @param {string} deployedUrl - The deployed application URL
+ * @param {string} paymentProcessor - 'stripe', 'razorpay', or 'both'
+ * @param {string} platform - 'vercel' or 'railway'
+ * @param {string[]} envVarKeys - Array of environment variable keys
+ * @param {object} chalk - Chalk instance for colored output
+ */
+function displayWebhookGuidance(deployedUrl, paymentProcessor, platform, envVarKeys, chalk) {
+  console.log('');
+  console.log(chalk.green.bold('✓ Deployment successful!'));
+  console.log('');
+  console.log(chalk.cyan('Your app is deployed at:'));
+  console.log(chalk.bold(deployedUrl));
+  console.log('');
+
+  // Section 2: Configure webhook URLs based on payment processor
+  console.log(chalk.yellow.bold('📡 Next Steps: Configure Webhooks'));
+  console.log('');
+
+  if (paymentProcessor === 'razorpay' || paymentProcessor === 'both') {
+    console.log(chalk.cyan('Razorpay Webhooks:'));
+    console.log(chalk.dim('  Dashboard: https://dashboard.razorpay.com/app/webhooks'));
+    console.log('');
+    console.log(chalk.white('  Webhook URL:'));
+    console.log(chalk.bold(`  ${deployedUrl}/api/payments/webhooks/razorpay`));
+    console.log('');
+    console.log(chalk.dim('  Events to subscribe:'));
+    console.log(chalk.dim('    • payment.captured'));
+    console.log(chalk.dim('    • subscription.activated'));
+    console.log(chalk.dim('    • subscription.charged'));
+    console.log('');
+  }
+
+  if (paymentProcessor === 'stripe' || paymentProcessor === 'both') {
+    console.log(chalk.cyan('Stripe Webhooks:'));
+    console.log(chalk.dim('  Dashboard: https://dashboard.stripe.com/webhooks'));
+    console.log('');
+    console.log(chalk.white('  Webhook URL:'));
+    console.log(chalk.bold(`  ${deployedUrl}/api/payments/webhooks/stripe`));
+    console.log('');
+    console.log(chalk.dim('  Events to subscribe:'));
+    console.log(chalk.dim('    • checkout.session.completed'));
+    console.log(chalk.dim('    • invoice.paid'));
+    console.log(chalk.dim('    • invoice.payment_failed'));
+    console.log(chalk.dim('    • customer.subscription.updated'));
+    console.log(chalk.dim('    • customer.subscription.deleted'));
+    console.log('');
+  }
+
+  // Section 3: Railway-specific env var setup
+  if (platform === 'railway') {
+    console.log(chalk.yellow.bold('⚙️  Railway Environment Variables'));
+    console.log('');
+    console.log(chalk.white('Set these in your Railway dashboard:'));
+    console.log(chalk.dim('  Dashboard: https://railway.app/dashboard'));
+    console.log('');
+    envVarKeys.forEach(key => {
+      console.log(chalk.dim(`  • ${key}`));
+    });
+    console.log('');
+  }
+
+  // Section 4: Test your deployment checklist
+  console.log(chalk.yellow.bold('✅ Testing Checklist'));
+  console.log('');
+  console.log(chalk.dim('  1. Visit your app and sign up'));
+  console.log(chalk.dim('  2. Test authentication flow'));
+  console.log(chalk.dim('  3. Verify payment webhook (test mode)'));
+  console.log('');
+
+  // Section 5: Production warning
+  console.log(chalk.red.bold('⚠️  Important: Production Setup'));
+  console.log('');
+  console.log(chalk.yellow('For production deployments:'));
+  console.log(chalk.dim('  • Generate NEW webhook secrets (never reuse test mode secrets)'));
+  console.log(chalk.dim('  • Update webhook secrets in your deployment platform'));
+  console.log(chalk.dim('  • Test webhooks in production before launching'));
+  console.log('');
+}
+
+module.exports = {
+  displayWebhookGuidance
+};