@girardmedia/bootspring 2.5.0 → 2.5.2

package/generators/sections/identity.js

@@ -1,76 +0,0 @@
-/**
- * Project Identity Section
- *
- * Collects project name, description, and basic metadata.
- *
- * @package bootspring
- * @module generators/sections/identity
- */
-
-const path = require('path');
-const utils = require('../../core/utils');
-
-const title = 'Project Identity';
-const description = 'Tell me about your project';
-
-/**
- * Run the identity section
- */
-async function run(rl, previousAnswers, helpers) {
-  const { askText, askChoice } = helpers;
-
-  // Detect default name from directory
-  const defaultName = path.basename(process.cwd());
-
-  // Try to get name from package.json
-  const pkg = utils.getPackageJson(process.cwd());
-  const detectedName = pkg?.name || defaultName;
-
-  const answers = {};
-
-  // Project name
-  answers.projectName = await askText(
-    rl,
-    'Project name',
-    detectedName
-  );
-
-  // Description
-  answers.projectDescription = await askText(
-    rl,
-    'Brief description (one line)',
-    pkg?.description || ''
-  );
-
-  // Project status
-  answers.projectStatus = await askChoice(
-    rl,
-    'Current project status:',
-    [
-      { label: 'Planning', value: 'planning', description: 'Still in planning phase' },
-      { label: 'Development', value: 'development', description: 'Actively building' },
-      { label: 'MVP', value: 'mvp', description: 'Have a working MVP' },
-      { label: 'Production', value: 'production', description: 'Live with users' }
-    ],
-    previousAnswers.hasExistingMVP ? 2 : 1
-  );
-
-  // Version (if MVP or later)
-  if (['mvp', 'production'].includes(answers.projectStatus)) {
-    answers.projectVersion = await askText(
-      rl,
-      'Current version',
-      pkg?.version || '0.1.0'
-    );
-  } else {
-    answers.projectVersion = '0.1.0';
-  }
-
-  return answers;
-}
-
-module.exports = {
-  title,
-  description,
-  run
-};

package/generators/sections/index.js

@@ -1,40 +0,0 @@
-/**
- * Questionnaire Sections Index
- *
- * @package bootspring
- * @module generators/sections
- */
-
-module.exports = {
-  // Core sections
-  'pre-build': require('./pre-build'),
-  'identity': require('./identity'),
-  'business': require('./business'),
-  'technical': require('./technical'),
-
-  // Stack sections
-  'frontend': require('./frontend'),
-  'backend': require('./backend'),
-
-  // Integration sections
-  'auth': require('./auth'),
-  'payments': require('./payments'),
-  'ai': require('./ai'),
-
-  // Quality & DevOps sections
-  'testing': require('./testing'),
-  'deployment': require('./deployment'),
-  'security': require('./security'),
-
-  // Features & Workflow sections
-  'features': require('./features'),
-  'workflow': require('./workflow'),
-  'instructions': require('./instructions'),
-
-  // Content & Documentation section
-  'content': require('./content'),
-
-  // Legacy sections
-  'plugins': require('./plugins'),
-  'advanced': require('./advanced')
-};

package/generators/sections/instructions.js

