@launchframe/cli 0.1.6

package/src/index.js

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+
+const chalk = require('chalk');
+const { isLaunchFrameProject } = require('./utils/project-helpers');
+
+// Import commands
+const { init } = require('./commands/init');
+const { deployConfigure } = require('./commands/deploy-configure');
+const { deploySetEnv } = require('./commands/deploy-set-env');
+const { deployInit } = require('./commands/deploy-init');
+const { deployUp } = require('./commands/deploy-up');
+const { waitlistDeploy } = require('./commands/waitlist-deploy');
+const { waitlistUp } = require('./commands/waitlist-up');
+const { waitlistDown } = require('./commands/waitlist-down');
+const { waitlistLogs } = require('./commands/waitlist-logs');
+const { dockerBuild } = require('./commands/docker-build');
+const { dockerUp } = require('./commands/docker-up');
+const { dockerDown } = require('./commands/docker-down');
+const { dockerLogs } = require('./commands/docker-logs');
+const { dockerDestroy } = require('./commands/docker-destroy');
+const { doctor } = require('./commands/doctor');
+const { help } = require('./commands/help');
+const {
+  serviceAdd,
+  serviceList,
+  serviceRemove
+} = require('./commands/service');
+
+// Get command and arguments
+const command = process.argv[2];
+const args = process.argv.slice(2);
+
+/**
+ * Parse flags from command line arguments
+ * @param {string[]} args - Command line arguments
+ * @returns {Object} Parsed flags
+ */
+function parseFlags(args) {
+  const flags = {};
+  for (let i = 1; i < args.length; i++) {
+    const arg = args[i];
+    if (arg.startsWith('--')) {
+      const flagName = arg.substring(2);
+      const nextArg = args[i + 1];
+      // Check if next arg is a value (not a flag)
+      if (nextArg && !nextArg.startsWith('-')) {
+        flags[flagName] = nextArg;
+        i++; // Skip next arg since we consumed it
+      } else {
+        flags[flagName] = true; // Boolean flag
+      }
+    } else if (arg.startsWith('-') && arg.length === 2) {
+      const flagName = arg.substring(1);
+      flags[flagName] = true; // Short flag (always boolean)
+    }
+  }
+  return flags;
+}
+
+/**
+ * Main CLI router
+ */
+async function main() {
+  const inProject = isLaunchFrameProject();
+  const flags = parseFlags(args);
+
+  // No command provided
+  if (!command) {
+    if (inProject) {
+      console.error(chalk.red('\n❌ Error: No command specified'));
+      help();
+      process.exit(1);
+    } else {
+      // Outside project, default to init
+      await init(flags);
+      return;
+    }
+  }
+
+  // Route commands
+  switch (command) {
+    case 'init':
+      await init({ projectName: flags['project-name'] });
+      break;
+    case 'deploy:configure':
+      await deployConfigure();
+      break;
+    case 'deploy:set-env':
+      await deploySetEnv();
+      break;
+    case 'deploy:init':
+      await deployInit();
+      break;
+    case 'deploy:up':
+      await deployUp();
+      break;
+    case 'waitlist:deploy':
+      await waitlistDeploy();
+      break;
+    case 'waitlist:up':
+      await waitlistUp();
+      break;
+    case 'waitlist:down':
+      await waitlistDown();
+      break;
+    case 'waitlist:logs':
+      await waitlistLogs();
+      break;
+    case 'docker:build':
+      await dockerBuild();
+      break;
+    case 'docker:up':
+      await dockerUp(args[1]); // Pass optional service name
+      break;
+    case 'docker:down':
+      await dockerDown();
+      break;
+    case 'docker:logs':
+      await dockerLogs();
+      break;
+    case 'docker:destroy':
+      await dockerDestroy({ force: flags.force || flags.f });
+      break;
+    case 'doctor':
+      await doctor();
+      break;
+    case 'service:add':
+      if (!args[1]) {
+        console.error(chalk.red('Error: Service name required'));
+        console.log('Usage: launchframe service:add <service-name>');
+        process.exit(1);
+      }
+      await serviceAdd(args[1]);
+      break;
+    case 'service:list':
+      await serviceList();
+      break;
+    case 'service:remove':
+      if (!args[1]) {
+        console.error(chalk.red('Error: Service name required'));
+        console.log('Usage: launchframe service:remove <service-name>');
+        process.exit(1);
+      }
+      await serviceRemove(args[1]);
+      break;
+    case 'help':
+    case '--help':
+    case '-h':
+      help();
+      break;
+    default:
+      console.error(chalk.red(`\n❌ Unknown command: ${command}\n`));
+      help();
+      process.exit(1);
+  }
+}
+
+main();

