@girardmedia/bootspring 2.5.0 → 2.5.2

package/generators/sections/content.js

@@ -1,300 +0,0 @@
-/**
- * Content Section
- *
- * Content strategy, documentation, and publishing planning.
- *
- * @package bootspring
- * @module generators/sections/content
- */
-
-const title = 'Content & Documentation';
-const description = 'Content strategy and documentation planning';
-
-/**
- * Run the content section
- */
-async function run(rl, previousAnswers, helpers) {
-  const { askChoice, askMultiSelect, askText } = helpers;
-  const answers = {};
-
-  // Content Strategy
-  const strategyOptions = [
-    { label: 'Developer-focused', value: 'developer', description: 'Technical docs, tutorials, API refs' },
-    { label: 'Marketing-focused', value: 'marketing', description: 'Landing pages, blog, case studies' },
-    { label: 'Mixed (Dev + Marketing)', value: 'mixed', description: 'Both technical and marketing' },
-    { label: 'Internal only', value: 'internal', description: 'Internal docs and wikis' },
-    { label: 'Minimal', value: 'minimal', description: 'Just README and basics' }
-  ];
-
-  answers.contentStrategy = await askChoice(
-    rl,
-    'Content strategy:',
-    strategyOptions,
-    2
-  );
-
-  // Documentation Types
-  const docTypeOptions = [
-    { label: 'Getting Started guide', value: 'getting-started' },
-    { label: 'API Reference', value: 'api-reference' },
-    { label: 'Tutorials/Guides', value: 'tutorials' },
-    { label: 'Architecture docs', value: 'architecture' },
-    { label: 'Contributing guide', value: 'contributing' },
-    { label: 'Changelog', value: 'changelog' },
-    { label: 'FAQ', value: 'faq' },
-    { label: 'Troubleshooting', value: 'troubleshooting' }
-  ];
-
-  const defaultDocs = {
-    developer: ['getting-started', 'api-reference', 'tutorials', 'contributing', 'changelog'],
-    marketing: ['getting-started', 'faq'],
-    mixed: ['getting-started', 'api-reference', 'tutorials', 'faq', 'changelog'],
-    internal: ['architecture', 'contributing', 'troubleshooting'],
-    minimal: ['getting-started']
-  };
-
-  answers.documentationTypes = await askMultiSelect(
-    rl,
-    'Documentation to generate:',
-    docTypeOptions,
-    defaultDocs[answers.contentStrategy] || defaultDocs.minimal
-  );
-
-  // Blog/Content Publishing
-  const publishingOptions = [
-    { label: 'Yes, blog with regular posts', value: 'blog', description: 'Regular content publishing' },
-    { label: 'Yes, announcements only', value: 'announcements', description: 'Release notes, updates' },
-    { label: 'Yes, technical blog', value: 'technical', description: 'Tutorials, deep dives' },
-    { label: 'No blog planned', value: 'none', description: 'No content publishing' }
-  ];
-
-  answers.contentPublishing = await askChoice(
-    rl,
-    'Content publishing:',
-    publishingOptions,
-    answers.contentStrategy === 'marketing' ? 0 :
-      answers.contentStrategy === 'developer' ? 2 : 3
-  );
-
-  // Content Formats
-  if (answers.contentPublishing !== 'none') {
-    const formatOptions = [
-      { label: 'Blog posts', value: 'blog-posts' },
-      { label: 'Tutorials', value: 'tutorials' },
-      { label: 'Case studies', value: 'case-studies' },
-      { label: 'Video content', value: 'video' },
-      { label: 'Newsletter', value: 'newsletter' },
-      { label: 'Social media', value: 'social' },
-      { label: 'Podcasts', value: 'podcasts' },
-      { label: 'Webinars', value: 'webinars' }
-    ];
-
-    const defaultFormats = {
-      blog: ['blog-posts', 'social', 'newsletter'],
-      announcements: ['blog-posts'],
-      technical: ['tutorials', 'blog-posts', 'video']
-    };
-
-    answers.contentFormats = await askMultiSelect(
-      rl,
-      'Content formats:',
-      formatOptions,
-      defaultFormats[answers.contentPublishing] || []
-    );
-  }
-
-  // SEO Priority
-  const seoOptions = [
-    { label: 'High priority', value: 'high', description: 'Full SEO optimization' },
-    { label: 'Medium priority', value: 'medium', description: 'Basic SEO practices' },
-    { label: 'Low priority', value: 'low', description: 'Minimal SEO focus' },
-    { label: 'Not applicable', value: 'none', description: 'Internal/private content' }
-  ];
-
-  answers.seoPriority = await askChoice(
-    rl,
-    'SEO priority:',
-    seoOptions,
-    answers.contentStrategy === 'marketing' ? 0 : 1
-  );
-
-  // Documentation Platform
-  const platformOptions = [
-    { label: 'Built into app (MDX/Next.js)', value: 'builtin', description: 'Self-hosted docs' },
-    { label: 'Docusaurus', value: 'docusaurus', description: 'React-based docs' },
-    { label: 'GitBook', value: 'gitbook', description: 'Hosted docs platform' },
-    { label: 'ReadMe', value: 'readme', description: 'API docs platform' },
-    { label: 'Notion', value: 'notion', description: 'Wiki-style docs' },
-    { label: 'GitHub Wiki', value: 'github-wiki', description: 'Simple wiki' },
-    { label: 'Custom', value: 'custom', description: 'Build from scratch' }
-  ];
-
-  answers.docsPlatform = await askChoice(
-    rl,
-    'Documentation platform:',
-    platformOptions,
-    0
-  );
-
-  // Writing Style
-  const styleOptions = [
-    { label: 'Technical & precise', value: 'technical', description: 'Developer-focused, detailed' },
-    { label: 'Friendly & approachable', value: 'friendly', description: 'Casual, welcoming' },
-    { label: 'Professional & formal', value: 'professional', description: 'Enterprise, formal' },
-    { label: 'Minimal & concise', value: 'minimal', description: 'Brief, to the point' }
-  ];
-
-  answers.writingStyle = await askChoice(
-    rl,
-    'Writing style:',
-    styleOptions,
-    answers.contentStrategy === 'marketing' ? 1 :
-      answers.contentStrategy === 'internal' ? 2 : 0
-  );
-
-  // Content Templates
-  const templateOptions = [
-    { label: 'README template', value: 'readme' },
-    { label: 'Blog post template', value: 'blog' },
-    { label: 'API endpoint docs', value: 'api-docs' },
-    { label: 'Release notes template', value: 'release-notes' },
-    { label: 'Tutorial template', value: 'tutorial' },
-    { label: 'Landing page copy', value: 'landing' },
-    { label: 'Email templates', value: 'email' },
-    { label: 'Social media templates', value: 'social' }
-  ];
-
-  answers.contentTemplates = await askMultiSelect(
-    rl,
-    'Content templates to generate:',
-    templateOptions,
-    ['readme', 'blog', 'release-notes']
-  );
-
-  // Localization
-  const localizationOptions = [
-    { label: 'English only', value: 'en', description: 'Single language' },
-    { label: 'English + top languages', value: 'multi-top', description: 'EN, ES, FR, DE, ZH' },
-    { label: 'Full i18n', value: 'full', description: 'All major languages' },
-    { label: 'Community translations', value: 'community', description: 'Crowdsourced' }
-  ];
-
-  answers.localization = await askChoice(
-    rl,
-    'Content localization:',
-    localizationOptions,
-    0
-  );
-
-  // Content calendar
-  if (answers.contentPublishing !== 'none') {
-    const calendarOptions = [
-      { label: 'Weekly publishing', value: 'weekly', description: '1+ posts per week' },
-      { label: 'Bi-weekly publishing', value: 'biweekly', description: '2 posts per month' },
-      { label: 'Monthly publishing', value: 'monthly', description: '1 post per month' },
-      { label: 'Release-driven', value: 'release', description: 'Publish with releases' },
-      { label: 'Ad-hoc', value: 'adhoc', description: 'No schedule' }
-    ];
-
-    answers.contentCadence = await askChoice(
-      rl,
-      'Content cadence:',
-      calendarOptions,
-      3
-    );
-  }
-
-  return answers;
-}
-
-/**
- * Generate content-related CLAUDE.md sections
- */
-function generateSection(answers) {
-  const sections = [];
-
-  if (answers.contentStrategy && answers.contentStrategy !== 'minimal') {
-    sections.push(`## Content Strategy
-
-- **Strategy**: ${answers.contentStrategy}
-- **Writing Style**: ${answers.writingStyle || 'technical'}
-- **SEO Priority**: ${answers.seoPriority || 'medium'}
-- **Documentation Platform**: ${answers.docsPlatform || 'builtin'}
-- **Localization**: ${answers.localization || 'en'}
-`);
-  }
-
-  if (answers.documentationTypes && answers.documentationTypes.length > 0) {
-    sections.push(`### Documentation Types
-
-${answers.documentationTypes.map(d => `- ${formatDocType(d)}`).join('\n')}
-`);
-  }
-
-  if (answers.contentFormats && answers.contentFormats.length > 0) {
-    sections.push(`### Content Formats
-
-${answers.contentFormats.map(f => `- ${formatContentFormat(f)}`).join('\n')}
-
-**Cadence**: ${answers.contentCadence || 'ad-hoc'}
-`);
-  }
-
-  if (answers.contentTemplates && answers.contentTemplates.length > 0) {
-    sections.push(`### Content Templates
-
-${answers.contentTemplates.map(t => `- ${formatTemplate(t)}`).join('\n')}
-`);
-  }
-
-  return sections.join('\n');
-}
-
-function formatDocType(type) {
-  const labels = {
-    'getting-started': 'Getting Started Guide',
-    'api-reference': 'API Reference',
-    'tutorials': 'Tutorials & Guides',
-    'architecture': 'Architecture Documentation',
-    'contributing': 'Contributing Guide',
-    'changelog': 'Changelog',
-    'faq': 'FAQ',
-    'troubleshooting': 'Troubleshooting Guide'
-  };
-  return labels[type] || type;
-}
-
-function formatContentFormat(format) {
-  const labels = {
-    'blog-posts': 'Blog Posts',
-    'tutorials': 'Tutorial Articles',
-    'case-studies': 'Case Studies',
-    'video': 'Video Content',
-    'newsletter': 'Email Newsletter',
-    'social': 'Social Media',
-    'podcasts': 'Podcast Episodes',
-    'webinars': 'Webinars'
-  };
-  return labels[format] || format;
-}
-
-function formatTemplate(template) {
-  const labels = {
-    'readme': 'README Template',
-    'blog': 'Blog Post Template',
-    'api-docs': 'API Documentation Template',
-    'release-notes': 'Release Notes Template',
-    'tutorial': 'Tutorial Template',
-    'landing': 'Landing Page Copy Template',
-    'email': 'Email Templates',
-    'social': 'Social Media Templates'
-  };
-  return labels[template] || template;
-}
-
-module.exports = {
-  title,
-  description,
-  run,
-  generateSection
-};

