Bootspring
HomeGet Started

seed

Scaffold and generate project structure from your preseed foundation.

Synopsis#

bootspring seed <command> [options]

Description#

The seed command transforms your preseed documentation into a working project structure. It generates code scaffolding, database schemas, API routes, and UI components based on your PRD and technical specifications.

Tier Information#

Some seed commands require a Pro subscription:

CommandTierDescription
setup, init, update, status, exportFreeCore seed functionality
synthesizeProConvert preseed documents into SEED.md
scaffoldProGenerate project structure
generateProGenerate components and modules

Commands#

synthesize [PRO]#

Convert preseed documents into a unified SEED.md specification.

bootspring seed synthesize [options]

This is the recommended way to move from preseed to seed phase. It reads your preseed documents and creates a unified SEED.md file.

Options:

OptionDescription
--forceOverwrite existing SEED.md
--prompt-onlyGenerate AI prompt instead (free tier)

What it reads:

  • VISION.md - Project name, problem, solution
  • AUDIENCE.md - Target users
  • BUSINESS_MODEL.md - Pricing, revenue
  • PRD.md - Features, user stories
  • TECHNICAL_SPEC.md - Tech stack
  • ROADMAP.md - Phases, priorities

Example:

1# After completing preseed workflow 2bootspring seed synthesize 3 4# Output: 5# Reading preseed documents... 6# ✓ VISION.md 7# ✓ AUDIENCE.md 8# ✓ BUSINESS_MODEL.md 9# ✓ PRD.md 10# ✓ TECHNICAL_SPEC.md 11# ✓ ROADMAP.md 12# 13# Generated SEED.md successfully! 14# 15# Next steps: 16# 1. Review: cat SEED.md 17# 2. Scaffold: bootspring seed scaffold --preset=nextjs 18 19# Free tier - generate prompt to use with external AI 20bootspring seed synthesize --prompt-only

See Synthesize from Preseed for full documentation.

setup#

Create the seed input folder structure.

bootspring seed setup

Creates:

.bootspring/inputs/ ├── mvp/source/ # AI-generated MVP code ├── business/ # Business plans, pitch decks ├── prd/ # Product requirements ├── designs/ # Figma exports, wireframes ├── legal/ # Terms, privacy policies ├── api/ # OpenAPI specs └── data/ # Sample data, schemas

init#

Initialize the seed workflow from preseed data.

bootspring seed init [options]

Options:

OptionDescription
--from=<path>Path to preseed config (default: .bootspring/preseed/)
--template=<name>Project template to use
--skip-preseedSkip preseed import, start fresh

Templates:

TemplateDescription
nextjs-saasNext.js 14 SaaS starter (default)
nextjs-appNext.js app without SaaS features
api-onlyAPI-only backend
landingLanding page with waitlist
dashboardAdmin dashboard template

Examples:

1# Initialize from preseed (recommended) 2bootspring seed init 3 4# Use specific template 5bootspring seed init --template=nextjs-saas 6 7# Start fresh without preseed 8bootspring seed init --skip-preseed

scaffold [PRO]#

Generate project structure and boilerplate.

bootspring seed scaffold [options]

Options:

OptionDescription
--preset=<name>Framework preset (nextjs, react, node, fullstack)
--features=<list>Comma-separated features to scaffold
--from-configUse bootspring.config.js instead of SEED.md
--dry-runPreview changes without writing
--forceOverwrite existing files

Framework Presets:

PresetDescription
nextjsNext.js 15 + App Router + TypeScript + Tailwind + shadcn/ui
reactReact 19 + Vite + TypeScript + Tailwind
nodeExpress/Fastify + TypeScript + Zod
fullstackNext.js + Prisma + NextAuth + full-stack setup

Feature Flags:

FeatureWhat's Generated
authAuthentication with Clerk
databasePrisma schema and migrations
apiAPI routes structure
uiUI components library
paymentsStripe integration
emailEmail templates with Resend
dashboardUser dashboard pages
landingMarketing landing page
adminAdmin panel

Examples:

1# Scaffold with preset (recommended) 2bootspring seed scaffold --preset=nextjs 3 4# Preview what will be created 5bootspring seed scaffold --preset=nextjs --dry-run 6 7# Scaffold specific features 8bootspring seed scaffold --features=auth,database,api 9 10# Use config file instead of SEED.md 11bootspring seed scaffold --from-config 12 13# Overwrite existing files 14bootspring seed scaffold --preset=nextjs --force

See Scaffold Presets for detailed preset documentation.

generate [PRO]#

Generate specific components or modules.

