create-loadout 1.0.1 → 1.0.4

package/dist/cli.js

@@ -1,19 +1,16 @@
 import chalk from 'chalk';
 import ora from 'ora';
-import fs from 'fs/promises';
 import path from 'path';
 import { getProjectConfig, getAddIntegrationConfig } from './prompts.js';
-import { createNextApp } from './create-next.js';
-import { setupShadcn } from './setup-shadcn.js';
-import { installIntegrations } from './integrations/index.js';
-import { generateClaudeMd, appendClaudeMd } from './claude-md.js';
-import { generateEnvFiles, appendEnvFiles } from './env.js';
-import { generateConfig, appendConfig } from './config.js';
-import { generateReadme, generateGitignore } from './generate-readme.js';
-import { generateInstrumentationClient, generateInstrumentation, } from './instrumentation.js';
-import { zustandTemplates } from './templates/zustand.js';
-import { generateLandingPage } from './landing-page.js';
+import { createProject, addIntegrations } from './engine.js';
 import { isExistingProject, getInstalledIntegrations, getAvailableIntegrations, } from './detect.js';
+function oraReporter() {
+    const spinner = ora();
+    const callback = (step) => {
+        spinner.start(step);
+    };
+    return { spinner, callback };
+}
 export async function main() {
     console.log();
     console.log(chalk.bold.cyan('  create-loadout'));
@@ -37,36 +34,8 @@ export async function main() {
 async function newProjectFlow() {
     const config = await getProjectConfig();
     console.log();
-    const spinner = ora('Creating Next.js app...').start();
-    const projectPath = await createNextApp(config.name);
-    spinner.succeed('Next.js app created');
-    spinner.start('Setting up shadcn/ui...');
-    await setupShadcn(projectPath);
-    spinner.succeed('shadcn/ui configured');
-    await extendUtils(projectPath);
-    spinner.start('Installing base packages...');
-    const { execa } = await import('execa');
-    await execa('npm', ['install', 'zod@^3.24', 'zustand@^5', 'luxon@^3'], { cwd: projectPath });
-    await execa('npm', ['install', '-D', '@types/luxon'], { cwd: projectPath });
-    spinner.succeed('Base packages installed (zod, zustand, luxon)');
-    await fs.mkdir(path.join(projectPath, 'lib/stores'), { recursive: true });
-    await fs.writeFile(path.join(projectPath, 'lib/stores/counter.store.ts'), zustandTemplates.exampleStore);
-    if (config.integrations.length > 0) {
-        spinner.start(`Setting up ${config.integrations.length} integration(s)...`);
-        await installIntegrations(projectPath, config);
-        spinner.succeed('Integrations configured');
-    }
-    await generateInstrumentationClient(projectPath, config);
-    await generateInstrumentation(projectPath, config);
-    spinner.start('Generating config and environment files...');
-    await generateConfig(projectPath, config);
-    await generateEnvFiles(projectPath, config);
-    spinner.succeed('Config and environment files created');
-    spinner.start('Generating project files...');
-    await generateLandingPage(projectPath, config);
-    await generateGitignore(projectPath);
-    await generateReadme(projectPath, config);
-    await generateClaudeMd(projectPath, config);
+    const { spinner, callback } = oraReporter();
+    const result = await createProject(config, callback);
     spinner.succeed('Project files created');
     console.log();
     console.log(chalk.green.bold('  Success!') + ' Created ' + chalk.cyan(config.name));
@@ -80,7 +49,7 @@ async function newProjectFlow() {
     }
     console.log(chalk.bold('  Next steps:'));
     console.log(chalk.gray(`    1. cd ${config.name}`));
-    console.log(chalk.gray('    2. Configure .env.local with your API keys'));
+    console.log(chalk.gray('    2. Configure .env with your API keys'));
     console.log(chalk.gray('    3. npm run dev'));
     console.log();
     if (config.integrations.includes('neon-drizzle')) {
@@ -117,21 +86,14 @@ async function addIntegrationFlow(projectPath) {
         return;
     }
     console.log();
-    const spinner = ora(`Installing ${addConfig.integrations.length} integration(s)...`).start();
     const config = {
         name: path.basename(projectPath),
         integrations: addConfig.integrations,
         aiProvider: addConfig.aiProvider,
     };
-    await installIntegrations(projectPath, config);
+    const { spinner, callback } = oraReporter();
+    const result = await addIntegrations(projectPath, config, callback);
     spinner.succeed('Integrations installed');
-    spinner.start('Updating config and environment files...');
-    await appendConfig(projectPath, addConfig.integrations, addConfig.aiProvider);
-    await appendEnvFiles(projectPath, addConfig.integrations, addConfig.aiProvider);
-    spinner.succeed('Config and environment files updated');
-    spinner.start('Updating CLAUDE.md...');
-    await appendClaudeMd(projectPath, addConfig.integrations);
-    spinner.succeed('CLAUDE.md updated');
     console.log();
     console.log(chalk.green.bold('  Success!') + ' Added integrations:');
     addConfig.integrations.forEach((integration) => {
@@ -139,7 +101,7 @@ async function addIntegrationFlow(projectPath) {
     });
     console.log();
     console.log(chalk.bold('  Next steps:'));
-    console.log(chalk.gray('    1. Update .env.local with new API keys'));
+    console.log(chalk.gray('    1. Update .env with new API keys'));
     console.log(chalk.gray('    2. npm run dev'));
     console.log();
     if (addConfig.integrations.includes('neon-drizzle')) {
@@ -155,32 +117,3 @@ async function addIntegrationFlow(projectPath) {
         console.log();
     }
 }
-async function extendUtils(projectPath) {
-    const utilsPath = path.join(projectPath, 'lib/utils.ts');
-    const existingContent = await fs.readFile(utilsPath, 'utf-8');
-    const additionalUtils = `
-import { DateTime } from 'luxon';
-
-export function formatDate(date: Date | string, format = 'LLL d, yyyy'): string {
-  const dt = typeof date === 'string' ? DateTime.fromISO(date) : DateTime.fromJSDate(date);
-  return dt.toFormat(format);
-}
-
-export function formatRelative(date: Date | string): string {
-  const dt = typeof date === 'string' ? DateTime.fromISO(date) : DateTime.fromJSDate(date);
-  return dt.toRelative() ?? dt.toFormat('LLL d, yyyy');
-}
-
-export function debounce<P extends unknown[], R>(
-  func: (...args: P) => R,
-  wait: number
-): (...args: P) => void {
-  let timeout: ReturnType<typeof setTimeout>;
-  return (...args: P) => {
-    clearTimeout(timeout);
-    timeout = setTimeout(() => func(...args), wait);
-  };
-}
-`;
-    await fs.writeFile(utilsPath, existingContent + additionalUtils);
-}

package/dist/create-next.js

@@ -11,7 +11,7 @@ export async function createNextApp(name) {
         '--import-alias', '@/*',
         '--yes',
     ], {
-        stdio: 'inherit',
+        stdio: 'pipe',
     });
     return path.resolve(process.cwd(), name);
 }

package/dist/engine.d.ts

@@ -0,0 +1,9 @@
+import type { ProjectConfig, IntegrationId } from './types.js';
+export type ProgressCallback = (step: string) => void;
+export interface EngineResult {
+    projectPath: string;
+    integrations: IntegrationId[];
+    envVarsNeeded: string[];
+}
+export declare function createProject(config: ProjectConfig, onProgress?: ProgressCallback): Promise<EngineResult>;
+export declare function addIntegrations(projectPath: string, config: ProjectConfig, onProgress?: ProgressCallback): Promise<EngineResult>;

package/dist/engine.js

@@ -0,0 +1,84 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { createNextApp } from './create-next.js';
+import { setupShadcn } from './setup-shadcn.js';
+import { installIntegrations, getEnvVars } from './integrations/index.js';
+import { generateClaudeMd, appendClaudeMd } from './claude-md.js';
+import { generateEnvFiles, appendEnvFiles } from './env.js';
+import { generateConfig, appendConfig } from './config.js';
+import { generateReadme, generateGitignore } from './generate-readme.js';
+import { generateInstrumentationClient, generateInstrumentation, } from './instrumentation.js';
+import { zustandTemplates } from './templates/zustand.js';
+import { generateLandingPage } from './landing-page.js';
+export async function createProject(config, onProgress) {
+    onProgress?.('Creating Next.js app...');
+    const projectPath = await createNextApp(config.name);
+    onProgress?.('Setting up shadcn/ui...');
+    await setupShadcn(projectPath);
+    await extendUtils(projectPath);
+    onProgress?.('Installing base packages...');
+    const { execa } = await import('execa');
+    await execa('npm', ['install', 'zod', 'zustand', 'luxon'], { cwd: projectPath });
+    await execa('npm', ['install', '-D', '@types/luxon'], { cwd: projectPath });
+    await fs.mkdir(path.join(projectPath, 'lib/stores'), { recursive: true });
+    await fs.writeFile(path.join(projectPath, 'lib/stores/counter.store.ts'), zustandTemplates.exampleStore);
+    if (config.integrations.length > 0) {
+        onProgress?.(`Setting up ${config.integrations.length} integration(s)...`);
+        await installIntegrations(projectPath, config);
+    }
+    await generateInstrumentationClient(projectPath, config);
+    await generateInstrumentation(projectPath, config);
+    onProgress?.('Generating config and environment files...');
+    await generateConfig(projectPath, config);
+    await generateEnvFiles(projectPath, config);
+    onProgress?.('Generating project files...');
+    await generateLandingPage(projectPath, config);
+    await generateGitignore(projectPath);
+    await generateReadme(projectPath, config);
+    await generateClaudeMd(projectPath, config);
+    const envVarsNeeded = collectEnvVars(config);
+    return { projectPath, integrations: config.integrations, envVarsNeeded };
+}
+export async function addIntegrations(projectPath, config, onProgress) {
+    onProgress?.(`Installing ${config.integrations.length} integration(s)...`);
+    await installIntegrations(projectPath, config);
+    onProgress?.('Updating config and environment files...');
+    await appendConfig(projectPath, config.integrations, config.aiProvider);
+    await appendEnvFiles(projectPath, config.integrations, config.aiProvider);
+    onProgress?.('Updating CLAUDE.md...');
+    await appendClaudeMd(projectPath, config.integrations);
+    const envVarsNeeded = collectEnvVars(config);
+    return { projectPath, integrations: config.integrations, envVarsNeeded };
+}
+async function extendUtils(projectPath) {
+    const utilsPath = path.join(projectPath, 'lib/utils.ts');
+    const existingContent = await fs.readFile(utilsPath, 'utf-8');
+    const additionalUtils = `
+import { DateTime } from 'luxon';
+
+export function formatDate(date: Date | string, format = 'LLL d, yyyy'): string {
+  const dt = typeof date === 'string' ? DateTime.fromISO(date) : DateTime.fromJSDate(date);
+  return dt.toFormat(format);
+}
+
+export function formatRelative(date: Date | string): string {
+  const dt = typeof date === 'string' ? DateTime.fromISO(date) : DateTime.fromJSDate(date);
+  return dt.toRelative() ?? dt.toFormat('LLL d, yyyy');
+}
+
+export function debounce<P extends unknown[], R>(
+  func: (...args: P) => R,
+  wait: number
+): (...args: P) => void {
+  let timeout: ReturnType<typeof setTimeout>;
+  return (...args: P) => {
+    clearTimeout(timeout);
+    timeout = setTimeout(() => func(...args), wait);
+  };
+}
+`;
+    await fs.writeFile(utilsPath, existingContent + additionalUtils);
+}
+function collectEnvVars(config) {
+    return getEnvVars(config).map((v) => v.key);
+}

package/dist/env.js

@@ -138,37 +138,24 @@ export async function generateEnvFiles(projectPath, config) {
         envExample += '\n';
     }
     await fs.writeFile(path.join(projectPath, '.env.example'), envExample.trim() + '\n');
-    // Generate .env.local with empty values
-    let envLocal = '';
+    // Generate .env with empty values
+    let env = '';
     for (const id of selectedIds) {
         const section = getEnvSection(id, config.aiProvider);
-        envLocal += generateEnvSection(section, false);
-        envLocal += '\n';
-    }
-    await fs.writeFile(path.join(projectPath, '.env.local'), envLocal.trim() + '\n');
-    // Update .gitignore to include .env.local
-    const gitignorePath = path.join(projectPath, '.gitignore');
-    try {
-        let gitignore = await fs.readFile(gitignorePath, 'utf-8');
-        if (!gitignore.includes('.env.local')) {
-            gitignore += '\n# Environment variables\n.env.local\n.env*.local\n';
-            await fs.writeFile(gitignorePath, gitignore);
-        }
-    }
-    catch {
-        // .gitignore doesn't exist, create it
-        await fs.writeFile(gitignorePath, '# Environment variables\n.env.local\n.env*.local\n');
+        env += generateEnvSection(section, false);
+        env += '\n';
     }
+    await fs.writeFile(path.join(projectPath, '.env'), env.trim() + '\n');
 }
 export async function appendEnvFiles(projectPath, integrations, aiProvider) {
     const envExamplePath = path.join(projectPath, '.env.example');
-    const envLocalPath = path.join(projectPath, '.env.local');
+    const envPath = path.join(projectPath, '.env');
     let envExampleContent = '';
-    let envLocalContent = '';
+    let envContent = '';
     for (const id of integrations) {
         const section = getEnvSection(id, aiProvider);
         envExampleContent += '\n' + generateEnvSection(section, true);
-        envLocalContent += '\n' + generateEnvSection(section, false);
+        envContent += '\n' + generateEnvSection(section, false);
     }
     if (envExampleContent) {
         try {
@@ -179,13 +166,13 @@ export async function appendEnvFiles(projectPath, integrations, aiProvider) {
             await fs.writeFile(envExamplePath, envExampleContent.trim() + '\n');
         }
     }
-    if (envLocalContent) {
+    if (envContent) {
         try {
-            const existing = await fs.readFile(envLocalPath, 'utf-8');
-            await fs.writeFile(envLocalPath, existing.trimEnd() + '\n' + envLocalContent.trim() + '\n');
+            const existing = await fs.readFile(envPath, 'utf-8');
+            await fs.writeFile(envPath, existing.trimEnd() + '\n' + envContent.trim() + '\n');
         }
         catch {
-            await fs.writeFile(envLocalPath, envLocalContent.trim() + '\n');
+            await fs.writeFile(envPath, envContent.trim() + '\n');
         }
     }
 }

package/dist/generate-readme.js

@@ -14,36 +14,36 @@ const integrationNames = {
     sentry: 'Sentry',
 };
 export async function generateReadme(projectPath, config) {
-    let content = `# ${config.name}
-
-A Next.js application scaffolded with [create-loadout](https://github.com/your-org/create-loadout).
-
-## Getting Started
-
-1. Install dependencies:
-   \`\`\`bash
-   npm install
-   \`\`\`
-
-2. Copy the environment file and configure your API keys:
-   \`\`\`bash
-   cp .env.example .env.local
-   \`\`\`
-
-3. Start the development server:
-   \`\`\`bash
-   npm run dev
-   \`\`\`
-
-4. Open [http://localhost:3000](http://localhost:3000) in your browser.
-
-## Tech Stack
-
-- [Next.js](https://nextjs.org/) - React framework
-- [TypeScript](https://www.typescriptlang.org/) - Type safety
-- [Tailwind CSS](https://tailwindcss.com/) - Styling
-- [shadcn/ui](https://ui.shadcn.com/) - UI components
-- [Zod](https://zod.dev/) - Schema validation
+    let content = `# ${config.name}
+
+A Next.js application scaffolded with [create-loadout](https://github.com/your-org/create-loadout).
+
+## Getting Started
+
+1. Install dependencies:
+   \`\`\`bash
+   npm install
+   \`\`\`
+
+2. Copy the environment file and configure your API keys:
+   \`\`\`bash
+   cp .env.example .env
+   \`\`\`
+
+3. Start the development server:
+   \`\`\`bash
+   npm run dev
+   \`\`\`
+
+4. Open [http://localhost:3000](http://localhost:3000) in your browser.
+
+## Tech Stack
+
+- [Next.js](https://nextjs.org/) - React framework
+- [TypeScript](https://www.typescriptlang.org/) - Type safety
+- [Tailwind CSS](https://tailwindcss.com/) - Styling
+- [shadcn/ui](https://ui.shadcn.com/) - UI components
+- [Zod](https://zod.dev/) - Schema validation
 `;
     if (config.integrations.length > 0) {
         content += `\n### Integrations\n\n`;
@@ -51,111 +51,114 @@ A Next.js application scaffolded with [create-loadout](https://github.com/your-o
             content += `- ${integrationNames[id]}\n`;
         }
     }
-    content += `
-## Scripts
-
-\`\`\`bash
-npm run dev       # Start development server
-npm run build     # Build for production
-npm run start     # Start production server
-npm run lint      # Run ESLint
-\`\`\`
+    content += `
+## Scripts
+
+\`\`\`bash
+npm run dev       # Start development server
+npm run build     # Build for production
+npm run start     # Start production server
+npm run lint      # Run ESLint
+\`\`\`
 `;
     if (config.integrations.includes('neon-drizzle')) {
-        content += `
-### Database
-
-\`\`\`bash
-npm run db:generate  # Generate migrations
-npm run db:migrate   # Run migrations
-npm run db:studio    # Open Drizzle Studio
-\`\`\`
+        content += `
+### Database
+
+\`\`\`bash
+npm run db:generate  # Generate migrations
+npm run db:migrate   # Run migrations
+npm run db:studio    # Open Drizzle Studio
+\`\`\`
 `;
     }
     if (config.integrations.includes('inngest')) {
-        content += `
-### Background Jobs
-
-\`\`\`bash
-npm run inngest:dev  # Start Inngest dev server
-\`\`\`
+        content += `
+### Background Jobs
+
+\`\`\`bash
+npm run inngest:dev  # Start Inngest dev server
+\`\`\`
 `;
     }
-    content += `
-## Project Structure
-
-\`\`\`
-├── app/           # Next.js App Router
-├── components/    # React components
-├── lib/           # Utilities and clients
-├── services/      # Business logic
+    content += `
+## Project Structure
+
+\`\`\`
+├── app/           # Next.js App Router
+├── components/    # React components
+├── lib/           # Utilities and clients
+├── services/      # Business logic
 `;
     if (config.integrations.includes('resend') || config.integrations.includes('postmark')) {
         content += `├── emails/        # Email templates\n`;
     }
-    content += `└── public/        # Static assets
-\`\`\`
-
-## Environment Variables
-
-See \`.env.example\` for all required environment variables.
-
-## Learn More
-
-- [Next.js Documentation](https://nextjs.org/docs)
-- [CLAUDE.md](./CLAUDE.md) - AI assistant context file
+    content += `└── public/        # Static assets
+\`\`\`
+
+## Environment Variables
+
+See \`.env.example\` for all required environment variables.
+
+## Learn More
+
+- [Next.js Documentation](https://nextjs.org/docs)
+- [CLAUDE.md](./CLAUDE.md) - AI assistant context file
 `;
     await fs.writeFile(path.join(projectPath, 'README.md'), content);
 }
 export async function generateGitignore(projectPath) {
-    const content = `# Dependencies
-node_modules/
-.pnp/
-.pnp.js
-
-# Build
-.next/
-out/
-build/
-dist/
-
-# Environment
-.env
-.env.local
-.env.development.local
-.env.test.local
-.env.production.local
-
-# Testing
-coverage/
-
-# IDE
-.vscode/
-.idea/
-*.swp
-*.swo
-
-# OS
-.DS_Store
-Thumbs.db
-
-# Debug
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-
-# Vercel
-.vercel
-
-# TypeScript
-*.tsbuildinfo
-next-env.d.ts
-
-# Drizzle
-drizzle/
-
-# Sentry
-.sentryclirc
+    const content = `# Dependencies
+node_modules/
+.pnp/
+.pnp.js
+
+# Build
+.next/
+out/
+build/
+dist/
+
+# Environment
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Testing
+coverage/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Claude Code
+.claude/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Vercel
+.vercel
+
+# TypeScript
+*.tsbuildinfo
+next-env.d.ts
+
+# Drizzle
+drizzle/
+
+# Sentry
+.sentryclirc
 `;
     await fs.writeFile(path.join(projectPath, '.gitignore'), content);
 }