feat: Bolt.new integration - import StackBlitz projects

[rubenmarcus]

Summary

Integrate with Bolt.new to import AI-generated full-stack applications and continue development with ralph-starter loops.

Why This Integration Matters

Bolt.new is powerful for quick full-stack prototypes using WebContainers. Ralph-starter can:

• Take Bolt prototypes to production
• Add features beyond Bolt's context limits
• Implement proper testing
• Handle complex integrations

Bolt.new Export Options

1. ZIP Download

• Log in → Click project title → Export → Download
• Downloads complete project as .zip

2. Open in StackBlitz

• Continue editing in StackBlitz IDE
• Accounts are automatically linked

3. GitHub Integration

• Open any GitHub repo in Bolt: bolt.new/~/github.com/user/repo
• Export back to GitHub

Integration Approach

Option 1: Import from Bolt URL

ralph-starter source bolt --url https://bolt.new/project-id

Option 2: Import from ZIP

ralph-starter import bolt ./bolt-export.zip

Option 3: GitHub Round-trip

# Bolt project → GitHub → ralph
ralph-starter source github --repo user/bolt-project

Option 4: StackBlitz API Integration

Use WebContainer API for deeper integration:

ralph-starter source stackblitz --project <project-id>

Use Cases

1. Bolt Prototype → Production

# 1. Build quick prototype in Bolt
# 2. Export to GitHub
# 3. Ralph makes it production-ready
ralph-starter run --spec "Add authentication, database migrations, CI/CD, and tests"

2. Continue Beyond Context Limits

# When Bolt hits context limits
ralph-starter run --spec "Continue implementing the remaining features from prd.md"

3. Bolt for Frontend, Ralph for Backend

# Bolt generates React frontend
# Ralph builds robust backend
ralph-starter run --spec "Create production Node.js backend for this frontend"

Config

// ralph.config.ts
export default {
  sources: {
    bolt: {
      stackblitzAccount: 'user',
      autoImport: true
    }
  }
}

Workflow

Bolt.new (rapid prototype) → ZIP/GitHub → ralph-starter (production features)

Technical Notes

• Bolt uses WebContainers (browser-based Node.js)
• Projects are Vite-based
• Support for React, Vue, Svelte out of the box
• Backend support for Python/Go coming in 2026