package/generators/sections/deployment.js

@@ -1,139 +0,0 @@
-/**
- * Deployment Section
- *
- * DevOps, CI/CD, and deployment configuration.
- *
- * @package bootspring
- * @module generators/sections/deployment
- */
-
-const title = 'DevOps & Deployment';
-const description = 'CI/CD and deployment setup';
-
-/**
- * Run the deployment section
- */
-async function run(rl, previousAnswers, helpers) {
-  const { askChoice, askMultiSelect, askYesNo } = helpers;
-  const answers = {};
-
-  // Environments
-  const envOptions = [
-    { label: 'Production only', value: 'prod', description: 'Single environment' },
-    { label: 'Production + Preview', value: 'prod-preview', description: 'Standard setup' },
-    { label: 'Dev + Staging + Production', value: 'full', description: 'Full pipeline' },
-    { label: 'Custom', value: 'custom', description: 'Define your own' }
-  ];
-
-  answers.environments = await askChoice(
-    rl,
-    'Deployment environments:',
-    envOptions,
-    1
-  );
-
-  // CI/CD Platform
-  const ciOptions = [
-    { label: 'GitHub Actions', value: 'github', description: 'GitHub native (Recommended)' },
-    { label: 'Vercel', value: 'vercel', description: 'Automatic with Vercel' },
-    { label: 'GitLab CI', value: 'gitlab', description: 'GitLab pipelines' },
-    { label: 'CircleCI', value: 'circleci', description: 'Popular CI service' },
-    { label: 'None', value: 'none', description: 'Manual deployment' }
-  ];
-
-  answers.ciPlatform = await askChoice(
-    rl,
-    'CI/CD platform:',
-    ciOptions,
-    0
-  );
-
-  // Branch Strategy
-  const branchOptions = [
-    { label: 'Trunk-based', value: 'trunk', description: 'Deploy from main' },
-    { label: 'Git Flow', value: 'gitflow', description: 'Feature/develop/release branches' },
-    { label: 'GitHub Flow', value: 'github-flow', description: 'Feature branches + PRs' },
-    { label: 'Custom', value: 'custom', description: 'Your own strategy' }
-  ];
-
-  answers.branchStrategy = await askChoice(
-    rl,
-    'Branch strategy:',
-    branchOptions,
-    2
-  );
-
-  // Pipeline Steps
-  const pipelineOptions = [
-    { label: 'Lint', value: 'lint' },
-    { label: 'Type check', value: 'typecheck' },
-    { label: 'Unit tests', value: 'unit' },
-    { label: 'Integration tests', value: 'integration' },
-    { label: 'E2E tests', value: 'e2e' },
-    { label: 'Security scan', value: 'security' },
-    { label: 'Build', value: 'build' },
-    { label: 'Deploy preview', value: 'preview' }
-  ];
-
-  answers.pipelineSteps = await askMultiSelect(
-    rl,
-    'CI pipeline steps:',
-    pipelineOptions,
-    ['lint', 'typecheck', 'unit', 'build']
-  );
-
-  // Monitoring
-  answers.enableMonitoring = await askYesNo(
-    rl,
-    'Set up monitoring/observability?',
-    false
-  );
-
-  if (answers.enableMonitoring) {
-    const monitoringOptions = [
-      { label: 'Sentry', value: 'sentry', description: 'Error tracking' },
-      { label: 'LogRocket', value: 'logrocket', description: 'Session replay' },
-      { label: 'Datadog', value: 'datadog', description: 'Full observability' },
-      { label: 'New Relic', value: 'newrelic', description: 'APM' },
-      { label: 'Vercel Analytics', value: 'vercel', description: 'Basic analytics' }
-    ];
-
-    answers.monitoringProvider = await askChoice(
-      rl,
-      'Monitoring provider:',
-      monitoringOptions,
-      0
-    );
-  }
-
-  // Feature Flags
-  answers.enableFeatureFlags = await askYesNo(
-    rl,
-    'Need feature flags?',
-    false
-  );
-
-  if (answers.enableFeatureFlags) {
-    const flagOptions = [
-      { label: 'LaunchDarkly', value: 'launchdarkly', description: 'Enterprise flags' },
-      { label: 'PostHog', value: 'posthog', description: 'Product analytics + flags' },
-      { label: 'Flagsmith', value: 'flagsmith', description: 'Open source flags' },
-      { label: 'Custom', value: 'custom', description: 'Build your own' }
-    ];
-
-    answers.featureFlagProvider = await askChoice(
-      rl,
-      'Feature flag provider:',
-      flagOptions,
-      1
-    );
-  }
-
-  return answers;
-}
-
-module.exports = {
-  title,
-  description,
-  run
-};