@@ -1,146 +0,0 @@
-/**
- * Custom Instructions Section
- *
- * Collects build rules, forbidden patterns, and preferences.
- *
- * @package bootspring
- * @module generators/sections/instructions
- */
-
-const title = 'Custom Instructions';
-const description = 'Your development preferences';
-
-/**
- * Skip in minimal preset
- */
-function shouldSkip(_previousAnswers) {
-  return false; // Can be skipped manually
-}
-
-/**
- * Run the instructions section
- */
-async function run(rl, previousAnswers, helpers) {
-  const { askYesNo, askMultiSelect, askText } = helpers;
-
-  const answers = {
-    customInstructions: {}
-  };
-
-  console.log('\nThese instructions will be included in your CLAUDE.md');
-
-  // Component preferences (for frontend frameworks)
-  const isFrontend = ['nextjs', 'remix', 'nuxt', 'sveltekit'].includes(previousAnswers.framework);
-
-  if (isFrontend) {
-    answers.customInstructions.componentPreferences = await askMultiSelect(
-      rl,
-      'Component preferences:',
-      [
-        { label: 'Prefer Server Components', value: 'server-components' },
-        { label: 'Use Server Actions for mutations', value: 'server-actions' },
-        { label: 'Keep components small (<100 lines)', value: 'small-components' },
-        { label: 'Colocate styles with components', value: 'colocate-styles' },
-        { label: 'Use composition over inheritance', value: 'composition' }
-      ],
-      ['server-components', 'server-actions', 'small-components']
-    );
-
-    answers.customInstructions.stylingPreferences = await askMultiSelect(
-      rl,
-      'Styling preferences:',
-      [
-        { label: 'Tailwind CSS', value: 'tailwind' },
-        { label: 'CSS Modules', value: 'css-modules' },
-        { label: 'Styled Components', value: 'styled-components' },
-        { label: 'Mobile-first responsive', value: 'mobile-first' }
-      ],
-      ['tailwind', 'mobile-first']
-    );
-  }
-
-  // Validation preferences
-  answers.customInstructions.validationPreferences = await askMultiSelect(
-    rl,
-    'Validation and type safety:',
-    [
-      { label: 'Use Zod for all input validation', value: 'zod' },
-      { label: 'Strict TypeScript mode', value: 'strict-ts' },
-      { label: 'Validate at API boundaries', value: 'api-validation' },
-      { label: 'Runtime type checking', value: 'runtime-types' }
-    ],
-    ['zod', 'strict-ts', 'api-validation']
-  );
-
-  // Security rules
-  answers.customInstructions.securityRules = await askMultiSelect(
-    rl,
-    'Security rules:',
-    [
-      { label: 'Never expose API keys to client', value: 'no-client-keys' },
-      { label: 'Use environment variables for secrets', value: 'env-secrets' },
-      { label: 'Sanitize all user input', value: 'sanitize-input' },
-      { label: 'Use parameterized queries', value: 'parameterized-queries' },
-      { label: 'Implement rate limiting', value: 'rate-limiting' }
-    ],
-    ['no-client-keys', 'env-secrets', 'sanitize-input', 'parameterized-queries']
-  );
-
-  // Testing rules
-  if (previousAnswers.enableTesting) {
-    answers.customInstructions.testingRules = await askMultiSelect(
-      rl,
-      'Testing rules:',
-      [
-        { label: 'Write tests for new features', value: 'test-new-features' },
-        { label: 'Maintain 80%+ coverage', value: 'coverage-80' },
-        { label: 'Test edge cases explicitly', value: 'test-edge-cases' },
-        { label: 'Use meaningful test names', value: 'meaningful-names' }
-      ],
-      ['test-new-features', 'test-edge-cases']
-    );
-  }
-
-  // Forbidden patterns
-  const wantForbidden = await askYesNo(
-    rl,
-    'Define forbidden patterns (things to avoid)?',
-    false
-  );
-
-  if (wantForbidden) {
-    const forbiddenInput = await askText(
-      rl,
-      'Forbidden patterns (comma-separated)',
-      'any, console.log in production, TODO comments in PRs'
-    );
-    answers.customInstructions.forbiddenPatterns = forbiddenInput
-      .split(',')
-      .map(s => s.trim())
-      .filter(Boolean);
-  }
-
-  // Additional instructions
-  const wantAdditional = await askYesNo(
-    rl,
-    'Add custom build instructions?',
-    false
-  );
-
-  if (wantAdditional) {
-    answers.customInstructions.additionalInstructions = await askText(
-      rl,
-      'Custom instructions (one line)',
-      ''
-    );
-  }
-
-  return answers;
-}
-
-module.exports = {
-  title,
-  description,
-  shouldSkip,
-  run
-};

