Platform Setup Guides | Bootspring Docs

Complete installation and configuration guides for every platform and environment.

Quick Start#

Choose your platform to get started:

Platform	Time	Difficulty
macOS	5 min	Easy
Windows	5 min	Easy
Linux	5 min	Easy

IDE Integrations#

Connect Bootspring to your development environment:

Integration	Description
VS Code	Extension and terminal integration
Cursor	AI editor with Bootspring context
JetBrains	IntelliJ, WebStorm, PyCharm
Xcode	iOS, macOS, Swift development
Neovim	Terminal-based setup

AI Assistant Setup#

Connect Bootspring to AI assistants:

Assistant	Description
Claude Desktop	MCP server integration
Claude Code	CLI AI coding assistant
Claude Web	Using context with claude.ai
ChatGPT	Using context with ChatGPT
Codex Desktop	OpenAI's desktop assistant

Terminal & CLI#

Use Bootspring directly from the command line:

Platform	Description
Terminal	Standalone CLI usage without IDE

System Requirements#

Minimum Requirements#

Requirement	Specification
Node.js	v18.0.0 or higher
npm	v8.0.0 or higher
Memory	512 MB RAM
Disk	100 MB free space
Network	Internet connection

Recommended#

Requirement	Specification
Node.js	v20.x LTS
npm	v10.x
Memory	2 GB RAM
Disk	500 MB free space

Pre-Installation Checklist#

Before installing Bootspring, ensure you have:

Node.js 18+ installed
npm or yarn package manager
Terminal/command line access
Bootspring account (optional for Pro features)

Check Node.js Version#

node --version
# Should output v18.0.0 or higher

npm --version
# Should output 8.0.0 or higher

Install Node.js#

If you don't have Node.js:

macOS (Homebrew):

brew install node

Windows (Chocolatey):

choco install nodejs

Linux (apt):

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

All Platforms (nvm - recommended):

# Install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Install Node.js
nvm install 20
nvm use 20

Universal Installation#

Once Node.js is installed, Bootspring installation is the same on all platforms:

# Install globally
npm install -g bootspring

# Verify installation
bootspring --version

Authentication#

Create Account#

Visit bootspring.dev/signup
Create your account
Verify your email

Authenticate CLI#

# Login via browser
bootspring login

# Or use device code
bootspring login --device

Project Setup#

Initialize New Project#

cd your-project
bootspring init

This creates:

bootspring.config.js - Configuration
CLAUDE.md - AI context file
.bootspring/ - Local data directory

Connect Existing Project#

cd existing-project
bootspring init --existing

Verify Installation#

Run the health check:

bootspring doctor

Expected output:

✓ Node.js version: v20.10.0
✓ npm version: 10.2.3
✓ Bootspring version: 1.2.0
✓ Configuration: Valid
✓ Authentication: Logged in
✓ Network: Connected
✓ MCP: Available

All checks passed!

Next Steps#

After installation:

Generate Context - Create your CLAUDE.md
Use Agents - Invoke expert agents
Apply Skills - Use skill patterns
Set Up IDE - Configure your editor

Troubleshooting#

Common Issues#

Issue	Solution
`command not found`	Check PATH, reinstall with `-g` flag
Permission denied	Use `sudo` or fix npm permissions
Network errors	Check firewall, proxy settings
Auth failures	Run `bootspring logout` then `bootspring login`

See Troubleshooting Guide for more help.