ios-build-fixlisted
Install: claude install-skill jordanframptondev/counterspell
When the iOS build fails, follow this diagnostic process:
1. **Read the build output** — identify the specific error message and file/line
2. **Common issues and fixes:**
- **Pod not found / module not found:** Run `cd ios && pod deintegrate && pod install --repo-update`
- **Deployment target mismatch:** Check `ios/Podfile` min_ios_version_supported and project settings
- **Duplicate symbols:** Check for conflicting pod versions in Podfile.lock
- **Code signing:** Check Xcode project signing settings — for dev, use automatic signing
- **Metro bundler errors:** Clear cache with `npx react-native start --reset-cache`
- **Stale build caches:** `cd ios && xcodebuild clean` then rebuild
- **node_modules native code issues:** `rm -rf node_modules && npm install && cd ios && pod install`
3. **If the error is unfamiliar**, search the codebase for related configuration and check the React Native upgrade helper for version-specific breaking changes
4. **After fixing**, verify with `npx react-native run-ios` or `cd ios && xcodebuild -scheme Upkeep -sdk iphonesimulator build`