package/generators/sections/features.js

@@ -1,122 +0,0 @@
-/**
- * Features Section
- *
- * Application features and functionality planning.
- *
- * @package bootspring
- * @module generators/sections/features
- */
-
-const title = 'Features & Functionality';
-const description = 'Core features planning';
-
-/**
- * Run the features section
- */
-async function run(rl, previousAnswers, helpers) {
-  const { askChoice, askMultiSelect, askText } = helpers;
-  const answers = {};
-
-  // App Type
-  const typeOptions = [
-    { label: 'SaaS Application', value: 'saas', description: 'Software as a Service' },
-    { label: 'Marketplace', value: 'marketplace', description: 'Two-sided platform' },
-    { label: 'E-commerce', value: 'ecommerce', description: 'Online store' },
-    { label: 'Content Platform', value: 'content', description: 'Blog, media, CMS' },
-    { label: 'Internal Tool', value: 'internal', description: 'Business tool' },
-    { label: 'API/Developer Tool', value: 'api', description: 'Developer-focused' },
-    { label: 'Mobile App Backend', value: 'mobile', description: 'Mobile API backend' },
-    { label: 'Other', value: 'other', description: 'Custom application' }
-  ];
-
-  answers.appType = await askChoice(
-    rl,
-    'Application type:',
-    typeOptions,
-    0
-  );
-
-  // Common Features based on app type
-  const commonFeatures = {
-    saas: ['dashboard', 'settings', 'notifications', 'billing', 'teams'],
-    marketplace: ['listings', 'search', 'messaging', 'reviews', 'payments'],
-    ecommerce: ['catalog', 'cart', 'checkout', 'orders', 'inventory'],
-    content: ['posts', 'comments', 'categories', 'search', 'rss'],
-    internal: ['dashboard', 'reports', 'users', 'permissions', 'audit'],
-    api: ['docs', 'keys', 'usage', 'webhooks', 'playground'],
-    mobile: ['push', 'sync', 'offline', 'auth', 'media'],
-    other: ['dashboard', 'settings', 'notifications']
-  };
-
-  const suggestedFeatures = commonFeatures[answers.appType] || commonFeatures.other;
-
-  // Feature Selection
-  const featureOptions = [
-    { label: 'User dashboard', value: 'dashboard' },
-    { label: 'Settings/preferences', value: 'settings' },
-    { label: 'Notifications', value: 'notifications' },
-    { label: 'Billing/subscriptions', value: 'billing' },
-    { label: 'Team/organization', value: 'teams' },
-    { label: 'Search', value: 'search' },
-    { label: 'File uploads', value: 'uploads' },
-    { label: 'Comments/feedback', value: 'comments' },
-    { label: 'Analytics', value: 'analytics' },
-    { label: 'API access', value: 'api' },
-    { label: 'Webhooks', value: 'webhooks' },
-    { label: 'Export/import', value: 'export' }
-  ];
-
-  answers.coreFeatures = await askMultiSelect(
-    rl,
-    'Core features:',
-    featureOptions,
-    suggestedFeatures.filter(f => featureOptions.some(o => o.value === f))
-  );
-
-  // MVP Scope
-  const mvpOptions = [
-    { label: 'Landing page only', value: 'landing', description: 'Validate idea' },
-    { label: 'Waitlist MVP', value: 'waitlist', description: 'Collect interest' },
-    { label: 'Single feature MVP', value: 'single', description: 'One core feature' },
-    { label: 'Full MVP', value: 'full', description: 'Multiple features' },
-    { label: 'Production ready', value: 'production', description: 'Launch ready' }
-  ];
-
-  answers.mvpScope = await askChoice(
-    rl,
-    'MVP scope:',
-    mvpOptions,
-    2
-  );
-
-  // Primary use case
-  answers.primaryUseCase = await askText(
-    rl,
-    'Describe the primary use case in one sentence',
-    ''
-  );
-
-  // Target users
-  const userOptions = [
-    { label: 'Consumers (B2C)', value: 'b2c' },
-    { label: 'Businesses (B2B)', value: 'b2b' },
-    { label: 'Developers', value: 'developers' },
-    { label: 'Enterprise', value: 'enterprise' },
-    { label: 'Internal team', value: 'internal' }
-  ];
-
-  answers.targetUsers = await askChoice(
-    rl,
-    'Primary target users:',
-    userOptions,
-    0
-  );
-
-  return answers;
-}
-
-module.exports = {
-  title,
-  description,
-  run
-};