package/generators/sections/payments.js

@@ -1,104 +0,0 @@
-/**
- * Payments Section
- *
- * Payment processing, subscriptions, and monetization.
- *
- * @package bootspring
- * @module generators/sections/payments
- */
-
-const title = 'Payments & Monetization';
-const description = 'Payment processing setup';
-
-/**
- * Run the payments section
- */
-async function run(rl, previousAnswers, helpers) {
-  const { askChoice, askMultiSelect, askYesNo } = helpers;
-  const answers = {};
-
-  // Enable payments
-  answers.enablePayments = await askYesNo(
-    rl,
-    'Does your app need payment processing?',
-    false
-  );
-
-  if (!answers.enablePayments) {
-    return answers;
-  }
-
-  // Payment Provider
-  const providerOptions = [
-    { label: 'Stripe', value: 'stripe', description: 'Industry standard (Recommended)' },
-    { label: 'Lemon Squeezy', value: 'lemonsqueezy', description: 'Merchant of record' },
-    { label: 'Paddle', value: 'paddle', description: 'Merchant of record' },
-    { label: 'PayPal', value: 'paypal', description: 'PayPal payments' },
-    { label: 'Square', value: 'square', description: 'Square payments' }
-  ];
-
-  answers.paymentsProvider = await askChoice(
-    rl,
-    'Payment provider:',
-    providerOptions,
-    0
-  );
-
-  // Payment Types
-  const typeOptions = [
-    { label: 'One-time payments', value: 'onetime' },
-    { label: 'Subscriptions', value: 'subscriptions' },
-    { label: 'Usage-based billing', value: 'usage' },
-    { label: 'Per-seat pricing', value: 'seats' },
-    { label: 'Credits/tokens', value: 'credits' }
-  ];
-
-  answers.paymentTypes = await askMultiSelect(
-    rl,
-    'Payment types needed:',
-    typeOptions,
-    ['subscriptions']
-  );
-
-  // Pricing Tiers
-  if (answers.paymentTypes.includes('subscriptions')) {
-    const tierOptions = [
-      { label: 'Free + Pro', value: 'freepro', description: 'Simple freemium' },
-      { label: 'Free + Pro + Enterprise', value: 'freeproent', description: 'Standard SaaS' },
-      { label: 'Multiple tiers', value: 'multi', description: 'Complex pricing' },
-      { label: 'Custom', value: 'custom', description: 'Define later' }
-    ];
-
-    answers.pricingTiers = await askChoice(
-      rl,
-      'Pricing model:',
-      tierOptions,
-      1
-    );
-  }
-
-  // Additional features
-  const featureOptions = [
-    { label: 'Invoices', value: 'invoices' },
-    { label: 'Tax handling', value: 'tax' },
-    { label: 'Refunds', value: 'refunds' },
-    { label: 'Coupons/discounts', value: 'coupons' },
-    { label: 'Free trials', value: 'trials' },
-    { label: 'Customer portal', value: 'portal' }
-  ];
-
-  answers.paymentFeatures = await askMultiSelect(
-    rl,
-    'Payment features:',
-    featureOptions,
-    ['portal', 'refunds']
-  );
-
-  return answers;
-}
-
-module.exports = {
-  title,
-  description,
-  run
-};

package/generators/sections/plugins.js