package/src/prompts.js

@@ -0,0 +1,200 @@
+const inquirer = require('inquirer');
+const { getVariantPrompts } = require('./services/variant-config');
+
+/**
+ * Prompts for initial project setup (local development only)
+ */
+async function runInitPrompts() {
+  const answers = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'projectName',
+      message: 'Project name (slug):',
+      default: 'my-saas',
+      validate: (input) => {
+        if (/^[a-z0-9-]+$/.test(input)) {
+          return true;
+        }
+        return 'Project name must contain only lowercase letters, numbers, and hyphens';
+      }
+    },
+    {
+      type: 'input',
+      name: 'projectDisplayName',
+      message: 'Project display name:',
+      default: (answers) => {
+        // Convert kebab-case to Title Case
+        return answers.projectName
+          .split('-')
+          .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+          .join(' ');
+      },
+      validate: (input) => {
+        if (input.trim().length > 0) {
+          return true;
+        }
+        return 'Project display name is required';
+      }
+    }
+  ]);
+
+  // Transform answers
+  return {
+    ...answers,
+    projectNameUpper: answers.projectName.toUpperCase().replace(/-/g, '_'),
+    projectNameCamel: answers.projectName.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase())
+  };
+}
+
+/**
+ * Prompts for deployment configuration
+ * @param {string} projectName - The project name from .launchframe config
+ */
+async function runDeployPrompts(projectName = 'launchframe') {
+  const answers = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'primaryDomain',
+      message: 'Primary domain (e.g., example.com):',
+      validate: (input) => {
+        if (/^[a-z0-9-]+\.[a-z]{2,}$/.test(input)) {
+          return true;
+        }
+        return 'Please enter a valid domain (e.g., example.com)';
+      }
+    },
+    {
+      type: 'input',
+      name: 'adminEmail',
+      message: 'Admin email (for Let\'s Encrypt SSL):',
+      validate: (input) => {
+        if (/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(input)) {
+          return true;
+        }
+        return 'Please enter a valid email address';
+      }
+    },
+    {
+      type: 'input',
+      name: 'githubOrg',
+      message: 'GitHub organization/username:',
+      validate: (input) => {
+        if (input.trim().length > 0) {
+          return true;
+        }
+        return 'GitHub org/username is required';
+      }
+    },
+    {
+      type: 'input',
+      name: 'vpsHost',
+      message: 'VPS hostname or IP:',
+      validate: (input) => {
+        if (input.trim().length > 0) {
+          return true;
+        }
+        return 'VPS host is required';
+      }
+    },
+    {
+      type: 'input',
+      name: 'vpsUser',
+      message: 'VPS SSH username:',
+      default: 'root',
+      validate: (input) => {
+        if (input.trim().length > 0) {
+          return true;
+        }
+        return 'VPS user is required';
+      }
+    },
+    {
+      type: 'input',
+      name: 'vpsAppFolder',
+      message: 'VPS deployment folder path:',
+      default: `/opt/${projectName}`,
+      validate: (input) => {
+        if (!input.startsWith('/')) {
+          return 'Must be an absolute path starting with /';
+        }
+        if (input.endsWith('/')) {
+          return 'Must not end with a trailing slash';
+        }
+        if (input.trim().length === 0) {
+          return 'VPS app folder is required';
+        }
+        return true;
+      }
+    },
+    {
+      type: 'password',
+      name: 'ghcrToken',
+      message: 'GitHub Personal Access Token (for Docker images):',
+      mask: '*',
+      validate: (input) => {
+        if (!input || input.trim().length === 0) {
+          return 'GHCR token is required for pushing Docker images';
+        }
+        if (!input.startsWith('ghp_') && !input.startsWith('github_pat_')) {
+          return 'Invalid GitHub token format (should start with ghp_ or github_pat_)';
+        }
+        return true;
+      }
+    }
+  ]);
+
+  return answers;
+}
+
+/**
+ * Prompts for variant selection (multi-tenancy, B2B vs B2B2C)
+ */
+async function runVariantPrompts() {
+  const prompts = getVariantPrompts();
+
+  console.log('\n📦 Configure Your Application\n');
+
+  // Prompt for user model
+  const userModelAnswer = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'userModel',
+      message: prompts.userModel.message,
+      choices: prompts.userModel.choices.map(choice => ({
+        name: choice.name,
+        value: choice.value,
+        short: choice.value
+      })),
+      default: prompts.userModel.default
+    }
+  ]);
+
+  // Prompt for tenancy
+  const tenancyAnswer = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'tenancy',
+      message: prompts.tenancy.message,
+      choices: prompts.tenancy.choices.map(choice => ({
+        name: choice.name,
+        value: choice.value,
+        short: choice.value
+      })),
+      default: prompts.tenancy.default
+    }
+  ]);
+
+  const variantChoices = {
+    tenancy: tenancyAnswer.tenancy,
+    userModel: userModelAnswer.userModel
+  };
+
+  // Show summary
+  console.log('\n✅ Configuration:');
+  console.log(`   User Model: ${variantChoices.userModel}`);
+  console.log(`   Tenancy: ${variantChoices.tenancy}\n`);
+
+  return variantChoices;
+}
+
+module.exports = { runInitPrompts, runDeployPrompts, runVariantPrompts };