bootspring seed generate <type> <name> [options]

Types:

TypeDescription
componentReact component
pageNext.js page
apiAPI route
modelPrisma model
hookReact hook
serviceService layer
testTest file

Examples:

1# Generate a component 2bootspring seed generate component UserProfile 3 4# Generate an API route 5bootspring seed generate api users/[id] 6 7# Generate a Prisma model 8bootspring seed generate model Subscription 9 10# Generate with tests 11bootspring seed generate component DataTable --with-tests

status#

Check seed workflow status.

bootspring seed status

Output:

⚡ Bootspring Seed Status Project: TaskFlow Template: nextjs-saas Initialized: 2026-02-20T10:30:00Z Preseed Import: ✓ PRD imported (12 user stories) ✓ Technical spec imported ✓ Business model imported Scaffolding Progress: ✓ Authentication (Clerk) ✓ Database (Prisma + PostgreSQL) ◐ API routes (8/12 endpoints) ○ UI components (0/15) ○ Dashboard pages (0/5) Next: bootspring seed scaffold --features=ui

sync#

Sync generated code with preseed changes.

bootspring seed sync [options]

Options:

OptionDescription
--checkCheck for drift without syncing
--forceForce regeneration

Examples:

# Check for drift bootspring seed sync --check # Sync changes bootspring seed sync

validate#

Validate seed configuration and generated code.

bootspring seed validate [options]

Options:

OptionDescription
--fixAuto-fix issues where possible

Checks:

  • PRD completeness
  • Schema validity
  • API route coverage
  • Component existence
  • Test coverage

Workflow Integration#

From Preseed#

Seed automatically imports from preseed:

1# Complete preseed first 2bootspring preseed init 3 4# Seed imports preseed data 5bootspring seed init 6# Imports: PRD, technical spec, business model

To MVP#

Seed feeds into MVP generation:

# Scaffold structure bootspring seed scaffold # Generate MVP code bootspring mvp generate

Generated Structure#

After seed scaffold:

your-project/ ├── app/ │ ├── (auth)/ │ │ ├── sign-in/ │ │ └── sign-up/ │ ├── (dashboard)/ │ │ ├── dashboard/ │ │ ├── settings/ │ │ └── billing/ │ ├── (marketing)/ │ │ ├── page.tsx │ │ ├── pricing/ │ │ └── features/ │ ├── api/ │ │ ├── webhooks/ │ │ └── v1/ │ └── layout.tsx ├── components/ │ ├── ui/ │ ├── forms/ │ └── layout/ ├── lib/ │ ├── db.ts │ ├── auth.ts │ └── stripe.ts ├── prisma/ │ └── schema.prisma ├── .bootspring/ │ ├── preseed/ │ └── seed/ └── bootspring.config.js

Configuration#

Seed uses bootspring.config.js:

1module.exports = { 2 seed: { 3 // Template selection 4 template: 'nextjs-saas', 5 6 // Feature flags 7 features: { 8 auth: true, 9 payments: true, 10 email: true, 11 analytics: true, 12 }, 13 14 // Tech stack 15 stack: { 16 framework: 'nextjs', 17 database: 'postgresql', 18 orm: 'prisma', 19 auth: 'clerk', 20 payments: 'stripe', 21 email: 'resend', 22 hosting: 'vercel', 23 }, 24 25 // Generation options 26 generation: { 27 typescript: true, 28 testing: 'vitest', 29 styling: 'tailwind', 30 components: 'shadcn', 31 }, 32 }, 33};

Examples#

Complete Seed Workflow#

1# 1. Start from preseed 2bootspring preseed init 3 4# 2. Initialize seed 5bootspring seed init 6 7# 3. Check status 8bootspring seed status 9 10# 4. Scaffold all features 11bootspring seed scaffold 12 13# 5. Generate specific components 14bootspring seed generate component PricingTable 15bootspring seed generate api subscriptions 16 17# 6. Validate 18bootspring seed validate 19 20# 7. Move to MVP 21bootspring mvp generate

Quick Start (Skip Preseed)#

1# Initialize without preseed 2bootspring seed init --skip-preseed --template=nextjs-saas 3 4# Scaffold with selected features 5bootspring seed scaffold --features=auth,database,api 6 7# Generate components as needed 8bootspring seed generate component Dashboard

Landing Page Only#

1# Use landing template 2bootspring seed init --template=landing 3 4# Scaffold landing features 5bootspring seed scaffold --features=landing,email 6 7# Generate waitlist 8bootspring seed generate component Waitlist

Related Commands#

Related Workflows#