@launchframe/cli 0.1.11 → 1.0.0-beta.2

package/src/generator.js

@@ -28,13 +28,14 @@ function initGitRepo(servicePath, serviceName) {
  * Main project generation function
  * @param {Object} answers - User answers from prompts
  * @param {Object} variantChoices - User's variant selections (tenancy, userModel)
+ * @param {string} templateRoot - Path to templates (cache or local dev path)
  */
-async function generateProject(answers, variantChoices) {
+async function generateProject(answers, variantChoices, templateRoot) {
   const { projectName } = answers;
 
   // Define source (template) and destination paths
-  const templateRoot = path.resolve(__dirname, '../../modules');
-  const projectRoot = path.resolve(__dirname, '../..'); // For root-level files like .github, CLAUDE.md
+  // templateRoot is now passed as parameter (cache or local dev path)
+  const projectRoot = path.resolve(__dirname, '../..'); // For root-level files like .github, README.md
   const destinationRoot = path.resolve(process.cwd(), projectName);
 
   console.log(`📁 Template source: ${templateRoot}`);
@@ -48,6 +49,7 @@ async function generateProject(answers, variantChoices) {
     '{{PROJECT_NAME}}': answers.projectName,
     '{{PROJECT_NAME_UPPER}}': answers.projectNameUpper,
     '{{PROJECT_DISPLAY_NAME}}': answers.projectDisplayName,
+    '{{PROJECT_DESCRIPTION}}': answers.projectDescription,
     // Leave these as template variables for deploy:configure to replace
     '{{GITHUB_ORG}}': '{{GITHUB_ORG}}',
     '{{PRIMARY_DOMAIN}}': '{{PRIMARY_DOMAIN}}',
@@ -144,7 +146,6 @@ async function generateProject(answers, variantChoices) {
   console.log('📋 Copying additional files...');
   const additionalFiles = [
     '.github',
-    'CLAUDE.md',
     'README.md',
     '.gitignore',
     'LICENSE'
@@ -173,12 +174,20 @@ async function generateProject(answers, variantChoices) {
   // Step 7: Create .launchframe marker file with variant metadata
   console.log('📝 Creating LaunchFrame marker file...');
   const markerPath = path.join(destinationRoot, '.launchframe');
+  
+  // Determine which services were installed
+  const installedServices = ['backend', 'admin-portal', 'infrastructure', 'website'];
+  if (variantChoices.userModel === 'b2b2c') {
+    installedServices.push('customers-portal');
+  }
+  
   const markerContent = {
     version: '0.1.0',
     createdAt: new Date().toISOString(),
     projectName: answers.projectName,
     projectDisplayName: answers.projectDisplayName,
     deployConfigured: false,
+    installedServices: installedServices,
     // Store variant choices for future reference
     variants: variantChoices
   };

package/src/index.js

@@ -25,6 +25,7 @@ const {
   serviceList,
   serviceRemove
 } = require('./commands/service');
+const { cacheClear, cacheInfo, cacheUpdate } = require('./commands/cache');
 
 // Get command and arguments
 const command = process.argv[2];
@@ -80,7 +81,11 @@ async function main() {
   // Route commands
   switch (command) {
     case 'init':
-      await init({ projectName: flags['project-name'] });
+      await init({ 
+        projectName: flags['project-name'],
+        tenancy: flags['tenancy'],
+        userModel: flags['user-model']
+      });
       break;
     case 'deploy:configure':
       await deployConfigure();
@@ -98,7 +103,7 @@ async function main() {
       await waitlistDeploy();
       break;
     case 'waitlist:up':
-      await waitlistUp();
+      await waitlistUp(flags);
       break;
     case 'waitlist:down':
       await waitlistDown();
@@ -143,6 +148,15 @@ async function main() {
       }
       await serviceRemove(args[1]);
       break;
+    case 'cache:clear':
+      await cacheClear();
+      break;
+    case 'cache:info':
+      await cacheInfo();
+      break;
+    case 'cache:update':
+      await cacheUpdate();
+      break;
     case 'help':
     case '--help':
     case '-h':

package/src/prompts.js

@@ -35,6 +35,18 @@ async function runInitPrompts() {
         }
         return 'Project display name is required';
       }
+    },
+    {
+      type: 'input',
+      name: 'projectDescription',
+      message: 'Project description (for meta tags):',
+      default: (answers) => `${answers.projectDisplayName} - Modern SaaS Platform`,
+      validate: (input) => {
+        if (input.trim().length > 0) {
+          return true;
+        }
+        return 'Project description is required';
+      }
     }
   ]);
 

package/src/services/registry.js

@@ -11,7 +11,9 @@ const SERVICE_REGISTRY = {
     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)'
+      AIRTABLE_TABLE_NAME: 'Your Airtable table name (e.g., "Waitlist Signups" - the exact name of your table, not the table ID)',
+      NEXT_PUBLIC_MIXPANEL_PROJECT_TOKEN: '[OPTIONAL] Your Mixpanel project token (find at mixpanel.com/project/[project-id]/settings - leave blank to disable analytics)',
+      NEXT_PUBLIC_MIXPANEL_DATA_RESIDENCY: '[OPTIONAL] Mixpanel data residency (US or EU - leave blank for US default)'
     },
     installPath: 'waitlist',
     devPort: 3002,
@@ -30,16 +32,16 @@ const SERVICE_REGISTRY = {
     devPort: 5173,
     version: '1.0.0'
   },
-  'customers-frontend': {
-    name: 'customers-frontend',
-    displayName: 'Customer Frontend',
+  'customers-portal': {
+    name: 'customers-portal',
+    displayName: 'Customers Portal',
     description: 'Customer-facing portal for B2B2C (React + Vite + Zustand)',
-    repoUrl: 'https://github.com/{{GITHUB_ORG}}/launchframe-customers-frontend',
+    repoUrl: 'https://github.com/{{GITHUB_ORG}}/launchframe-customers-portal',
     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',
+    installPath: 'customers-portal',
     devPort: 3000,
     version: '1.0.0'
   }

package/src/services/variant-config.js

@@ -21,14 +21,14 @@ const VARIANT_CONFIG = {
         // Complete files/folders to copy
         files: [
           'src/modules/domain/projects',           // Entire projects module
-          'src/modules/domain/jwt-auth',           // JWT auth module (project-specific JWT issuance)
           'src/modules/domain/ai/services/project-config.service.ts', // Project config service
-          'src/guards/project-ownership.guard.ts', // Project ownership guard
+          'src/guards/project-ownership.guard.ts', // Project ownership guard (header-based)
+          'src/guards/project-param.guard.ts',     // Project param guard (route-based)
           'src/modules/auth/auth.service.ts',      // Auth service with multi-tenant support
           'src/modules/auth/auth.controller.ts',   // Auth controller with multi-tenant support
           'src/modules/users/users.service.ts',    // Users service with multi-tenant support
           'src/modules/users/users.controller.ts', // Users controller with multi-tenant support
-          'src/modules/users/create-user.dto.ts'   // CreateUserDto with businessId and recoveryCode
+          'src/modules/users/create-user.dto.ts'   // CreateUserDto with businessId
         ],
 
         // Code sections to insert into base template files
@@ -41,9 +41,7 @@ const VARIANT_CONFIG = {
           ],
           'src/modules/app/app.module.ts': [
             'PROJECTS_MODULE_IMPORT',       // Add ProjectsModule import
-            'PROJECTS_MODULE',              // Add ProjectsModule to imports array
-            'JWT_AUTH_MODULE_IMPORT',       // Add JwtAuthModule import
-            'JWT_AUTH_MODULE'               // Add JwtAuthModule to imports array
+            'PROJECTS_MODULE'               // Add ProjectsModule to imports array
           ],
           'src/modules/auth/auth.module.ts': [
             'MULTI_TENANT_IMPORTS',         // Add Project entity import
@@ -55,7 +53,6 @@ const VARIANT_CONFIG = {
           ],
           'src/modules/users/users.module.ts': [
             'MULTI_TENANT_IMPORTS',          // Add Projects-related imports
-            'MULTI_TENANT_SERVICE_IMPORTS',  // Add JWT auth service imports
             'MULTI_TENANT_ENTITIES',         // Add Project entities to TypeORM
             'MULTI_TENANT_MODULE_IMPORTS',   // Add ProjectsModule to imports
             'MULTI_TENANT_PROVIDERS'         // Add multi-tenant providers
@@ -63,11 +60,11 @@ const VARIANT_CONFIG = {
         }
       },
 
-      // B2B2C variant: Adds regular_user support
+      // B2B2C variant: Adds regular_user support (for single-tenant only)
       'b2b2c': {
         // Complete files to copy
         files: [
-          'src/modules/users/user-business.entity.ts'  // Business-to-user linking entity
+          'src/modules/users/user-business.entity.ts',  // Business-to-user linking entity
         ],
 
         // Code sections to insert
@@ -82,6 +79,62 @@ const VARIANT_CONFIG = {
             'B2B2C_ENTITIES'           // Add UserBusiness to TypeORM
           ]
         }
+      },
+
+      // B2B2C + Single-tenant combination variant (NEW)
+      'b2b2c_single-tenant': {
+        // Complete files to copy (B2B2C features without multi-tenant projects)
+        files: [
+          'src/guards/business-scoping.guard.ts',                         // Business scoping guard
+          'src/modules/domain/business/business.controller.ts',           // Business lookup controller
+          'src/modules/domain/business/business.service.ts',              // Business lookup service
+          'src/modules/domain/business/business.module.ts',               // Business module
+          'src/modules/domain/business/entities/business.entity.ts',      // Business entity
+          'src/modules/domain/business/dto/business-response.dto.ts',     // Business response DTO
+          'src/modules/domain/business/dto/create-business.dto.ts',       // Business create DTO
+          'src/database/migrations/1766688416362-CreateBusinessesTable.ts', // Businesses table migration
+          'src/modules/domain/items/items.controller.ts',                 // Items with business scoping
+          'src/modules/domain/items/items.service.ts',                    // Items service with business scoping
+          'src/modules/domain/items/item.entity.ts',                      // Item entity with businessId
+          'src/modules/domain/items/dto/create-item.dto.ts',              // Create item DTO
+          'src/modules/domain/items/dto/update-item.dto.ts',              // Update item DTO
+          'src/modules/auth/auth.module.ts',                              // Auth module with Business entity
+          'src/modules/auth/auth.controller.ts',                          // Auth controller with magic-link (B2B2C)
+          'src/modules/auth/auth.service.ts',                             // Auth service with magic-link (B2B2C)
+          'src/modules/auth/jwt-auth.guard.ts',                           // JWT authentication guard
+          'src/modules/users/user-business.entity.ts',                    // Business-to-user linking entity
+          'src/modules/users/users.module.ts',                            // Users module with Business entity
+          'src/modules/users/users.controller.ts',                        // Users controller (B2B2C)
+          'src/modules/users/users.service.ts',                           // Users service (B2B2C)
+          'src/modules/users/create-user.dto.ts'                          // CreateUserDto with businessId
+        ],
+
+        sections: {
+          'src/modules/app/app.module.ts': [
+            'BUSINESS_MODULE_IMPORT',    // Import BusinessModule
+            'BUSINESS_MODULE'             // Add BusinessModule to imports
+          ],
+          'src/modules/users/user.entity.ts': [
+            'BUSINESS_RELATIONSHIP_IMPORT', // Import Business entity
+            'BUSINESS_RELATIONSHIP'         // Add business relationship
+          ]
+        }
+      },
+
+      // B2B2C + Multi-tenant combination variant (RENAMED from multi-tenant_b2b2c)
+      'b2b2c_multi-tenant': {
+        // Complete files to copy (has both multi-tenant and B2B2C features)
+        files: [
+          'src/modules/users/user-business.entity.ts',         // Business-to-user linking entity
+          'src/modules/auth/auth.service.ts',                  // Combined auth service
+          'src/modules/auth/auth.controller.ts',               // Combined auth controller
+          'src/modules/users/users.service.ts',                // Combined users service
+          'src/modules/users/users.controller.ts',             // Combined users controller
+          'src/modules/domain/projects/projects.module.ts'     // Projects module with UserBusiness
+        ],
+
+        // No sections needed - complete files already have all features
+        sections: {}
       }
     },
 
@@ -139,10 +192,8 @@ const VARIANT_CONFIG = {
           'src/components/projects/NewProject.tsx',          // Create project dialog
           'src/pages/FirstProject.tsx',                      // Onboarding page
           'src/api/projectRequests.ts',                      // Project API calls
-          'src/components/ProjectDetailsOnAuthPage.tsx',     // Recovery code flow
           'src/components/ProjectFrontendLink.tsx',          // Project navigation link
-          'src/components/settings/CustomDomain.tsx',        // Custom domain settings (multi-tenant only)
-          'src/components/settings/ProjectSettings.tsx'      // Project settings (multi-tenant only)
+          'src/components/settings/CustomDomain.tsx'         // Custom domain settings (multi-tenant only)
         ],
 
         // Code sections to insert into base template files
@@ -169,24 +220,15 @@ const VARIANT_CONFIG = {
             'PROJECTS_SELECT_COMPONENT' // Render ProjectsSelect in sidebar
           ],
           'src/pages/auth/Login.tsx': [
-            'ROUTER_IMPORTS',           // Add useNavigate, useSearchParams to imports
-            'PROJECT_DETAILS_IMPORT',   // Import ProjectDetailsOnAuthPage
-            'PROJECT_DETAILS_HANDLER',  // Handler for project retrieval
-            'PROJECT_DETAILS_COMPONENT' // Render ProjectDetailsOnAuthPage
+            'ROUTER_IMPORTS'            // Add useNavigate, useSearchParams to imports
           ],
           'src/pages/auth/SignUp.tsx': [
-            'REACT_IMPORTS',               // Add useState to React imports
-            'PROJECT_DETAILS_IMPORT',      // Import ProjectDetailsOnAuthPage
-            'PROJECT_DETAILS_STATE',       // State for recovery code
-            'PROJECT_DETAILS_COMPONENT',   // Render ProjectDetailsOnAuthPage
-            'RECOVERY_CODE_PROP_GOOGLE',   // Pass recovery code to GoogleLogin
-            'RECOVERY_CODE_PROP_FORM'      // Pass recovery code to SignUpForm
+            'REACT_IMPORTS'                // Add useState to React imports
           ],
           'src/pages/Settings.tsx': [
-            'MULTI_TENANT_SETTINGS_IMPORTS',  // Import ProjectSettings and CustomDomain
-            'MULTI_TENANT_SETTINGS_STATE',    // Set default activeTab to 'project'
-            'MULTI_TENANT_SETTINGS_TABS',     // Add Project and Custom Domain tabs
-            'MULTI_TENANT_SETTINGS_CONTENT'   // Render ProjectSettings and CustomDomain
+            'MULTI_TENANT_SETTINGS_IMPORTS',  // Import CustomDomain
+            'MULTI_TENANT_SETTINGS_TABS',     // Add Custom Domain tab
+            'MULTI_TENANT_SETTINGS_CONTENT'   // Render CustomDomain
           ],
           'src/App.tsx': [
             'SET_SELECTED_PROJECT_IMPORT', // Import setSelectedProject action
@@ -218,26 +260,63 @@ const VARIANT_CONFIG = {
             'B2B2C_USERS_ROUTE'         // Add /users route
           ]
         }
+      },
+
+      'b2b2c_single-tenant': {
+        files: [
+          'src/api/businessRequests.ts',  // Business API requests
+          'src/pages/Business.tsx'        // Business onboarding page
+        ],
+
+        sections: {
+          'src/App.tsx': [
+            'BUSINESS_IMPORT',             // Import Business component
+            'USER_ROUTE_VARIABLES',        // Add user and location variables
+            'USER_ROUTE_ONBOARDING_CHECK', // Business onboarding redirect logic
+            'BUSINESS_ROUTE'               // Add /business route
+          ]
+        }
       }
     },
 
     linkedTo: 'backend.tenancy'
   },
 
-  // Customers portal (for B2B2C regular_user access)
+  // Customers portal (B2B2C only - no pure B2B use case)
   'customers-portal': {
-    base: 'customers-portal/templates/base',
+    base: 'customers-portal/templates/base',  // B2B2C + Single-tenant base
     sectionsDir: 'customers-portal/templates/sections',
     filesDir: 'customers-portal/templates/files',
 
     variants: {
-      'multi-tenant': {
+      'single-tenant': {
+        // Single-tenant uses section overrides for business endpoints
         files: [],
+        sections: {
+          'src/api/tenantContext.ts': [
+            'TENANT_CONFIG'  // Override tenant config for business endpoints
+          ]
+        }
+      },
+
+      'multi-tenant': {
+        // Complete file replacement for multi-tenant variant
+        files: [
+          'src/App.tsx',                          // Project resolution logic
+          'src/api/config.ts',                    // x-project-id header
+          'src/api/types.ts',                     // Project type
+          'src/api/projectRequests.ts',           // Project API calls
+          'src/api/hooks/useProject.ts',          // Project hook
+          'src/store/useProjectStore.ts'          // Project state
+        ],
         sections: {}
       }
     },
 
-    linkedTo: 'backend.tenancy'
+    linkedTo: 'backend.tenancy',
+
+    // Only deploy customers-portal if B2B2C is selected
+    shouldInclude: (choices) => choices.userModel === 'b2b2c'
   },
 
   // Infrastructure (Docker Compose orchestration)
@@ -316,6 +395,11 @@ function resolveVariantChoices(backendChoices) {
     choices['admin-portal'].userModel = backendChoices.userModel;
   }
 
+  // Special case: infrastructure needs BOTH tenancy and userModel for proper variant resolution
+  if (choices['infrastructure']) {
+    choices['infrastructure'].tenancy = backendChoices.tenancy;
+  }
+
   return choices;
 }
 
@@ -327,15 +411,29 @@ function resolveVariantChoices(backendChoices) {
 function getVariantsToApply(choices) {
   const variantsToApply = [];
 
-  // Add multi-tenant if selected
-  if (choices.tenancy === 'multi-tenant') {
+  const isMultiTenant = choices.tenancy === 'multi-tenant';
+  const isSingleTenant = choices.tenancy === 'single-tenant';
+  const isB2B2C = choices.userModel === 'b2b2c';
+  const isB2B = choices.userModel === 'b2b';
+
+  // Handle variant combinations
+  if (isMultiTenant && isB2B2C) {
+    // B2B2C + Multi-tenant: Apply both variants then combo
+    variantsToApply.push('multi-tenant');       // Apply multi-tenant first (for projects module, etc.)
+    variantsToApply.push('b2b2c');              // Apply B2B2C sections (REGULAR_USER, userBusinesses)
+    variantsToApply.push('b2b2c_multi-tenant'); // Then apply combo files (overwrites with combined versions)
+  } else if (isSingleTenant && isB2B2C) {
+    // B2B2C + Single-tenant: Apply B2B2C then single-tenant combo
+    variantsToApply.push('b2b2c');              // Apply B2B2C sections first
+    variantsToApply.push('b2b2c_single-tenant'); // Then apply single-tenant combo
+  } else if (isMultiTenant && (isB2B || !choices.userModel)) {
+    // B2B + Multi-tenant: Apply only multi-tenant
     variantsToApply.push('multi-tenant');
+  } else if (isSingleTenant && !choices.userModel) {
+    // Single-tenant only (e.g., customers-portal): Apply single-tenant variant
+    variantsToApply.push('single-tenant');
   }
-
-  // Add b2b2c if selected
-  if (choices.userModel === 'b2b2c') {
-    variantsToApply.push('b2b2c');
-  }
+  // else: B2B + Single-tenant (base template, no variants)
 
   return variantsToApply;
 }

package/src/utils/docker-helper.js

@@ -43,7 +43,7 @@ async function loginToGHCR(githubOrg, ghcrToken) {
 
 /**
  * Build and push a Docker image
- * @param {string} serviceName - Service name (e.g., 'backend', 'admin-frontend')
+ * @param {string} serviceName - Service name (e.g., 'backend', 'admin-portal')
  * @param {string} contextDir - Docker build context directory
  * @param {string} registry - Registry URL (e.g., 'ghcr.io/myorg')
  * @param {string} projectName - Project name
@@ -111,57 +111,77 @@ function loadEnvFile(envFilePath) {
  * @param {string} projectName - Project name
  * @param {string} githubOrg - GitHub organization/username
  * @param {string} envFilePath - Path to .env.prod file
+ * @param {string[]} installedServices - List of installed services from .launchframe
  * @returns {Promise<void>}
  */
-async function buildFullAppImages(projectRoot, projectName, githubOrg, envFilePath) {
+async function buildFullAppImages(projectRoot, projectName, githubOrg, envFilePath, installedServices = []) {
   const registry = `ghcr.io/${githubOrg}`;
   const envVars = loadEnvFile(envFilePath);
 
   console.log(chalk.yellow('\n📦 Building production Docker images...\n'));
   console.log(chalk.gray('This may take 10-20 minutes depending on your system.\n'));
+  console.log(chalk.gray(`Services to build: ${installedServices.join(', ')}\n`));
+
+  // Build backend (always required)
+  if (installedServices.includes('backend')) {
+    await buildAndPushImage(
+      'backend',
+      path.join(projectRoot, 'backend'),
+      registry,
+      projectName
+    );
+  }
+
+  // Build admin-portal (always required)
+  if (installedServices.includes('admin-portal')) {
+    await buildAndPushImage(
+      'admin-portal',
+      path.join(projectRoot, 'admin-portal'),
+      registry,
+      projectName
+    );
+  }
+
+  // Build customers-portal (only if installed - B2B2C mode)
+  if (installedServices.includes('customers-portal')) {
+    await buildAndPushImage(
+      'customers-portal',
+      path.join(projectRoot, 'customers-portal'),
+      registry,
+      projectName
+    );
+  }
 
-  // Build backend
-  await buildAndPushImage(
-    'backend',
-    path.join(projectRoot, 'backend'),
-    registry,
-    projectName
-  );
-
-  // Build admin-frontend
-  await buildAndPushImage(
-    'admin-frontend',
-    path.join(projectRoot, 'admin-frontend'),
-    registry,
-    projectName
-  );
-
-  // Build customers-frontend
-  await buildAndPushImage(
-    'customers-frontend',
-    path.join(projectRoot, 'frontend'),
-    registry,
-    projectName
-  );
-
-  // Build website (requires build args)
-  const websiteBuildArgs = [
-    `APP_NAME=${envVars.APP_NAME || ''}`,
-    `DOCS_URL=${envVars.DOCS_URL || ''}`,
-    `CONTACT_EMAIL=${envVars.CONTACT_EMAIL || ''}`,
-    `CTA_LINK=${envVars.CTA_LINK || ''}`,
-    `LIVE_DEMO_URL=${envVars.LIVE_DEMO_URL || ''}`,
-    `MIXPANEL_PROJECT_TOKEN=${envVars.MIXPANEL_PROJECT_TOKEN || ''}`,
-    `GOOGLE_ANALYTICS_ID=${envVars.GOOGLE_ANALYTICS_ID || ''}`
-  ];
-
-  await buildAndPushImage(
-    'website',
-    path.join(projectRoot, 'website'),
-    registry,
-    projectName,
-    websiteBuildArgs
-  );
+  // Build website (always required)
+  if (installedServices.includes('website')) {
+    const websiteBuildArgs = [
+      `APP_NAME=${envVars.APP_NAME || ''}`,
+      `DOCS_URL=${envVars.DOCS_URL || ''}`,
+      `CONTACT_EMAIL=${envVars.CONTACT_EMAIL || ''}`,
+      `CTA_LINK=${envVars.CTA_LINK || ''}`,
+      `LIVE_DEMO_URL=${envVars.LIVE_DEMO_URL || ''}`,
+      `MIXPANEL_PROJECT_TOKEN=${envVars.MIXPANEL_PROJECT_TOKEN || ''}`,
+      `GOOGLE_ANALYTICS_ID=${envVars.GOOGLE_ANALYTICS_ID || ''}`
+    ];
+
+    await buildAndPushImage(
+      'website',
+      path.join(projectRoot, 'website'),
+      registry,
+      projectName,
+      websiteBuildArgs
+    );
+  }
+
+  // Build docs (optional service - VitePress documentation)
+  if (installedServices.includes('docs')) {
+    await buildAndPushImage(
+      'docs',
+      path.join(projectRoot, 'docs'),
+      registry,
+      projectName
+    );
+  }
 }
 
 /**
@@ -196,6 +216,8 @@ async function buildWaitlistImage(projectRoot, projectName, githubOrg) {
       `AIRTABLE_TABLE_NAME=${envVars.AIRTABLE_TABLE_NAME || 'Waitlist'}`,
       `NEXT_PUBLIC_PROJECT_NAME=${envVars.NEXT_PUBLIC_PROJECT_NAME || envVars.PROJECT_NAME || ''}`,
       `NEXT_PUBLIC_SITE_URL=${envVars.NEXT_PUBLIC_SITE_URL || ''}`,
+      `NEXT_PUBLIC_MIXPANEL_PROJECT_TOKEN=${envVars.NEXT_PUBLIC_MIXPANEL_PROJECT_TOKEN || ''}`,
+      `NEXT_PUBLIC_MIXPANEL_DATA_RESIDENCY=${envVars.NEXT_PUBLIC_MIXPANEL_DATA_RESIDENCY || ''}`,
       `PROJECT_NAME=${envVars.PROJECT_NAME || ''}`,
       `PRIMARY_DOMAIN=${envVars.PRIMARY_DOMAIN || ''}`
     ];

package/src/utils/github-access.js

@@ -0,0 +1,67 @@
+const { execSync } = require('child_process');
+const chalk = require('chalk');
+
+/**
+ * Create a clickable terminal link using OSC 8 escape sequence
+ * Works in modern terminals (iTerm2, Hyper, Windows Terminal, VS Code, etc.)
+ * Falls back gracefully to plain text in unsupported terminals
+ * @param {string} text - Display text
+ * @param {string} url - Target URL
+ * @returns {string} Formatted link
+ */
+function makeClickable(text, url) {
+  return `\x1b]8;;${url}\x07${text}\x1b]8;;\x07`;
+}
+
+/**
+ * Check if user has SSH access to LaunchFrame modules repository
+ * @returns {Promise<{hasAccess: boolean, error?: string}>}
+ */
+async function checkGitHubAccess() {
+  try {
+    // Test SSH access by checking if we can list remote refs
+    execSync(
+      'git ls-remote git@github.com:launchframe-dev/modules.git HEAD',
+      { 
+        timeout: 15000,
+        stdio: 'pipe' // Don't show output
+      }
+    );
+    return { hasAccess: true };
+  } catch (error) {
+    return {
+      hasAccess: false,
+      error: error.message
+    };
+  }
+}
+
+/**
+ * Display message when user doesn't have access to modules repository
+ * Guides them to either purchase or setup SSH keys
+ */
+function showAccessDeniedMessage() {
+  const purchaseUrl = 'https://buy.polar.sh/polar_cl_Zy4YqEwhoIEdUrAH8vHaWuZtwZuv306sYMnq118MbKi';
+  const docsUrl = 'https://docs.launchframe.dev/guide/quick-start#add-ssh-key-to-repo';
+  
+  console.log(chalk.red('\n❌ Cannot access LaunchFrame modules repository\n'));
+  
+  console.log(chalk.white('This could mean:\n'));
+  console.log(chalk.gray('  1. You haven\'t purchased LaunchFrame yet'));
+  console.log(chalk.gray('  2. You purchased but haven\'t added your SSH key to the repo\n'));
+  
+  console.log(chalk.cyan('→ New customers:'));
+  console.log('  ' + chalk.blue.bold.underline(makeClickable('Purchase LaunchFrame', purchaseUrl)));
+  console.log('  ' + chalk.cyan(purchaseUrl + '\n'));
+  
+  console.log(chalk.cyan('→ Existing customers:'));
+  console.log('  ' + chalk.blue.bold.underline(makeClickable('Setup SSH key (docs)', docsUrl)));
+  console.log('  ' + chalk.cyan(docsUrl + '\n'));
+  
+  console.log(chalk.gray('After setup, run: launchframe init\n'));
+}
+
+module.exports = {
+  checkGitHubAccess,
+  showAccessDeniedMessage
+};