bootspring init | Bootspring Docs

Initialize Bootspring in your project.

Synopsis#

bootspring init [options]

Description#

The init command sets up Bootspring in your project by:

Creating bootspring.config.js with detected settings
Generating CLAUDE.md context file
Creating .mcp.json for MCP server configuration
Setting up recommended defaults

Options#

Option	Description
`--force`, `-f`	Overwrite existing configuration
`--stack <items>`	Specify tech stack (comma-separated)
`--skip-generate`	Skip CLAUDE.md generation
`--minimal`	Create minimal configuration
`--yes`, `-y`	Accept all defaults

Usage Examples#

Basic Initialization#

bootspring init

Interactive prompts guide you through setup:

? Project name: my-awesome-app
? Project type: SaaS Application
? Detected stack: Next.js, TypeScript, Prisma, Tailwind
? Is this correct? Yes

✓ Created bootspring.config.js
✓ Created .mcp.json
✓ Generated CLAUDE.md
✓ Bootspring initialized successfully!

Non-Interactive#

bootspring init --yes

Uses detected defaults without prompts.

Specify Stack#

bootspring init --stack nextjs,prisma,clerk,stripe

Explicitly set technologies instead of auto-detection.

Force Overwrite#

bootspring init --force

Overwrites existing configuration files.

Minimal Setup#

bootspring init --minimal

Creates only essential files without extras.

Generated Files#

bootspring.config.js#

module.exports = {
  project: {
    name: 'my-awesome-app',
    type: 'saas',
    description: 'Auto-detected from package.json',
  },

  stack: {
    frontend: ['react', 'nextjs', 'tailwindcss'],
    backend: ['nodejs'],
    database: ['postgresql', 'prisma'],
    auth: ['clerk'],
    payments: ['stripe'],
    testing: ['vitest', 'playwright'],
  },

  agents: {
    enabled: 'all',  // or array of specific agents
  },

  quality: {
    preCommit: {
      lint: true,
      format: true,
      types: true,
    },
    prePush: {
      tests: true,
      coverage: 80,
    },
  },

  paths: {
    context: 'CLAUDE.md',
    todo: 'todo.md',
    prd: 'tasks/prd.json',
  },
};

.mcp.json#

{
  "mcpServers": {
    "bootspring": {
      "command": "npx",
      "args": ["bootspring", "mcp"],
      "env": {
        "BOOTSPRING_API_KEY": "${BOOTSPRING_API_KEY}"
      }
    }
  }
}

CLAUDE.md#

Auto-generated project context file. See Context Generation.

Stack Detection#

Bootspring automatically detects your tech stack by scanning:

File	Detection
`next.config.*`	Next.js
`vite.config.*`	Vite
`prisma/schema.prisma`	Prisma
`drizzle.config.*`	Drizzle
`package.json` (deps)	Various packages
`tsconfig.json`	TypeScript
`tailwind.config.*`	Tailwind CSS
`vitest.config.*`	Vitest
`playwright.config.*`	Playwright

Post-Initialization#

After initialization:

Add API Key (if using Pro features):

export BOOTSPRING_API_KEY=bsk_your_key
Start Development:

bootspring status # Check everything is set up bootspring agent list # See available agents
Customize Config: Edit bootspring.config.js to customize behavior.

Common Issues#

Existing Config#

Error: bootspring.config.js already exists
Use --force to overwrite

Solution: Use --force to overwrite or delete the existing file.

Not a Project Root#

Warning: No package.json found

Solution: Run from your project root directory.

Detection Incorrect#

If stack detection is wrong, use --stack to specify:

bootspring init --stack nextjs,prisma,clerk

bootspring generate - Regenerate context
bootspring config - Manage configuration
bootspring status - Check project status