bootspring_seed
Manage seed configuration and project scaffolding. Setup input folders, run questionnaire, ingest files, generate documents, and scaffold projects.
Overview#
The bootspring_seed tool is your project bootstrapping companion. It helps you set up input folders for existing files, ingest and analyze those files, generate documentation, and scaffold new project structures based on presets or custom configurations.
Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
action | string | Yes | Action to perform |
preset | string | No | Preset for init or scaffold |
format | string | No | Export format: json or yaml |
dryRun | boolean | No | Show scaffold plan without creating files |
Actions#
| Action | Description |
|---|---|
setup | Create input folder structure |
init | Run questionnaire (CLI only) |
generate | Ingest files and generate documents |
scaffold | Create project structure |
status | Show current configuration |
export | Export configuration as JSON/YAML |
Init Presets#
| Preset | Description |
|---|---|
minimal | Basic project setup |
standard | Standard configuration (default) |
full | All options enabled |
startup | Startup-focused setup |
api | API-first configuration |
Scaffold Presets#
| Preset | Description |
|---|---|
nextjs | Next.js with App Router |
react | React SPA |
node | Node.js backend |
fullstack | Full-stack application |
Usage Examples#
Setup Input Folders#
Use the bootspring_seed tool with:
- action: "setup"
Response:
## Seed Setup Complete
Created 15 folders/files.
**Folder Structure:**.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 ├── generated/ # Bootspring output ├── context/ # AI context index └── logs/ # Action history
**Next Steps:**
1. Drop your files in `.bootspring/inputs/` subfolders
2. Run `bootspring_seed` with action: "generate" to process them
Generate Documents#
Use the bootspring_seed tool with:
- action: "generate"
Response:
1## Files Ingested
2
3| Category | Files Found |
4|----------|-------------|
5| MVP Code | 45 |
6| Business Docs | 3 |
7| PRD Docs | 2 |
8| Design Files | 12 |
9| API Specs | 1 |
10| Data Files | 5 |
11| **Total** | **68** |
12
13## Documents Generated
14
15Generated 4 documents in `.bootspring/generated/`
16
17**MVP Patterns Detected:**
18React, Tailwind, Supabase, Clerk
19
20**Next Steps:**
211. Review generated documents in `.bootspring/generated/`
222. Run `bootspring_seed` with action: "scaffold" to create project structureScaffold with Preset#
Use the bootspring_seed tool with:
- action: "scaffold"
- preset: "nextjs"
Response:
1## Scaffold Complete
2
3Created 45 files and 12 directories.
4
5**Configuration:**
6- Framework: nextjs
7- Language: typescript
8
9**Next Steps:**
101. Run `npm install` to install dependencies
112. Copy `.env.example` to `.env.local`
123. Run `npm run dev` to start developmentScaffold Dry Run#
Use the bootspring_seed tool with:
- action: "scaffold"
- preset: "fullstack"
- dryRun: true
Response:
1## Scaffold Plan (Dry Run)
2
3**Configuration:**
4- Framework: nextjs
5- Language: typescript
6- UI: shadcn
7
8**Directories:** 18
9**Files:** 52
10
11**Sample directories:**
12- src/app
13- src/components
14- src/lib
15- src/hooks
16- src/types
17- prisma
18- public
19...
20
21**Sample files:**
22- src/app/layout.tsx
23- src/app/page.tsx
24- src/lib/utils.ts
25- prisma/schema.prisma
26...Check Status#
Use the bootspring_seed tool with:
- action: "status"
Response:
1## Seed Status
2
3| Item | Status |
4|------|--------|
5| SEED.md | exists |
6| bootspring.config.js | exists |
7| .bootspring/inputs/ | exists |
8
9**Configuration:**
10- Project: my-saas-app
11- Framework: nextjs
12- Language: typescript
13- Database: postgresql
14
15**Available Presets:** nextjs, react, node, fullstack
16
17**Commands:**
18- `bootspring_seed` action: "setup" - Create input folders
19- `bootspring_seed` action: "generate" - Process input files
20- `bootspring_seed` action: "scaffold" preset: "nextjs" - Generate projectExport Configuration#
Use the bootspring_seed tool with:
- action: "export"
- format: "yaml"
Response:
1## Seed Configuration (YAML)
2
3```yaml
4project:
5 name: my-saas-app
6 description: A SaaS application
7stack:
8 framework: nextjs
9 language: typescript
10 database: postgresql
11frontend:
12 uiLibrary: shadcn
13 styling: tailwind
## SEED.md Format
The SEED.md file contains your project configuration:
```markdown
# Project Seed Configuration
## Project Info
```yaml
project:
name: my-app
description: My application description
Tech Stack#
stack:
framework: nextjs
language: typescript
database: postgresql
hosting: vercelFrontend#
frontend:
uiLibrary: shadcn
styling: tailwind
stateManagement: zustandFeatures#
features:
auth: clerk
payments: stripe
email: resend
## Input Folder Structure
After running `setup`, drop files in these locations:
| Folder | What to Put Here |
|--------|------------------|
| `mvp/source/` | AI-generated MVP code (Lovable, Bolt, V0, etc.) |
| `business/` | Business plans, pitch decks, market research |
| `prd/` | Product requirements documents |
| `designs/` | Figma exports, wireframes, mockups |
| `legal/` | Existing terms, privacy policies |
| `api/` | OpenAPI specs, API documentation |
| `data/` | Sample data, database schemas |
## Error Handling
### No SEED.md Found
```json
{
"warning": "No SEED.md found",
"hints": [
"Use preset parameter: nextjs, react, node, fullstack",
"Or run \"bootspring seed init\" first"
]
}
Invalid Preset#
{
"error": "Invalid preset: invalid",
"hints": ["Valid presets: nextjs, react, node, fullstack"]
}No Inputs Folder#
{
"warning": "No .bootspring/inputs folder found",
"hints": ["Run bootspring_seed with action: \"setup\" first"]
}CLI Integration#
The seed tool has full CLI support:
1# Setup input folders
2bootspring seed setup
3
4# Run interactive questionnaire
5bootspring seed init
6
7# Run with preset
8bootspring seed init --preset startup
9
10# Generate from inputs
11bootspring seed generate
12
13# Scaffold project
14bootspring seed scaffold --preset nextjs
15
16# Dry run scaffold
17bootspring seed scaffold --preset fullstack --dry-run
18
19# Export config
20bootspring seed export --format yamlBest Practices#
Start with Setup#
Always run setup first to create the proper folder structure.
Organize Your Inputs#
Place files in the correct input folders for better analysis.
Use Presets#
Start with a preset that matches your project type, then customize.
Review Generated Docs#
Check .bootspring/generated/ before scaffolding to ensure accuracy.
Dry Run First#
Use dryRun: true to preview what will be created before scaffolding.
Related Tools#
- bootspring_prd - Manage PRDs from inputs
- bootspring_generate - Generate CLAUDE.md
- bootspring_context - Project context management