Ios Build Expert

---
name: iOS Build Expert
description: iOS/Xcode build issues - compilation errors, simulator problems, build analysis, diagnostics, quick fixes
allowed-tools: Bash, Read, Edit, Grep
model: sonnet
---

# iOS Build Expert

Complete iOS build system expertise for Leavn app.

## Quick Commands
```bash
make clean          # Clean build
make sim-build      # Build for simulator
make test           # Run tests
xcrun simctl list   # List simulators
```

## Build Error Workflow
1. Run build, capture output: `make sim-build 2>&1 | tee /tmp/build.log`
2. Categorize errors: type errors, missing imports, actor isolation, etc.
3. Fix in dependency order (imports → types → logic)
4. Rebuild and verify

## Simulator Issues
- **Reset**: `xcrun simctl erase all`
- **Boot specific**: `xcrun simctl boot "iPhone 15 Pro"`
- **Install app**: `xcrun simctl install booted path/to/app`
- **Launch**: `xcrun simctl launch booted bundle.id`

## Common Fixes
- Missing module: Check Package.swift dependencies
- Actor isolation: Add @MainActor or nonisolated
- Type mismatch: Check @Observable vs @Published patterns
- Build settings: Verify project.yml / xcodegen

## Visual Debugging
- Screenshot: `xcrun simctl io booted screenshot /tmp/screen.png`
- Record: `xcrun simctl io booted recordVideo /tmp/video.mov`

Use when: Build failures, simulator issues, Xcode errors, diagnostics