Xcode Setup Guide

Using Bootspring with Apple's Xcode IDE for iOS, macOS, and watchOS development.

Overview#

While Bootspring is optimized for web/Node.js development, it can enhance Xcode workflows through:

• Terminal Integration - CLI commands in Xcode's terminal
• Context Generation - CLAUDE.md for AI assistants
• Build Scripts - Integrate with Xcode build phases
• Documentation - Generate and manage project docs

Prerequisites#

• Xcode 14+ installed
• Node.js 18+ installed (via Homebrew)
• Bootspring CLI installed
• macOS 12+ (Monterey or later)

Installing Node.js for Xcode#

Xcode doesn't include Node.js, so install it separately:

Installing Bootspring#

Integration Methods#

Method 1: Terminal Tab#

Use Xcode's built-in terminal:

1. Window → Organize Terminal
2. Open a new terminal tab
3. Navigate to your project directory
4. Run Bootspring commands

Method 2: Build Phase Scripts#

Add Bootspring commands to build phases:

1. Select your target in Xcode
2. Go to Build Phases
3. Click + → New Run Script Phase
4. Add Bootspring commands

Generate context on build:

Quality check before archive:

Method 3: External Build Tools#

Use Xcode's External Build System for Bootspring workflows:

1. File → New → Project
2. Choose External Build System
3. Set build tool to Bootspring

Context Generation#

Initialize Project#

Swift/iOS Context#

Configure for Swift development:

Generate CLAUDE.md#

Example output for iOS:

Using with AI Assistants#

Copy Context#

Then paste into Claude, ChatGPT, or other AI assistants for iOS development help.

Agent Consultations#

Common Workflows#

New Feature Development#

Code Review#

Documentation#

Automator Integration#

Create Automator workflows for quick access:

Quick Generate#

1. Open Automator
2. Create new Quick Action
3. Add Run Shell Script:

1. Save as "Bootspring Generate"
2. Access via Services menu or keyboard shortcut

Quick Health Check#

Git Integration#

Pre-Commit Hook#

Post-Commit Context Update#

Xcode + SwiftUI Workflow#

For SwiftUI projects:

SPM Integration#

For Swift Package Manager projects:

CocoaPods Integration#

For CocoaPods projects:

Troubleshooting#

Command Not Found#

Build Phase PATH Issues#

Add PATH export at the start of build scripts:

Node.js Not Found in Xcode#

Ensure Homebrew's Node is accessible:

Permission Issues#

Limitations#

Bootspring is primarily designed for web development. Some limitations with Xcode/iOS:

For Full iOS Tooling#

Consider combining Bootspring with:

• SwiftLint - Swift code quality
• SwiftFormat - Code formatting
• Periphery - Dead code detection
• xcbeautify - Build log formatting

Best Practices#

Keep Context Updated#

Use for Documentation#

Leverage AI Assistants#

Use CLAUDE.md context with Claude, ChatGPT for:

• Code review assistance
• Architecture decisions
• Documentation writing
• Bug investigation

Next Steps#

• Terminal Usage - CLI workflows
• Claude Desktop - MCP integration
• Understanding Context
• Using Agents