@launchframe/cli 0.1.6

package/src/commands/docker-up.js

@@ -0,0 +1,73 @@
+const fs = require('fs');
+const path = require('path');
+const chalk = require('chalk');
+const { execSync } = require('child_process');
+const { requireProject, getProjectConfig } = require('../utils/project-helpers');
+
+/**
+ * Start Docker services (all or specific service)
+ * @param {string} serviceName - Optional service name to start (e.g., 'docs', 'backend')
+ */
+async function dockerUp(serviceName) {
+  requireProject();
+
+  const infrastructurePath = path.join(process.cwd(), 'infrastructure');
+
+  if (!fs.existsSync(infrastructurePath)) {
+    console.error(chalk.red('\n❌ Error: infrastructure/ directory not found'));
+    console.log(chalk.gray('Make sure you are in the root of your LaunchFrame project.\n'));
+    process.exit(1);
+  }
+
+  if (serviceName) {
+    console.log(chalk.blue.bold(`\n🚀 Starting ${serviceName} service\n`));
+    console.log(chalk.gray(`Starting ${serviceName} in detached mode...\n`));
+  } else {
+    console.log(chalk.blue.bold('\n🚀 Starting Docker Services\n'));
+    console.log(chalk.gray('Starting all services in detached mode...\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';
+
+    console.log(chalk.gray(`Running: ${upCommand}\n`));
+
+    execSync(upCommand, {
+      cwd: infrastructurePath,
+      stdio: 'inherit'
+    });
+
+    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`));
+    } else {
+      console.log(chalk.green.bold('\n✅ All services started successfully!\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'));
+
+      // Only show Customers Portal for B2B2C variant
+      const config = getProjectConfig();
+      if (config.variants && config.variants.userModel === 'b2b2c') {
+        console.log(chalk.gray('  Customers Portal: http://localhost:3000'));
+      }
+
+      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'));
+    }
+
+  } catch (error) {
+    console.error(chalk.red('\n❌ Error starting services:'), error.message);
+    process.exit(1);
+  }
+}
+
+module.exports = { dockerUp };

package/src/commands/doctor.js

@@ -0,0 +1,20 @@
+const chalk = require('chalk');
+const { requireProject } = require('../utils/project-helpers');
+
+/**
+ * Health check for project
+ */
+async function doctor() {
+  requireProject();
+
+  console.log(chalk.blue.bold('\n🔍 LaunchFrame Health Check\n'));
+
+  // TODO: Implement health check
+  // - Check Docker is running
+  // - Verify .env file exists
+  // - Check database connection
+  // - Verify all services are healthy
+  console.log(chalk.gray('Coming soon...'));
+}
+
+module.exports = { doctor };

package/src/commands/help.js

@@ -0,0 +1,79 @@
+const chalk = require('chalk');
+const { isLaunchFrameProject, isWaitlistInstalled } = require('../utils/project-helpers');
+
+/**
+ * Show help message
+ */
+function help() {
+  const inProject = isLaunchFrameProject();
+
+  console.log(chalk.blue.bold('\n🚀 LaunchFrame CLI\n'));
+  console.log(chalk.white('Usage:'));
+  console.log(chalk.gray('  launchframe [command]\n'));
+
+  if (inProject) {
+    console.log(chalk.white('Deployment commands:'));
+    console.log(chalk.gray('  deploy:configure  Configure production deployment settings'));
+    console.log(chalk.gray('  deploy:set-env    Configure production environment variables'));
+    console.log(chalk.gray('  deploy:init       Initialize VPS and build Docker images'));
+    console.log(chalk.gray('  deploy:up         Start services on VPS\n'));
+
+    // Conditionally show waitlist commands
+    if (isWaitlistInstalled()) {
+      console.log(chalk.white('Waitlist commands:'));
+      console.log(chalk.gray('  waitlist:deploy   Build and deploy waitlist component to VPS'));
+      console.log(chalk.gray('  waitlist:up       Start waitlist component locally'));
+      console.log(chalk.gray('  waitlist:down     Stop waitlist component locally'));
+      console.log(chalk.gray('  waitlist:logs     View waitlist logs from VPS\n'));
+    }
+    console.log(chalk.white('Local Docker commands:'));
+    console.log(chalk.gray('  docker:build                Build all Docker images'));
+    console.log(chalk.gray('  docker:up [service]         Start all services or specific service (detached)'));
+    console.log(chalk.gray('  docker:down                 Stop all services (keeps data)'));
+    console.log(chalk.gray('  docker:logs [service]       View logs from all services or specific service'));
+    console.log(chalk.gray('  docker:destroy              Remove all resources (containers, volumes, images)'));
+    console.log(chalk.gray('    --force, -f               Skip confirmation prompt\n'));
+    console.log(chalk.white('Service Management:'));
+    console.log(chalk.gray('  service:add <name>     Add an optional service to your project'));
+    console.log(chalk.gray('  service:list           List available services'));
+    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('Other commands:'));
+    console.log(chalk.gray('  doctor            Check project health and configuration'));
+    console.log(chalk.gray('  help              Show this help message\n'));
+    console.log(chalk.white('Examples:'));
+    console.log(chalk.gray('  # Deploy full app to production'));
+    console.log(chalk.gray('  launchframe deploy:configure'));
+    console.log(chalk.gray('  launchframe deploy:set-env'));
+    console.log(chalk.gray('  launchframe deploy:init'));
+    console.log(chalk.gray('  launchframe deploy:up\n'));
+
+    // Conditionally show waitlist example
+    if (isWaitlistInstalled()) {
+      console.log(chalk.gray('  # Deploy waitlist component'));
+      console.log(chalk.gray('  launchframe waitlist:deploy'));
+      console.log(chalk.gray('  launchframe waitlist:up\n'));
+    }
+
+    console.log(chalk.gray('  # Local development'));
+    console.log(chalk.gray('  launchframe docker:up              # Start all services'));
+    console.log(chalk.gray('  launchframe docker:up docs         # Start specific service'));
+    console.log(chalk.gray('  launchframe docker:logs backend    # View backend logs\n'));
+    console.log(chalk.gray('  # Add services'));
+    console.log(chalk.gray('  launchframe service:add docs'));
+    console.log(chalk.gray('  launchframe docker:up docs         # Start the docs service\n'));
+  } else {
+    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('  help                        Show this help message\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'));
+  }
+}
+
+module.exports = { help };

package/src/commands/init.js

@@ -0,0 +1,126 @@
+const fs = require('fs');
+const path = require('path');
+const chalk = require('chalk');
+const { runInitPrompts, runVariantPrompts } = require('../prompts');
+const { generateProject } = require('../generator');
+
+/**
+ * Check if current directory is a LaunchFrame project
+ */
+function isLaunchFrameProject() {
+  const markerPath = path.join(process.cwd(), '.launchframe');
+  return fs.existsSync(markerPath);
+}
+
+/**
+ * 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;
+  return !scriptPath.includes('node_modules');
+}
+
+/**
+ * Initialize a new LaunchFrame project
+ * @param {Object} options - Command options
+ * @param {string} options.projectName - Project name (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;
+  }
+
+  // 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'));
+    console.log(chalk.gray('Use other commands to manage your project, or run init from outside the project.\n'));
+    process.exit(1);
+  }
+
+  try {
+    let answers;
+
+    // If project name provided via flag, skip prompts
+    if (options.projectName) {
+      // Validate project name format
+      if (!/^[a-z0-9-]+$/.test(options.projectName)) {
+        throw new Error('Project name must contain only lowercase letters, numbers, and hyphens');
+      }
+
+      // Auto-generate display name from slug
+      const projectDisplayName = options.projectName
+        .split('-')
+        .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
+
+      answers = {
+        projectName: options.projectName,
+        projectDisplayName: projectDisplayName,
+        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`));
+    } else {
+      // Get user inputs via interactive prompts
+      answers = await runInitPrompts();
+    }
+
+    // Get variant selections (multi-tenancy, B2B vs B2B2C)
+    const variantChoices = await runVariantPrompts();
+
+    // Generate project with variant selections
+    console.log(chalk.yellow('\n⚙️  Generating project...\n'));
+    await generateProject(answers, variantChoices);
+
+    console.log(chalk.green.bold('\n✅ Project generated successfully!\n'));
+    console.log(chalk.white('Next steps:'));
+    console.log(chalk.white(`  cd ${answers.projectName}`));
+    console.log(chalk.white('  launchframe docker:up    # Start all services\n'));
+    console.log(chalk.gray('Optional:'));
+    console.log(chalk.gray('  # Review and customize infrastructure/.env if needed'));
+    console.log(chalk.gray('  launchframe docker:build # Rebuild images after changes\n'));
+
+  } catch (error) {
+    console.error(chalk.red('\n❌ Error:'), error.message);
+    process.exit(1);
+  }
+}
+
+module.exports = { init };