mvp | Bootspring Docs

Generate and manage your Minimum Viable Product code.

Synopsis#

bootspring mvp <command> [options]

Description#

The mvp command generates production-ready code from your PRD and seed structure. It creates complete features, API endpoints, database operations, and UI components following best practices.

Commands#

generate#

Generate MVP code from PRD user stories.

bootspring mvp generate [options]

Options:

Option	Description
`--story=<id>`	Generate code for specific story
`--feature=<name>`	Generate a specific feature
`--all`	Generate all MVP features
`--dry-run`	Preview without writing files
`--agent=<name>`	Use specific agent for generation

Examples:

# Generate all MVP code
bootspring mvp generate --all

# Generate specific user story
bootspring mvp generate --story=US-001

# Generate a feature
bootspring mvp generate --feature=user-authentication

# Preview changes
bootspring mvp generate --all --dry-run

status#

Check MVP generation progress.

bootspring mvp status

Output:

⚡ Bootspring MVP Status

PRD: TaskFlow MVP
Stories: 12 total

Progress:
  ✓ US-001: User can sign up (completed)
  ✓ US-002: User can sign in (completed)
  ✓ US-003: User can create task (completed)
  ◐ US-004: AI prioritizes tasks (in progress)
  ○ US-005: User can link PR (pending)
  ○ US-006: User can enable focus mode (pending)
  ...

Completion: 25% (3/12 stories)

Next: bootspring mvp generate --story=US-004

validate#

Validate MVP against PRD requirements.

bootspring mvp validate [options]

Options:

Option	Description
`--story=<id>`	Validate specific story
`--coverage`	Show test coverage
`--acceptance`	Check acceptance criteria

Examples:

# Validate all stories
bootspring mvp validate

# Validate specific story
bootspring mvp validate --story=US-001

# Check with coverage
bootspring mvp validate --coverage

Output:

⚡ MVP Validation

US-001: User can sign up
  ✓ Email/password form exists
  ✓ Validation implemented
  ✓ Success redirect works
  ✓ Error handling present
  ○ E2E test coverage (0%)
  Status: PARTIAL (4/5 criteria)

US-002: User can sign in
  ✓ All acceptance criteria met
  ✓ Test coverage: 85%
  Status: COMPLETE

test#

Run MVP-specific tests.

bootspring mvp test [options]

Options:

Option	Description
`--story=<id>`	Test specific story
`--e2e`	Run end-to-end tests
`--unit`	Run unit tests only
`--watch`	Watch mode

Examples:

# Run all MVP tests
bootspring mvp test

# Test specific story
bootspring mvp test --story=US-003

# E2E tests only
bootspring mvp test --e2e

deploy#

Deploy MVP to staging or production.

bootspring mvp deploy [environment] [options]

Environments:

Environment	Description
`staging`	Deploy to staging (default)
`production`	Deploy to production
`preview`	Create preview deployment

Options:

Option	Description
`--skip-tests`	Skip test run before deploy
`--skip-checks`	Skip quality checks

Examples:

# Deploy to staging
bootspring mvp deploy staging

# Deploy to production
bootspring mvp deploy production

# Create preview
bootspring mvp deploy preview

analytics#

Set up MVP analytics and tracking.

bootspring mvp analytics [options]

Options:

Option	Description
`--provider=<name>`	Analytics provider
`--events`	Generate event tracking

Providers:

posthog (default)
mixpanel
amplitude
plausible

Examples:

# Set up PostHog
bootspring mvp analytics --provider=posthog

# Generate event tracking
bootspring mvp analytics --events

Generation Details#

What Gets Generated#

For each user story, MVP generates:

Component	Description
API routes	REST endpoints with validation
Database	Prisma operations
Services	Business logic layer
Components	React UI components
Forms	Form handling with validation
Tests	Unit and integration tests

Example Generation#

bootspring mvp generate --story=US-003

For story "User can create task", generates:

app/
├── api/tasks/
│   ├── route.ts           # POST /api/tasks
│   └── [id]/route.ts      # GET/PATCH/DELETE
├── (dashboard)/
│   └── tasks/
│       ├── page.tsx       # Task list page
│       └── new/page.tsx   # Create task page
components/
├── tasks/
│   ├── TaskForm.tsx       # Create/edit form
│   ├── TaskCard.tsx       # Task display
│   └── TaskList.tsx       # List component
lib/
└── services/
    └── tasks.ts           # Task service
tests/
├── api/tasks.test.ts      # API tests
└── components/TaskForm.test.tsx

Code Quality#

Generated code follows best practices:

TypeScript#

// Fully typed interfaces
interface Task {
  id: string;
  title: string;
  description?: string;
  priority: Priority;
  status: TaskStatus;
  createdAt: Date;
  updatedAt: Date;
}

// Type-safe API routes
export async function POST(request: NextRequest) {
  const body = await request.json();
  const validated = taskSchema.parse(body);
  // ...
}

Validation#

// Zod schemas for validation
const taskSchema = z.object({
  title: z.string().min(1).max(200),
  description: z.string().optional(),
  priority: z.enum(['low', 'medium', 'high', 'urgent']),
});

Error Handling#

// Consistent error responses
try {
  const task = await createTask(data);
  return NextResponse.json({ data: task }, { status: 201 });
} catch (error) {
  if (error instanceof ValidationError) {
    return NextResponse.json(
      { error: { code: 'validation_error', details: error.errors } },
      { status: 400 }
    );
  }
  throw error;
}

Configuration#

MVP settings in bootspring.config.js:

module.exports = {
  mvp: {
    // Code generation
    generation: {
      typescript: true,
      strictMode: true,
      comments: true,
    },

    // Testing
    testing: {
      framework: 'vitest',
      coverage: 80,
      e2e: 'playwright',
    },

    // Deployment
    deployment: {
      staging: {
        provider: 'vercel',
        branch: 'develop',
      },
      production: {
        provider: 'vercel',
        branch: 'main',
        requireApproval: true,
      },
    },

    // Analytics
    analytics: {
      provider: 'posthog',
      trackEvents: true,
    },
  },
};

Examples#

Full MVP Generation#

# 1. Check PRD status
bootspring prd status

# 2. Generate all MVP code
bootspring mvp generate --all

# 3. Check progress
bootspring mvp status

# 4. Validate against PRD
bootspring mvp validate

# 5. Run tests
bootspring mvp test

# 6. Deploy to staging
bootspring mvp deploy staging

# 7. Set up analytics
bootspring mvp analytics --provider=posthog

Story-by-Story Development#

# Get next story
bootspring loop next

# Generate code for story
bootspring mvp generate --story=US-004

# Run story tests
bootspring mvp test --story=US-004

# Validate story
bootspring mvp validate --story=US-004

# Mark complete
bootspring loop complete US-004

Custom Agent Generation#

# Use specific agent
bootspring mvp generate --feature=ai-prioritization --agent=ai-ml-expert

# Generate with frontend expert
bootspring mvp generate --story=US-007 --agent=frontend-expert

bootspring seed - Scaffold before MVP
bootspring prd - Manage requirements
bootspring loop - Development loop
bootspring quality - Quality gates

MVP Build - Complete MVP guide
Seed Workflow - Previous phase
Launch Workflow - After MVP