@launchframe/cli 0.1.11 → 1.0.0-beta.1

package/src/commands/docker-up.js

@@ -19,18 +19,38 @@ async function dockerUp(serviceName) {
     process.exit(1);
   }
 
+  // Check Docker Compose version for watch support
+  try {
+    const composeVersion = execSync('docker compose version', { encoding: 'utf8' });
+    const versionMatch = composeVersion.match(/v?(\d+)\.(\d+)\.(\d+)/);
+    
+    if (versionMatch) {
+      const [, major, minor] = versionMatch.map(Number);
+      
+      if (major < 2 || (major === 2 && minor < 22)) {
+        console.error(chalk.red('\n❌ Error: Docker Compose v2.22+ is required for watch support'));
+        console.log(chalk.yellow(`Current version: Docker Compose v${major}.${minor}`));
+        console.log(chalk.gray('\nPlease upgrade Docker Compose:'));
+        console.log(chalk.white('  https://docs.docker.com/compose/install/\n'));
+        process.exit(1);
+      }
+    }
+  } catch (error) {
+    console.warn(chalk.yellow('⚠️  Could not detect Docker Compose version'));
+  }
+
   if (serviceName) {
-    console.log(chalk.blue.bold(`\n🚀 Starting ${serviceName} service\n`));
-    console.log(chalk.gray(`Starting ${serviceName} in detached mode...\n`));
+    console.log(chalk.blue.bold(`\n🚀 Starting ${serviceName} service with watch\n`));
+    console.log(chalk.gray(`Starting ${serviceName} with file watching enabled...\n`));
   } else {
-    console.log(chalk.blue.bold('\n🚀 Starting Docker Services\n'));
-    console.log(chalk.gray('Starting all services in detached mode...\n'));
+    console.log(chalk.blue.bold('\n🚀 Starting Docker Services with Watch\n'));
+    console.log(chalk.gray('Starting all services with file watching enabled...\n'));
   }
 
   try {
     const upCommand = serviceName
-      ? `docker-compose -f docker-compose.yml -f docker-compose.dev.yml up -d ${serviceName}`
-      : 'docker-compose -f docker-compose.yml -f docker-compose.dev.yml up -d';
+      ? `docker-compose -f docker-compose.yml -f docker-compose.dev.yml watch ${serviceName}`
+      : 'docker-compose -f docker-compose.yml -f docker-compose.dev.yml watch';
 
     console.log(chalk.gray(`Running: ${upCommand}\n`));
 
@@ -40,12 +60,19 @@ async function dockerUp(serviceName) {
     });
 
     if (serviceName) {
-      console.log(chalk.green.bold(`\n✅ ${serviceName} service started successfully!\n`));
-      console.log(chalk.white('Useful commands:'));
-      console.log(chalk.gray(`  launchframe docker:logs ${serviceName}   # View logs`));
-      console.log(chalk.gray(`  docker-compose -f docker-compose.yml -f docker-compose.dev.yml down ${serviceName}   # Stop service\n`));
+      console.log(chalk.green.bold(`\n✅ ${serviceName} service started with watch!\n`));
+      console.log(chalk.yellow('📺 Watching for file changes (press Ctrl+C to stop)...\n'));
+      console.log(chalk.white('Watch behavior:'));
+      console.log(chalk.gray('  • Code changes → Auto-sync to container'));
+      console.log(chalk.gray('  • package.json → Auto-rebuild & restart\n'));
+      console.log(chalk.white('To stop:'));
+      console.log(chalk.gray('  Press Ctrl+C in this terminal\n'));
     } else {
-      console.log(chalk.green.bold('\n✅ All services started successfully!\n'));
+      console.log(chalk.green.bold('\n✅ All services started with watch!\n'));
+      console.log(chalk.yellow('📺 Watching for file changes (press Ctrl+C to stop)...\n'));
+      console.log(chalk.white('Watch behavior:'));
+      console.log(chalk.gray('  • Code changes → Auto-sync to containers'));
+      console.log(chalk.gray('  • package.json → Auto-rebuild & restart\n'));
       console.log(chalk.white('Services running at:'));
       console.log(chalk.gray('  Backend API:      http://localhost:4000'));
       console.log(chalk.gray('  Admin Panel:      http://localhost:3001'));
@@ -57,11 +84,10 @@ async function dockerUp(serviceName) {
       }
 
       console.log(chalk.gray('  Marketing Site:   http://localhost:8080\n'));
-      console.log(chalk.white('Useful commands:'));
-      console.log(chalk.gray('  launchframe docker:logs       # View logs from all services'));
-      console.log(chalk.gray('  launchframe docker:logs backend   # View logs from specific service'));
-      console.log(chalk.gray('  launchframe docker:down       # Stop services (keeps data)'));
-      console.log(chalk.gray('  launchframe docker:destroy    # Remove all resources\n'));
+      console.log(chalk.white('To stop all services:'));
+      console.log(chalk.gray('  Press Ctrl+C in this terminal'));
+      console.log(chalk.gray('  Or run: launchframe docker:down\n'));
+      console.log(chalk.cyan('💡 Tip (Linux/Mac): Add & at the end to run in background\n'));
     }
 
   } catch (error) {

package/src/commands/help.js

@@ -39,6 +39,10 @@ function help() {
     console.log(chalk.gray('  service:remove <name>  Remove installed service\n'));
     console.log(chalk.white('Available Services:'));
     console.log(chalk.gray('  waitlist          Coming soon page with email collection\n'));
+    console.log(chalk.white('Cache Management:'));
+    console.log(chalk.gray('  cache:info        Show cache location, size, and cached modules'));
+    console.log(chalk.gray('  cache:update      Force update cache to latest version'));
+    console.log(chalk.gray('  cache:clear       Delete cache (re-download on next use)\n'));
     console.log(chalk.white('Other commands:'));
     console.log(chalk.gray('  doctor            Check project health and configuration'));
     console.log(chalk.gray('  help              Show this help message\n'));
@@ -67,12 +71,18 @@ function help() {
     console.log(chalk.white('Available commands:'));
     console.log(chalk.gray('  init                        Initialize a new LaunchFrame project'));
     console.log(chalk.gray('    --project-name <name>     Project name (skips prompt)'));
+    console.log(chalk.gray('    --tenancy <single|multi>  Tenancy model (skips prompt)'));
+    console.log(chalk.gray('    --user-model <b2b|b2b2c>  User model (skips prompt)'));
     console.log(chalk.gray('  help                        Show this help message\n'));
+    console.log(chalk.white('Cache Management:'));
+    console.log(chalk.gray('  cache:info        Show cache location, size, and cached modules'));
+    console.log(chalk.gray('  cache:update      Force update cache to latest version'));
+    console.log(chalk.gray('  cache:clear       Delete cache (re-download on next use)\n'));
     console.log(chalk.white('Examples:'));
     console.log(chalk.gray('  # Interactive mode'));
     console.log(chalk.gray('  launchframe init\n'));
     console.log(chalk.gray('  # Non-interactive mode'));
-    console.log(chalk.gray('  launchframe init --project-name my-saas\n'));
+    console.log(chalk.gray('  launchframe init --project-name my-saas --tenancy single --user-model b2b\n'));
   }
 }
 

package/src/commands/init.js

@@ -3,6 +3,8 @@ const path = require('path');
 const chalk = require('chalk');
 const { runInitPrompts, runVariantPrompts } = require('../prompts');
 const { generateProject } = require('../generator');
+const { checkGitHubAccess, showAccessDeniedMessage } = require('../utils/github-access');
+const { ensureCacheReady } = require('../utils/module-cache');
 
 /**
  * Check if current directory is a LaunchFrame project
@@ -16,69 +18,37 @@ function isLaunchFrameProject() {
  * Check if running in development mode (local) vs production (npm install)
  */
 function isDevMode() {
-  // If LAUNCHFRAME_DEV env var is explicitly set, use it
-  if (process.env.LAUNCHFRAME_DEV === 'true') {
-    return true;
-  }
-  if (process.env.LAUNCHFRAME_DEV === 'false') {
-    return false;
-  }
-
-  // Check if running from node_modules (production) or local directory (dev)
-  const scriptPath = __dirname;
-
-  // Check multiple indicators that we're in production:
-  // 1. Running from node_modules
-  // 2. Running from npm cache (_npx or .npm)
-  // 3. Package name in path
-  const isInNodeModules = scriptPath.includes('node_modules');
-  const isInNpmCache = scriptPath.includes('_npx') || scriptPath.includes('.npm');
-  const isInPackage = scriptPath.includes('@launchframe');
-
-  // If any production indicator is found, we're NOT in dev mode
-  if (isInNodeModules || isInNpmCache || isInPackage) {
-    return false;
-  }
-
-  return true;
+  // Only use dev mode if LAUNCHFRAME_DEV is explicitly set to 'true'
+  return process.env.LAUNCHFRAME_DEV === 'true';
 }
 
 /**
  * Initialize a new LaunchFrame project
  * @param {Object} options - Command options
  * @param {string} options.projectName - Project name (skips prompt if provided)
+ * @param {string} options.tenancy - Tenancy model: 'single' or 'multi' (skips prompt if provided)
+ * @param {string} options.userModel - User model: 'b2b' or 'b2b2c' (skips prompt if provided)
  */
 async function init(options = {}) {
   console.log(chalk.blue.bold('\n🚀 Welcome to LaunchFrame!\n'));
 
-  // If running via npm (production), show waitlist message
-  if (!isDevMode()) {
-    console.log(chalk.white('LaunchFrame is a production-ready B2B SaaS boilerplate that gives you:'));
-    console.log(chalk.gray('  • Single VPS deployment ($7-20/mo with Docker + Traefik)'));
-    console.log(chalk.gray('  • Variant selection on init (single/multi-tenant, B2B/B2B2C)'));
-    console.log(chalk.gray('  • Service registry (add docs, waitlist, admin tools - zero config)'));
-    console.log(chalk.gray('  • Full-stack TypeScript (NestJS + React + Next.js)'));
-    console.log(chalk.gray('  • Subscriptions + credits (hybrid monetization)'));
-    console.log(chalk.gray('  • Feature guard system (tier-based access control)'));
-    console.log(chalk.gray('  • API key management + auto-generated docs'));
-    console.log(chalk.gray('  • Resilient webhook architecture\n'));
-
-    console.log(chalk.yellow.bold('📋 LaunchFrame is currently in private beta.\n'));
-
-    console.log(chalk.white('To get early access and be notified when the full version is available:'));
-    console.log(chalk.cyan.bold('\n  👉 Join the waitlist at https://launchframe.dev\n'));
-
-    console.log(chalk.gray('Founding members get:'));
-    console.log(chalk.gray('  • Exclusive early access'));
-    console.log(chalk.gray('  • Lifetime updates'));
-    console.log(chalk.gray('  • Priority support'));
-    console.log(chalk.gray('  • Special launch pricing\n'));
-
-    console.log(chalk.white('Questions? Email support@launchframe.dev\n'));
-    return;
+  // Check if in development mode
+  const devMode = isDevMode();
+  
+  if (!devMode) {
+    // Production mode: Check GitHub access
+    console.log(chalk.blue('🔍 Checking repository access...\n'));
+    
+    const accessCheck = await checkGitHubAccess();
+    
+    if (!accessCheck.hasAccess) {
+      // No access - show purchase/setup message
+      showAccessDeniedMessage();
+      process.exit(1); // Exit with error code
+    }
+    
+    console.log(chalk.green('✓ Repository access confirmed\n'));
   }
-
-  // Dev mode - continue with normal project generation
   // Check if already in a LaunchFrame project
   if (isLaunchFrameProject()) {
     console.error(chalk.red('\n❌ Error: Already in a LaunchFrame project'));
@@ -102,26 +72,90 @@ async function init(options = {}) {
         .map(word => word.charAt(0).toUpperCase() + word.slice(1))
         .join(' ');
 
+      const projectDescription = `${projectDisplayName} - Modern SaaS Platform`;
+
       answers = {
         projectName: options.projectName,
         projectDisplayName: projectDisplayName,
+        projectDescription: projectDescription,
         projectNameUpper: options.projectName.toUpperCase().replace(/-/g, '_'),
         projectNameCamel: options.projectName.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase())
       };
 
       console.log(chalk.gray(`Using project name: ${options.projectName}`));
-      console.log(chalk.gray(`Using display name: ${projectDisplayName}\n`));
+      console.log(chalk.gray(`Using display name: ${projectDisplayName}`));
+      console.log(chalk.gray(`Using description: ${projectDescription}\n`));
     } else {
       // Get user inputs via interactive prompts
       answers = await runInitPrompts();
     }
 
     // Get variant selections (multi-tenancy, B2B vs B2B2C)
-    const variantChoices = await runVariantPrompts();
+    let variantChoices;
+    
+    // If both flags provided, skip variant prompts
+    if (options.tenancy && options.userModel) {
+      // Validate tenancy value
+      if (!['single', 'multi'].includes(options.tenancy)) {
+        throw new Error('Invalid --tenancy value. Must be "single" or "multi"');
+      }
+      
+      // Validate userModel value
+      if (!['b2b', 'b2b2c'].includes(options.userModel)) {
+        throw new Error('Invalid --user-model value. Must be "b2b" or "b2b2c"');
+      }
+      
+      // Convert short flag values to full variant names
+      const tenancyMap = {
+        'single': 'single-tenant',
+        'multi': 'multi-tenant'
+      };
+      
+      variantChoices = {
+        tenancy: tenancyMap[options.tenancy],
+        userModel: options.userModel
+      };
+      
+      console.log(chalk.gray(`Using tenancy: ${options.tenancy}`));
+      console.log(chalk.gray(`Using user model: ${options.userModel}\n`));
+    } else {
+      // Run interactive variant prompts
+      variantChoices = await runVariantPrompts();
+    }
+
+    // Determine which modules are needed based on variant choices
+    const requiredModules = [
+      'backend',
+      'admin-portal',
+      'infrastructure',
+      'website'
+    ];
+    
+    // Add customers-portal only if B2B2C mode
+    if (variantChoices.userModel === 'b2b2c') {
+      requiredModules.push('customers-portal');
+    }
+
+    // Determine template source (dev mode = local, production = cache)
+    let templateRoot;
+    
+    if (devMode) {
+      // Dev mode: Use local modules directory
+      templateRoot = path.resolve(__dirname, '../../../modules');
+      console.log(chalk.gray(`[DEV MODE] Using local modules: ${templateRoot}\n`));
+    } else {
+      // Production mode: Use cache
+      try {
+        templateRoot = await ensureCacheReady(requiredModules);
+      } catch (error) {
+        console.error(chalk.red(`\n❌ Error: ${error.message}\n`));
+        process.exit(1);
+      }
+    }
 
     // Generate project with variant selections
     console.log(chalk.yellow('\n⚙️  Generating project...\n'));
-    await generateProject(answers, variantChoices);
+    await generateProject(answers, variantChoices, templateRoot);
 
     console.log(chalk.green.bold('\n✅ Project generated successfully!\n'));
     console.log(chalk.white('Next steps:'));

package/src/commands/service.js

@@ -7,6 +7,8 @@ const { SERVICE_REGISTRY } = require('../services/registry');
 const { isLaunchFrameProject, getProjectConfig, updateProjectConfig, getPrimaryDomain } = require('../utils/project-helpers');
 const { replaceVariables } = require('../utils/variable-replacer');
 const { updateEnvFile } = require('../utils/env-generator');
+const { checkGitHubAccess, showAccessDeniedMessage } = require('../utils/github-access');
+const { ensureCacheReady, getModulePath } = require('../utils/module-cache');
 
 async function serviceAdd(serviceName) {
   // STEP 1: Validation
@@ -59,7 +61,7 @@ async function serviceAdd(serviceName) {
     process.exit(0);
   }
 
-  // STEP 3: Clone repository or copy from local (dev mode)
+  // STEP 3: Get service files (from cache in production, local in dev)
   const installPath = path.resolve(process.cwd(), serviceName);
 
   if (fs.existsSync(installPath)) {
@@ -67,50 +69,59 @@ async function serviceAdd(serviceName) {
     process.exit(1);
   }
 
-  // Check if in development mode (for LaunchFrame development itself)
-  const isDevMode = process.env.LAUNCHFRAME_DEV_MODE === 'true';
+  // Check if in development mode
+  const isDevMode = process.env.LAUNCHFRAME_DEV === 'true';
+
+  let sourceDir;
 
   if (isDevMode) {
     // Local development: copy from launchframe-dev/modules directory
     console.log(chalk.blue('\n[DEV MODE] Copying service from local directory...'));
-    const sourceDir = path.resolve('/home/matfish/Work/launchframe-dev/modules', serviceName);
+    sourceDir = path.resolve(__dirname, '../../../modules', serviceName);
 
     if (!fs.existsSync(sourceDir)) {
       console.error(chalk.red(`Error: Local service directory not found: ${sourceDir}`));
-      console.log('Make sure the service exists in the launchframe-dev/modules directory');
+      console.log('Make sure the service exists in the modules directory');
       process.exit(1);
     }
-
-    try {
-      // Copy directory recursively, excluding .git, node_modules, .next, etc.
-      await fs.copy(sourceDir, installPath, {
-        filter: (src) => {
-          const basename = path.basename(src);
-          return !['node_modules', '.git', '.next', 'dist', 'build', '.env'].includes(basename);
-        }
-      });
-      console.log(chalk.green('✓ Service copied successfully'));
-    } catch (error) {
-      console.error(chalk.red('Failed to copy service directory'));
-      console.error(error.message);
+  } else {
+    // Production mode: Check access and use cache
+    console.log(chalk.blue('\n🔍 Checking repository access...'));
+    
+    const accessCheck = await checkGitHubAccess();
+    
+    if (!accessCheck.hasAccess) {
+      showAccessDeniedMessage();
       process.exit(1);
     }
-  } else {
-    // Production mode: clone from git repository
-    console.log(chalk.blue('\nCloning service repository...'));
-
-    // Replace {{GITHUB_ORG}} in repo URL with actual org from project config
-    const repoUrl = service.repoUrl.replace('{{GITHUB_ORG}}', projectConfig.githubOrg || 'launchframe');
-
+    
+    console.log(chalk.green('✓ Repository access confirmed'));
+    
     try {
-      execSync(`git clone ${repoUrl} ${installPath}`, { stdio: 'inherit' });
+      // Ensure cache has this service module
+      await ensureCacheReady([serviceName]);
+      sourceDir = getModulePath(serviceName);
     } catch (error) {
-      console.error(chalk.red('Failed to clone repository'));
-      console.log('Make sure you have access to the repository');
+      console.error(chalk.red(`\n❌ Error: ${error.message}\n`));
       process.exit(1);
     }
   }
 
+  // Copy service from source to installation path
+  try {
+    await fs.copy(sourceDir, installPath, {
+      filter: (src) => {
+        const basename = path.basename(src);
+        return !['node_modules', '.git', '.next', 'dist', 'build', '.env'].includes(basename);
+      }
+    });
+    console.log(chalk.green('✓ Service files copied successfully'));
+  } catch (error) {
+    console.error(chalk.red('Failed to copy service directory'));
+    console.error(error.message);
+    process.exit(1);
+  }
+
   // STEP 4: Service-specific prompts (e.g., Airtable credentials)
   console.log(chalk.blue('\nConfiguring service...'));
   const envValues = await runServicePrompts(service);
@@ -124,7 +135,7 @@ async function serviceAdd(serviceName) {
     '{{PROJECT_NAME_UPPER}}': projectName.toUpperCase().replace(/-/g, '_'),
     '{{PROJECT_DISPLAY_NAME}}': projectConfig.projectDisplayName || projectName,
     '{{PRIMARY_DOMAIN}}': getPrimaryDomain(projectConfig) || 'example.com',
-    '{{GITHUB_ORG}}': projectConfig.githubOrg || 'launchframe'
+    '{{GITHUB_ORG}}': projectConfig.deployment?.githubOrg || projectConfig.githubOrg || 'launchframe'
   };
 
   // Add service-specific env var values as {{VAR_NAME}} (with double curly braces)
@@ -335,7 +346,7 @@ function getDockerComposeDefinitions(serviceName, service, projectName, projectC
   const definitions = {};
 
   // Base configuration (docker-compose.yml)
-  if (serviceName === 'customers-frontend') {
+  if (serviceName === 'customers-portal') {
     definitions.base = {
       service: `
   # ---------------------------------------------------------------------------
@@ -380,12 +391,25 @@ function getDockerComposeDefinitions(serviceName, service, projectName, projectC
       target: development
     image: ${projectName}-${serviceName}:dev
     restart: "no"
-    volumes:
-      - ../${serviceName}/.vitepress:/app/.vitepress
-      - ../${serviceName}/index.md:/app/index.md
-      - ../${serviceName}/guide:/app/guide
-      - ../${serviceName}/public:/app/public
-      - ${serviceName}_node_modules:/app/node_modules
+    # File watching for automatic sync and rebuild
+    # - Code changes are synced automatically
+    # - package.json changes trigger rebuild + restart
+    develop:
+      watch:
+        - action: sync
+          path: ../${serviceName}
+          target: /app
+          ignore:
+            - node_modules/
+            - dist/
+            - .vitepress/dist/
+            - coverage/
+            - '*.log'
+            - .git/
+        - action: rebuild
+          path: ../${serviceName}/package.json
+        - action: rebuild
+          path: ../${serviceName}/package-lock.json
     environment:
       - NODE_ENV=development
     ports:
@@ -395,7 +419,7 @@ function getDockerComposeDefinitions(serviceName, service, projectName, projectC
     name: ${projectName}-${serviceName}-node-modules
 `
     };
-  } else if (serviceName === 'customers-frontend') {
+  } else if (serviceName === 'customers-portal') {
     definitions.dev = {
       service: `
   ${serviceName}:
@@ -431,8 +455,8 @@ function getDockerComposeDefinitions(serviceName, service, projectName, projectC
   }
 
   // Production configuration (docker-compose.prod.yml)
-  const githubOrg = projectConfig.githubOrg || 'launchframe';
-  const primaryDomain = projectConfig.primaryDomain || 'example.com';
+  const githubOrg = projectConfig.deployment?.githubOrg || 'launchframe';
+  const primaryDomain = projectConfig.deployment?.primaryDomain || 'example.com';
 
   if (serviceName === 'docs') {
     definitions.prod = {
@@ -449,7 +473,7 @@ function getDockerComposeDefinitions(serviceName, service, projectName, projectC
 `,
       volumes: null // No volumes needed in prod config
     };
-  } else if (serviceName === 'customers-frontend') {
+  } else if (serviceName === 'customers-portal') {
     definitions.prod = {
       service: `
   ${serviceName}:

package/src/commands/waitlist-deploy.js

@@ -44,8 +44,8 @@ async function waitlistDeploy() {
     process.exit(1);
   }
 
-  const { vpsHost, vpsUser, ghcrToken, adminEmail } = config.deployment;
-  const { projectName, githubOrg, vpsAppFolder } = config;
+  const { vpsHost, vpsUser, vpsAppFolder, ghcrToken, adminEmail, githubOrg } = config.deployment;
+  const { projectName } = config;
   const projectRoot = process.cwd();
   const waitlistPath = path.join(projectRoot, 'waitlist');
 

package/src/commands/waitlist-logs.js

@@ -26,8 +26,7 @@ async function waitlistLogs() {
     process.exit(1);
   }
 
-  const { vpsHost, vpsUser } = config.deployment;
-  const { vpsAppFolder } = config;
+  const { vpsHost, vpsUser, vpsAppFolder } = config.deployment;
 
   console.log(chalk.gray('Connecting to VPS and streaming logs...\n'));
   console.log(chalk.gray('Press Ctrl+C to exit\n'));

package/src/commands/waitlist-up.js

@@ -9,11 +9,13 @@ const execAsync = promisify(exec);
 
 /**
  * Start waitlist service locally
+ * @param {Object} flags - Command line flags
+ * @param {boolean} flags.build - Force rebuild of containers
  */
-async function waitlistUp() {
+async function waitlistUp(flags = {}) {
   requireProject();
 
-  console.log(chalk.blue.bold('\n🚀 Starting Waitlist Service (Local)\n'));
+  console.log(chalk.blue.bold('\n🚀 Starting Waitlist Service with Watch (Local)\n'));
 
   const config = getProjectConfig();
 
@@ -42,18 +44,46 @@ async function waitlistUp() {
     process.exit(1);
   }
 
-  // STEP 2: Start waitlist locally
-  console.log(chalk.yellow('\n🚀 Step 2: Starting waitlist containers...\n'));
+  // STEP 1b: Check Docker Compose version for watch support
+  console.log(chalk.yellow('\n🔍 Checking Docker Compose version...\n'));
 
-  const deploySpinner = ora('Starting waitlist containers...').start();
+  const composeSpinner = ora('Verifying Docker Compose v2.22+...').start();
+
+  try {
+    const { stdout: composeVersion } = await execAsync('docker compose version');
+    const versionMatch = composeVersion.match(/v?(\d+)\.(\d+)\.(\d+)/);
+    
+    if (versionMatch) {
+      const [, major, minor] = versionMatch.map(Number);
+      
+      if (major < 2 || (major === 2 && minor < 22)) {
+        composeSpinner.fail(`Docker Compose v${major}.${minor} is too old`);
+        console.log(chalk.red('\n❌ Docker Compose v2.22+ is required for watch support\n'));
+        console.log(chalk.gray('Please upgrade Docker Compose:'));
+        console.log(chalk.white('  https://docs.docker.com/compose/install/\n'));
+        process.exit(1);
+      }
+      composeSpinner.succeed(`Docker Compose v${major}.${minor} (compatible)`);
+    } else {
+      composeSpinner.warn('Could not parse version, proceeding anyway...');
+    }
+  } catch (error) {
+    composeSpinner.warn('Could not detect Docker Compose version');
+  }
+
+  // STEP 2: Start waitlist with watch
+  console.log(chalk.yellow('\n🚀 Step 2: Starting waitlist with watch...\n'));
+
+  const buildFlag = flags.build ? '--build' : '';
+  const deploySpinner = ora('Starting waitlist with watch...').start();
 
   try {
     await execAsync(
-      `cd ${waitlistPath} && docker-compose -f docker-compose.waitlist.yml -f docker-compose.waitlist.dev.yml up -d`,
+      `cd ${waitlistPath} && docker-compose -f docker-compose.waitlist.yml -f docker-compose.waitlist.dev.yml watch ${buildFlag}`.trim(),
       { timeout: 180000 } // 3 minutes
     );
 
-    deploySpinner.succeed('Waitlist started successfully');
+    deploySpinner.succeed('Waitlist started with watch');
   } catch (error) {
     deploySpinner.fail('Failed to start waitlist');
     console.log(chalk.red(`\n❌ Error: ${error.message}\n`));
@@ -78,18 +108,23 @@ async function waitlistUp() {
   }
 
   // Success!
-  console.log(chalk.green.bold('\n✅ Waitlist is now running locally!\n'));
+  console.log(chalk.green.bold('\n✅ Waitlist started with watch mode!\n'));
+
+  console.log(chalk.yellow('📺 Watching for file changes (press Ctrl+C to stop)...\n'));
+  
+  console.log(chalk.white('Watch behavior:'));
+  console.log(chalk.gray('  • Code changes → Auto-sync to container'));
+  console.log(chalk.gray('  • package.json → Auto-rebuild & restart\n'));
 
   console.log(chalk.white('Your waitlist landing page is available at:\n'));
   console.log(chalk.cyan(`  🌍 Waitlist: http://localhost:3002`));
-  console.log(chalk.gray(`  ✓ Running in development mode with hot reload`));
-  console.log(chalk.gray(`  ✓ Source code mounted from ./waitlist/src\n`));
-
-  console.log(chalk.white('Monitor waitlist:'));
-  console.log(chalk.gray(`  launchframe waitlist:logs\n`));
+  console.log(chalk.gray(`  ✓ Running in development mode with file watching\n`));
 
-  console.log(chalk.white('Stop waitlist:'));
-  console.log(chalk.gray(`  launchframe waitlist:down\n`));
+  console.log(chalk.white('To stop:'));
+  console.log(chalk.gray('  Press Ctrl+C in this terminal'));
+  console.log(chalk.gray('  Or run: launchframe waitlist:down\n'));
+  
+  console.log(chalk.cyan('💡 Tip (Linux/Mac): Add & at the end to run in background\n'));
 }
 
 module.exports = { waitlistUp };