@launchframe/cli 1.0.0-beta.31 → 1.0.0-beta.33

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,128 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the
+  overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or
+  advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email
+  address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+.
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series
+of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or
+permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior,  harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within
+the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct
+enforcement ladder](https://github.com/mozilla/diversity).
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at
+https://www.contributor-covenant.org/translations.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@launchframe/cli",
-  "version": "1.0.0-beta.31",
+  "version": "1.0.0-beta.33",
   "description": "Production-ready B2B SaaS boilerplate with subscriptions, credits, and multi-tenancy",
   "main": "src/index.js",
   "bin": {

package/src/commands/docker-build.js

@@ -6,8 +6,9 @@ const { requireProject } = require('../utils/project-helpers');
 
 /**
  * Build Docker images for the project
+ * @param {string} [serviceName] - Optional service to build (builds all if omitted)
  */
-async function dockerBuild() {
+async function dockerBuild(serviceName) {
   requireProject();
 
   const infrastructurePath = path.join(process.cwd(), 'infrastructure');
@@ -18,11 +19,11 @@ async function dockerBuild() {
     process.exit(1);
   }
 
-  console.log(chalk.blue.bold('\n🔨 Building Docker Images\n'));
-  console.log(chalk.gray('This will build all service images for local development...\n'));
+  const target = serviceName ? `${serviceName} service` : 'all services';
+  console.log(chalk.blue.bold(`\n🔨 Building Docker Images (${target})\n`));
 
   try {
-    const buildCommand = 'docker-compose -f docker-compose.yml -f docker-compose.dev.yml build';
+    const buildCommand = `docker-compose -f docker-compose.yml -f docker-compose.dev.yml build${serviceName ? ` ${serviceName}` : ''}`;
 
     console.log(chalk.gray(`Running: ${buildCommand}\n`));
 
@@ -32,8 +33,10 @@ async function dockerBuild() {
     });
 
     console.log(chalk.green.bold('\n✅ Docker images built successfully!\n'));
-    console.log(chalk.white('Next steps:'));
-    console.log(chalk.gray('  launchframe docker:up    # Start all services\n'));
+    if (!serviceName) {
+      console.log(chalk.white('Next steps:'));
+      console.log(chalk.gray('  launchframe docker:up    # Start all services\n'));
+    }
 
   } catch (error) {
     console.error(chalk.red('\n❌ Error during build:'), error.message);

package/src/commands/help.js

@@ -49,6 +49,9 @@ function help() {
     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('Module Management:'));
+    console.log(chalk.gray('  module:add <name>      Add a module to your project'));
+    console.log(chalk.gray('  module:list            List available modules\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:'));

package/src/commands/module.js

@@ -0,0 +1,146 @@
+const chalk = require('chalk');
+const inquirer = require('inquirer');
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+const { MODULE_REGISTRY } = require('../services/module-registry');
+const { MODULE_CONFIG } = require('../services/module-config');
+const { installModule } = require('../utils/module-installer');
+const { dockerBuild } = require('./docker-build');
+const { dockerDown } = require('./docker-down');
+const { dockerUp } = require('./docker-up');
+const {
+  requireProject,
+  getProjectConfig,
+  getInstalledModules,
+  isModuleInstalled,
+  addInstalledModule
+} = require('../utils/project-helpers');
+
+// Core services that can't be added via service:add
+const CORE_SERVICES = ['backend', 'admin-portal', 'infrastructure', 'website'];
+
+async function moduleList() {
+  requireProject();
+
+  const installedModules = getInstalledModules();
+  const modules = Object.values(MODULE_REGISTRY);
+
+  console.log(chalk.blue('\nAvailable Modules:\n'));
+
+  modules.forEach(mod => {
+    const installed = installedModules.includes(mod.name);
+    const status = installed ? chalk.green(' [installed]') : '';
+    console.log(chalk.green(`  ${mod.name}`) + status);
+    console.log(`    ${mod.description}`);
+    console.log(`    Affects services: ${mod.services.join(', ')}`);
+    console.log('');
+  });
+
+  console.log('To install a module:');
+  console.log('  launchframe module:add <module-name>');
+}
+
+async function moduleAdd(moduleName) {
+  requireProject();
+
+  // Validate module exists in registry
+  const mod = MODULE_REGISTRY[moduleName];
+  if (!mod) {
+    console.error(chalk.red(`Error: Module "${moduleName}" not found`));
+    console.log('\nAvailable modules:');
+    Object.keys(MODULE_REGISTRY).forEach(key => {
+      console.log(`  - ${key}`);
+    });
+    process.exit(1);
+  }
+
+  // Check not already installed
+  if (isModuleInstalled(moduleName)) {
+    console.error(chalk.red(`Error: Module "${moduleName}" is already installed`));
+    process.exit(1);
+  }
+
+  // Validate required services
+  const config = getProjectConfig();
+  const installedServices = config.installedServices || [];
+  const errors = [];
+
+  for (const service of mod.services) {
+    // Check if service is in installedServices
+    if (!installedServices.includes(service)) {
+      if (CORE_SERVICES.includes(service)) {
+        errors.push(`Core service '${service}' is missing from your project`);
+      } else {
+        errors.push(`Service '${service}' is not installed. Install it first with: launchframe service:add ${service}`);
+      }
+      continue;
+    }
+
+    // Check if service directory exists on disk
+    const serviceDir = path.join(process.cwd(), service);
+    if (!fs.existsSync(serviceDir)) {
+      errors.push(`Service '${service}' directory not found. Your project structure may be corrupted.`);
+    }
+  }
+
+  if (errors.length > 0) {
+    console.error(chalk.red(`\nCannot install module "${moduleName}":\n`));
+    errors.forEach(err => {
+      console.error(chalk.red(`  - ${err}`));
+    });
+    process.exit(1);
+  }
+
+  // Display module info and confirm
+  console.log(chalk.green(`\n${mod.displayName}`));
+  console.log(mod.description);
+  console.log(`Affects services: ${mod.services.join(', ')}`);
+
+  const { confirmed } = await inquirer.prompt([{
+    type: 'confirm',
+    name: 'confirmed',
+    message: `Add module "${mod.displayName}" to your project?`,
+    default: true
+  }]);
+
+  if (!confirmed) {
+    console.log('Installation cancelled');
+    process.exit(0);
+  }
+
+  const affectedServices = [...new Set(Object.keys(MODULE_CONFIG[moduleName] || {}))].filter(s => s !== 'infrastructure');
+  const infrastructurePath = path.join(process.cwd(), 'infrastructure');
+  const composeCmd = 'docker-compose -f docker-compose.yml -f docker-compose.dev.yml';
+
+  // Bring the stack down and remove affected containers before touching files
+  await dockerDown();
+  for (const service of affectedServices) {
+    try {
+      execSync(`${composeCmd} rm -f ${service}`, { cwd: infrastructurePath, stdio: 'inherit' });
+    } catch (_) {
+      // Container may already be gone — that's fine
+    }
+  }
+
+  // Register module in .launchframe
+  addInstalledModule(moduleName);
+
+  // Install module files, sections, and dependencies
+  const moduleServiceConfig = MODULE_CONFIG[moduleName];
+  if (moduleServiceConfig) {
+    await installModule(moduleName, moduleServiceConfig);
+  }
+
+  console.log(chalk.green(`\n✓ Module "${moduleName}" installed successfully!`));
+
+  // Rebuild affected containers
+  for (const service of affectedServices) {
+    await dockerBuild(service);
+  }
+
+  // Restart the full stack in watch mode
+  await dockerUp();
+}
+
+module.exports = { moduleAdd, moduleList };

package/src/index.js

@@ -41,6 +41,7 @@ const {
   serviceList,
   serviceRemove
 } = require('./commands/service');
+const { moduleAdd, moduleList } = require('./commands/module');
 const { cacheClear, cacheInfo, cacheUpdate } = require('./commands/cache');
 const { devAddUser } = require('./commands/dev-add-user');
 const { devQueue } = require('./commands/dev-queue');
@@ -140,7 +141,7 @@ async function main() {
       await waitlistLogs();
       break;
     case 'docker:build':
-      await dockerBuild();
+      await dockerBuild(args[1]); // Optional service name
       break;
     case 'docker:up':
       await dockerUp(args[1]); // Pass optional service name
@@ -188,6 +189,17 @@ async function main() {
       }
       await serviceRemove(args[1]);
       break;
+    case 'module:add':
+      if (!args[1]) {
+        console.error(chalk.red('Error: Module name required'));
+        console.log('Usage: launchframe module:add <module-name>');
+        process.exit(1);
+      }
+      await moduleAdd(args[1]);
+      break;
+    case 'module:list':
+      await moduleList();
+      break;
     case 'cache:clear':
       await cacheClear();
       break;

package/src/services/module-config.js

@@ -0,0 +1,25 @@
+// Module configuration - defines files, sections, and dependencies for each module
+const MODULE_CONFIG = {
+  blog: {
+    website: {
+      files: [
+        'src/lib/blog.ts',
+        'src/types/blog.ts',
+        'src/app/blog',
+        'src/components/blog',
+        'src/app/sitemap.ts',
+        'content/blog',
+      ],
+      sections: {
+        'src/components/layout/Navbar.tsx': ['BLOG_NAV_LINK'],
+        'src/components/layout/Footer.tsx': ['BLOG_FOOTER_LINK'],
+      },
+      dependencies: {
+        'gray-matter': '^4.0.3',
+        'marked': '^12.0.0',
+      },
+    },
+  },
+};
+
+module.exports = { MODULE_CONFIG };

package/src/services/module-registry.js

@@ -0,0 +1,12 @@
+// Module registry - available modules for LaunchFrame services
+const MODULE_REGISTRY = {
+  blog: {
+    name: 'blog',
+    displayName: 'Blog',
+    description: 'Markdown-based blog using local .md files with YAML front-matter — no database required',
+    services: ['website'],
+    version: '1.0.0'
+  }
+};
+
+module.exports = { MODULE_REGISTRY };

package/src/utils/module-installer.js

@@ -0,0 +1,58 @@
+const fs = require('fs-extra');
+const path = require('path');
+const { execSync } = require('child_process');
+const { replaceSection } = require('./section-replacer');
+
+/**
+ * Install a module into a project
+ * @param {string} moduleName - Name of the module to install
+ * @param {Object} moduleConfig - Config object from MODULE_CONFIG[moduleName]
+ */
+async function installModule(moduleName, moduleConfig) {
+  const templateRoot = path.resolve(__dirname, '../../../services');
+  const cwd = process.cwd();
+
+  for (const [serviceName, config] of Object.entries(moduleConfig)) {
+    const moduleFilesDir = path.join(templateRoot, 'modules', moduleName, serviceName, 'files');
+    const moduleSectionsDir = path.join(templateRoot, 'modules', moduleName, serviceName, 'sections');
+    const serviceDir = path.join(cwd, serviceName);
+
+    // Copy files
+    for (const filePath of config.files) {
+      const src = path.join(moduleFilesDir, filePath);
+      const dest = path.join(serviceDir, filePath);
+      console.log(`  Adding ${filePath}`);
+      await fs.copy(src, dest, { overwrite: true });
+    }
+
+    // Inject sections
+    for (const [targetFile, markerNames] of Object.entries(config.sections)) {
+      const targetFilePath = path.join(serviceDir, targetFile);
+      const targetBasename = path.basename(targetFile);
+
+      for (const markerName of markerNames) {
+        const sectionFile = path.join(moduleSectionsDir, `${targetBasename}.${markerName}`);
+        console.log(`  Injecting ${markerName} into ${targetFile}`);
+        const sectionContent = await fs.readFile(sectionFile, 'utf8');
+        await replaceSection(targetFilePath, markerName, sectionContent);
+      }
+    }
+
+    // Merge dependencies into package.json and sync lockfile
+    if (config.dependencies && Object.keys(config.dependencies).length > 0) {
+      const packageJsonPath = path.join(serviceDir, 'package.json');
+      const packageJson = await fs.readJson(packageJsonPath);
+      packageJson.dependencies = {
+        ...packageJson.dependencies,
+        ...config.dependencies,
+      };
+      await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
+
+      // Run npm install to sync package-lock.json, otherwise `npm ci` will fail on rebuild
+      console.log(`\nRunning npm install in ${serviceName}...`);
+      execSync('npm install', { cwd: serviceDir, stdio: 'inherit' });
+    }
+  }
+}
+
+module.exports = { installModule };

package/src/utils/project-helpers.js

@@ -95,6 +95,36 @@ function isWaitlistInstalled(config = null) {
   return (config.installedServices || []).includes('waitlist');
 }
 
+/**
+ * Get list of installed modules
+ */
+function getInstalledModules() {
+  const config = getProjectConfig();
+  return config.installedModules || [];
+}
+
+/**
+ * Check if a module is installed
+ */
+function isModuleInstalled(moduleName) {
+  const installedModules = getInstalledModules();
+  return installedModules.includes(moduleName);
+}
+
+/**
+ * Add a module to the installed modules list
+ */
+function addInstalledModule(moduleName) {
+  const config = getProjectConfig();
+  if (!config.installedModules) {
+    config.installedModules = [];
+  }
+  if (!config.installedModules.includes(moduleName)) {
+    config.installedModules.push(moduleName);
+    updateProjectConfig(config);
+  }
+}
+
 module.exports = {
   isLaunchFrameProject,
   requireProject,
@@ -104,5 +134,8 @@ module.exports = {
   isComponentInstalled,
   addInstalledComponent,
   getPrimaryDomain,
-  isWaitlistInstalled
+  isWaitlistInstalled,
+  getInstalledModules,
+  isModuleInstalled,
+  addInstalledModule
 };