> ## 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.

# Troubleshooting

> Fix common Paperline issues — Xcode setup, iOS Simulator problems, build errors, API keys, and App Store deployment troubleshooting.

## Paperline Doctor Issues

### Xcode Not Detected

<Accordion title="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](https://apps.apple.com/app/xcode/id497799835)
  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
</Accordion>

### Command Line Tools Missing

<Accordion title="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
</Accordion>

### No iOS Simulators

<Accordion title="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
</Accordion>

***

## Build Issues

### Build Fails with Swift Errors

<Accordion title="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:
     ```bash theme={null}
     rm -rf ~/Library/Developer/Xcode/DerivedData
     ```
  3. Restart Paperline and try again
</Accordion>

### Simulator Won't Launch

<Accordion title="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
</Accordion>

***

## Account Issues

### API Key Not Working

<Accordion title="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
</Accordion>

### Credits Not Updating

<Accordion title="Credit balance seems incorrect">
  **Solutions**:

  1. Wait a few minutes — usage syncs periodically
  2. Check the Dashboard at [paperline.ai/dashboard](https://paperline.ai/dashboard)
  3. Contact [support@paperline.ai](mailto:support@paperline.ai) if the issue persists
</Accordion>

***

## App Store Deployment

### Archive Build Fails

<Accordion title="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
</Accordion>

***

## Still Need Help?

<CardGroup cols={2}>
  <Card title="Contact Support" href="mailto:support@paperline.ai">
    Email us at [support@paperline.ai](mailto:support@paperline.ai)
  </Card>

  <Card title="Community" href="https://x.com/PaperlineAI">
    Follow us for updates and tips
  </Card>
</CardGroup>