package/src/services/registry.js

@@ -0,0 +1,48 @@
+// Service registry - available optional services for LaunchFrame
+const SERVICE_REGISTRY = {
+  waitlist: {
+    name: 'waitlist',
+    displayName: 'Waitlist Landing Page',
+    description: 'Coming soon page with email collection via Airtable',
+    repoUrl: 'https://github.com/{{GITHUB_ORG}}/launchframe-waitlist',
+    techStack: 'Next.js (standalone)',
+    dependencies: ['Airtable API'],
+    standalone: true, // Has own docker-compose files, not part of infrastructure/
+    envVars: {
+      AIRTABLE_PERSONAL_ACCESS_TOKEN: 'Your Airtable personal access token (create at https://airtable.com/create/tokens)',
+      AIRTABLE_BASE_ID: 'Your Airtable base ID (e.g., appHhPeD0hVeiE7dS - found in your base URL: airtable.com/appXXXXXX/...)',
+      AIRTABLE_TABLE_NAME: 'Your Airtable table name (e.g., "Waitlist Signups" - the exact name of your table, not the table ID)'
+    },
+    installPath: 'waitlist',
+    devPort: 3002,
+    version: '1.0.0'
+  },
+  docs: {
+    name: 'docs',
+    displayName: 'Documentation Site',
+    description: 'VitePress documentation site with LaunchFrame philosophy',
+    repoUrl: 'https://github.com/{{GITHUB_ORG}}/launchframe-docs',
+    techStack: 'VitePress + sirv-cli',
+    dependencies: ['None'],
+    standalone: false, // Integrated into main infrastructure/
+    envVars: {}, // No env vars needed for static docs
+    installPath: 'docs',
+    devPort: 5173,
+    version: '1.0.0'
+  },
+  'customers-frontend': {
+    name: 'customers-frontend',
+    displayName: 'Customer Frontend',
+    description: 'Customer-facing portal for B2B2C (React + Vite + Zustand)',
+    repoUrl: 'https://github.com/{{GITHUB_ORG}}/launchframe-customers-frontend',
+    techStack: 'React + Vite + Zustand + TanStack Query',
+    dependencies: ['backend'],
+    standalone: false, // Integrated into main infrastructure/
+    envVars: {}, // Uses standard env vars from infrastructure/.env
+    installPath: 'customers-frontend',
+    devPort: 3000,
+    version: '1.0.0'
+  }
+};
+
+module.exports = { SERVICE_REGISTRY };