@@ -1,142 +0,0 @@
-/**
- * Core Plugins Section
- *
- * Collects plugin choices: auth, payments, AI, testing.
- *
- * @package bootspring
- * @module generators/sections/plugins
- */
-
-const title = 'Core Plugins';
-const description = 'Select the features you need';
-
-/**
- * Run the plugins section
- */
-async function run(rl, previousAnswers, helpers) {
-  const { askYesNo, askChoice, askMultiSelect } = helpers;
-
-  const answers = {};
-
-  // Authentication
-  answers.enableAuth = await askYesNo(
-    rl,
-    'Enable authentication?',
-    true
-  );
-
-  if (answers.enableAuth) {
-    answers.authProvider = await askChoice(
-      rl,
-      'Auth provider:',
-      [
-        { label: 'Clerk', value: 'clerk', description: 'Full-featured, easy setup' },
-        { label: 'NextAuth/Auth.js', value: 'nextauth', description: 'Flexible, self-hosted' },
-        { label: 'Supabase Auth', value: 'supabase', description: 'With Supabase backend' },
-        { label: 'Custom', value: 'custom', description: 'Build your own' }
-      ],
-      0
-    );
-
-    answers.authFeatures = [];
-    const wantOAuth = await askYesNo(rl, 'Include OAuth providers (Google, GitHub)?', true);
-    if (wantOAuth) answers.authFeatures.push('oauth');
-
-    const wantMagicLink = await askYesNo(rl, 'Include magic link / passwordless?', false);
-    if (wantMagicLink) answers.authFeatures.push('magic-link');
-
-    const wantMFA = await askYesNo(rl, 'Include MFA / 2FA?', false);
-    if (wantMFA) answers.authFeatures.push('mfa');
-  }
-
-  // Payments
-  answers.enablePayments = await askYesNo(
-    rl,
-    'Enable payments/billing?',
-    false
-  );
-
-  if (answers.enablePayments) {
-    answers.paymentsProvider = await askChoice(
-      rl,
-      'Payments provider:',
-      [
-        { label: 'Stripe', value: 'stripe', description: 'Most popular, full-featured' },
-        { label: 'Paddle', value: 'paddle', description: 'MoR, handles taxes' },
-        { label: 'Lemon Squeezy', value: 'lemonsqueezy', description: 'Simple, MoR' }
-      ],
-      0
-    );
-
-    answers.paymentFeatures = [];
-    const wantSubscriptions = await askYesNo(rl, 'Include subscriptions?', true);
-    if (wantSubscriptions) answers.paymentFeatures.push('subscriptions');
-
-    const wantOneTime = await askYesNo(rl, 'Include one-time payments?', false);
-    if (wantOneTime) answers.paymentFeatures.push('one-time');
-
-    const wantWebhooks = await askYesNo(rl, 'Include webhook handling?', true);
-    if (wantWebhooks) answers.paymentFeatures.push('webhooks');
-  }
-
-  // AI Integration
-  answers.enableAI = await askYesNo(
-    rl,
-    'Enable AI integration?',
-    false
-  );
-
-  if (answers.enableAI) {
-    answers.aiProviders = await askMultiSelect(
-      rl,
-      'AI providers (select one or more):',
-      [
-        { label: 'Anthropic (Claude)', value: 'anthropic', description: 'Claude API' },
-        { label: 'OpenAI', value: 'openai', description: 'GPT models' },
-        { label: 'Google AI', value: 'google', description: 'Gemini models' },
-        { label: 'Cohere', value: 'cohere', description: 'Enterprise NLP' },
-        { label: 'Hugging Face', value: 'huggingface', description: 'Open source models' }
-      ],
-      ['anthropic']
-    );
-
-    answers.aiFeatures = [];
-    const wantChat = await askYesNo(rl, 'Include chat/conversation?', true);
-    if (wantChat) answers.aiFeatures.push('chat');
-
-    const wantStreaming = await askYesNo(rl, 'Include streaming responses?', true);
-    if (wantStreaming) answers.aiFeatures.push('streaming');
-
-    const wantToolUse = await askYesNo(rl, 'Include tool use / function calling?', false);
-    if (wantToolUse) answers.aiFeatures.push('tool-use');
-  }
-
-  // Testing
-  answers.enableTesting = await askYesNo(
-    rl,
-    'Enable testing?',
-    true
-  );
-
-  if (answers.enableTesting) {
-    answers.testingProvider = await askChoice(
-      rl,
-      'Testing framework:',
-      [
-        { label: 'Vitest', value: 'vitest', description: 'Fast, Vite-native' },
-        { label: 'Jest', value: 'jest', description: 'Classic, full-featured' },
-        { label: 'Playwright', value: 'playwright', description: 'E2E testing' },
-        { label: 'Both unit + E2E', value: 'both', description: 'Vitest + Playwright' }
-      ],
-      0
-    );
-  }
-
-  return answers;
-}
-
-module.exports = {
-  title,
-  description,
-  run
-};