package/generators/sections/frontend.js

@@ -1,118 +0,0 @@
-/**
- * Frontend Stack Section
- *
- * UI library, styling, state management, and component choices.
- *
- * @package bootspring
- * @module generators/sections/frontend
- */
-
-const title = 'Frontend Stack';
-const description = 'UI and styling choices';
-
-/**
- * Check if frontend section should be skipped
- */
-function shouldSkip(previousAnswers) {
-  // Skip for pure backend frameworks
-  const backendOnly = ['express', 'fastify', 'hono', 'koa'];
-  return backendOnly.includes(previousAnswers.framework);
-}
-
-/**
- * Run the frontend section
- */
-async function run(rl, previousAnswers, helpers) {
-  const { askChoice, askMultiSelect } = helpers;
-  const answers = {};
-
-  // UI Component Library
-  const uiOptions = [
-    { label: 'shadcn/ui', value: 'shadcn', description: 'Copy-paste components (Recommended)' },
-    { label: 'Radix UI', value: 'radix', description: 'Unstyled primitives' },
-    { label: 'Chakra UI', value: 'chakra', description: 'Accessible components' },
-    { label: 'Mantine', value: 'mantine', description: 'Full-featured React library' },
-    { label: 'Ant Design', value: 'antd', description: 'Enterprise UI library' },
-    { label: 'Custom', value: 'custom', description: 'Build your own' }
-  ];
-
-  answers.uiLibrary = await askChoice(
-    rl,
-    'UI Component Library:',
-    uiOptions,
-    0
-  );
-
-  // Styling
-  const stylingOptions = [
-    { label: 'Tailwind CSS', value: 'tailwind', description: 'Utility-first (Recommended)' },
-    { label: 'CSS Modules', value: 'cssmodules', description: 'Scoped CSS' },
-    { label: 'Styled Components', value: 'styled', description: 'CSS-in-JS' },
-    { label: 'Emotion', value: 'emotion', description: 'CSS-in-JS' },
-    { label: 'Sass/SCSS', value: 'sass', description: 'CSS preprocessor' },
-    { label: 'Plain CSS', value: 'css', description: 'Vanilla CSS' }
-  ];
-
-  answers.styling = await askChoice(
-    rl,
-    'Styling approach:',
-    stylingOptions,
-    0
-  );
-
-  // State Management (for non-Next.js frameworks or complex apps)
-  const stateOptions = [
-    { label: 'React Context', value: 'context', description: 'Built-in, simple apps' },
-    { label: 'Zustand', value: 'zustand', description: 'Lightweight and flexible' },
-    { label: 'Jotai', value: 'jotai', description: 'Atomic state' },
-    { label: 'Redux Toolkit', value: 'redux', description: 'Powerful, complex apps' },
-    { label: 'None / Server State', value: 'none', description: 'Use React Query / SWR only' }
-  ];
-
-  answers.stateManagement = await askChoice(
-    rl,
-    'State management:',
-    stateOptions,
-    0
-  );
-
-  // Data Fetching
-  const fetchingOptions = [
-    { label: 'TanStack Query', value: 'tanstack', description: 'Server state (Recommended)' },
-    { label: 'SWR', value: 'swr', description: 'Vercel data fetching' },
-    { label: 'Native fetch', value: 'native', description: 'Built-in fetch API' },
-    { label: 'Axios', value: 'axios', description: 'HTTP client' }
-  ];
-
-  answers.dataFetching = await askChoice(
-    rl,
-    'Data fetching:',
-    fetchingOptions,
-    0
-  );
-
-  // Additional features
-  const featureOptions = [
-    { label: 'Dark mode', value: 'darkMode' },
-    { label: 'Animations (Framer Motion)', value: 'animations' },
-    { label: 'Internationalization (i18n)', value: 'i18n' },
-    { label: 'Form handling (React Hook Form)', value: 'forms' },
-    { label: 'Icon library (Lucide)', value: 'icons' }
-  ];
-
-  answers.frontendFeatures = await askMultiSelect(
-    rl,
-    'Additional frontend features:',
-    featureOptions,
-    ['darkMode', 'forms', 'icons']
-  );
-
-  return answers;
-}
-
-module.exports = {
-  title,
-  description,
-  shouldSkip,
-  run
-};