Troubleshooting

Documentation Index

Fetch the complete documentation index at: https://docs.paperline.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Paperline Doctor Issues

​

Xcode Not Detected

Xcode shows as not installed or wrong version

Problem: Paperline Doctor reports Xcode is not installed or shows an older version.Solutions:

1. Download Xcode 16+ from the Mac App Store
2. Open Xcode at least once to complete installation
3. Accept the license agreement: sudo xcodebuild -license accept
4. Restart Paperline and run Doctor again

​

Command Line Tools Missing

Command Line Tools not found

Problem: Paperline Doctor reports missing command line tools.Solutions:

1. Install Xcode Command Line Tools: xcode-select --install
2. Restart Paperline and run Doctor again

​

No iOS Simulators

No simulators available for testing

Problem: No iPhone simulators appear in the device list.Solutions:

1. Open Xcode → Settings → Platforms
2. Download iOS 26 runtime (or latest available)
3. Xcode will automatically create simulator devices
4. Restart Paperline to refresh the device list

---

​

Build Issues

​

Build Fails with Swift Errors

Swift compilation errors during build

Common causes:

• Xcode version mismatch (requires 16+)
• Corrupted derived data

Solutions:

1. Clean build folder: In Paperline, use “Clean Build” option
2. Delete derived data manually:
   rm -rf ~/Library/Developer/Xcode/DerivedData
   
3. Restart Paperline and try again

​

Simulator Won’t Launch

Simulator fails to start or crashes

Solutions:

1. Reset simulator: Device menu → Erase All Content and Settings
2. Delete and recreate the simulator in Xcode
3. Restart your Mac if simulators are unresponsive

---

​

Account Issues

​

API Key Not Working

OpenAI, Anthropic, or Google API key shows errors

Checklist:

1. Verify the key is correct (no extra spaces)
2. Check the key has sufficient credits/quota
3. Ensure the key has the right permissions
4. Try generating a new key from the provider’s dashboard

​

Credits Not Updating

Credit balance seems incorrect

Solutions:

1. Wait a few minutes — usage syncs periodically
2. Check the Dashboard at paperline.ai/dashboard
3. Contact support@paperline.ai if the issue persists

---

​

App Store Deployment

​

Archive Build Fails

Cannot create archive for App Store

Common causes:

• Missing App Store Connect configuration
• Invalid bundle identifier
• Code signing issues

Solutions:

1. Verify your Apple Developer account is active
2. Check bundle ID matches App Store Connect app
3. Ensure certificates and profiles are valid in Xcode

---

​

Still Need Help?