package/generators/sections/pre-build.js

@@ -1,130 +0,0 @@
-/**
- * Pre-Build Assets Section
- *
- * Detects existing MVP code, business docs, and assets
- * before starting the project setup.
- *
- * @package bootspring
- * @module generators/sections/pre-build
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const title = 'Pre-Build Assets';
-const description = 'Let me check what you already have...';
-
-/**
- * Detect existing project assets
- */
-function detectAssets(projectRoot) {
-  const assets = {
-    hasPackageJson: false,
-    hasReadme: false,
-    hasExistingCode: false,
-    hasPrismaSchema: false,
-    hasEnvExample: false,
-    hasDocumentation: false,
-    hasMVP: false,
-    detectedFiles: []
-  };
-
-  // Check for common files
-  const checks = [
-    { file: 'package.json', flag: 'hasPackageJson' },
-    { file: 'README.md', flag: 'hasReadme' },
-    { file: 'prisma/schema.prisma', flag: 'hasPrismaSchema' },
-    { file: '.env.example', flag: 'hasEnvExample' },
-    { file: 'docs', flag: 'hasDocumentation', isDir: true },
-    { file: 'src', flag: 'hasExistingCode', isDir: true },
-    { file: 'app', flag: 'hasExistingCode', isDir: true }
-  ];
-
-  for (const check of checks) {
-    const fullPath = path.join(projectRoot, check.file);
-    const exists = check.isDir
-      ? fs.existsSync(fullPath) && fs.statSync(fullPath).isDirectory()
-      : fs.existsSync(fullPath);
-
-    if (exists) {
-      assets[check.flag] = true;
-      assets.detectedFiles.push(check.file);
-    }
-  }
-
-  // Detect MVP indicators
-  assets.hasMVP = assets.hasExistingCode && assets.hasPackageJson;
-
-  return assets;
-}
-
-/**
- * Run the pre-build section
- */
-async function run(rl, previousAnswers, helpers) {
-  const { askYesNo, askText } = helpers;
-  const projectRoot = process.cwd();
-
-  // Detect existing assets
-  const assets = detectAssets(projectRoot);
-
-  console.log('\nDetected assets:');
-  if (assets.detectedFiles.length > 0) {
-    assets.detectedFiles.forEach(f => {
-      console.log(`  ✓ ${f}`);
-    });
-  } else {
-    console.log('  (No existing files detected - fresh project)');
-  }
-
-  const answers = {
-    preBuildAssets: assets
-  };
-
-  // Ask about existing MVP
-  if (assets.hasMVP) {
-    answers.hasExistingMVP = await askYesNo(
-      rl,
-      '\nYou have existing code. Is this an MVP you want to build upon?',
-      true
-    );
-
-    if (answers.hasExistingMVP) {
-      answers.mvpDescription = await askText(
-        rl,
-        'Briefly describe what the MVP does',
-        ''
-      );
-    }
-  }
-
-  // Ask about business docs
-  answers.hasBusinessDocs = await askYesNo(
-    rl,
-    'Do you have existing business documents (PRD, pitch deck, etc.)?',
-    false
-  );
-
-  if (answers.hasBusinessDocs) {
-    answers.businessDocsLocation = await askText(
-      rl,
-      'Where are they located?',
-      './docs'
-    );
-  }
-
-  // Ask about design assets
-  answers.hasDesignAssets = await askYesNo(
-    rl,
-    'Do you have design assets (Figma, mockups, etc.)?',
-    false
-  );
-
-  return answers;
-}
-
-module.exports = {
-  title,
-  description,
-  run
-};