Paperline Doctor Issues
Xcode Not Detected
Xcode shows as not installed or wrong version
Xcode shows as not installed or wrong version
Problem: Paperline Doctor reports Xcode is not installed or shows an older version.Solutions:
- Download Xcode 16+ from the Mac App Store
- Open Xcode at least once to complete installation
- Accept the license agreement:
sudo xcodebuild -license accept - Restart Paperline and run Doctor again
Command Line Tools Missing
xcode-select or Homebrew not found
xcode-select or Homebrew not found
Problem: Paperline Doctor reports missing command line tools.Solutions:
- Install Xcode Command Line Tools:
xcode-select --install - Install Homebrew:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - Install xcbeautify:
brew install xcbeautify
No iOS Simulators
No simulators available for testing
No simulators available for testing
Problem: No iPhone simulators appear in the device list.Solutions:
- Open Xcode → Settings → Platforms
- Download iOS 17 or iOS 18 runtime
- Xcode will automatically create simulator devices
- Restart Paperline to refresh the device list
Build Issues
Build Fails with Swift Errors
Swift compilation errors during build
Swift compilation errors during build
Common causes:
- Xcode version mismatch (requires 16+)
- Corrupted derived data
- Clean build folder: In Paperline, use “Clean Build” option
- Delete derived data manually:
- Restart Paperline and try again
Simulator Won’t Launch
Simulator fails to start or crashes
Simulator fails to start or crashes
Solutions:
- Reset simulator: Device menu → Erase All Content and Settings
- Delete and recreate the simulator in Xcode
- Restart your Mac if simulators are unresponsive
Account Issues
API Key Not Working
OpenAI or Anthropic API key shows errors
OpenAI or Anthropic API key shows errors
Checklist:
- Verify the key is correct (no extra spaces)
- Check the key has sufficient credits/quota
- Ensure the key has the right permissions
- Try generating a new key from the provider’s dashboard
Credits Not Updating
Credit balance seems incorrect
Credit balance seems incorrect
Solutions:
- Wait a few minutes — usage syncs periodically
- Check the Dashboard at paperline.ai/dashboard
- Contact support@paperline.ai if the issue persists
App Store Deployment
Archive Build Fails
Cannot create archive for App Store
Cannot create archive for App Store
Common causes:
- Missing App Store Connect configuration
- Invalid bundle identifier
- Code signing issues
- Verify your Apple Developer account is active
- Check bundle ID matches App Store Connect app
- Ensure certificates and profiles are valid in Xcode