Skip to main content

​
Paperline Doctor

When you launch Paperline, the Doctor runs automatically to verify your setup. You can also trigger it manually by clicking “Check tools” in the welcome screen.

​
System Checks

Paperline Doctor checks three main components:
Required: Xcode 16 or laterXcode is Apple’s development environment. Paperline uses Xcode’s build tools to compile Swift code and run the iOS Simulator.If not installed:
  • Click “Open App Store” button in Paperline
  • Or search for “Xcode” in Mac App Store
  • Download takes approximately 12GB
  • Open Xcode once after installation to accept the license
This includes three components that Paperline will install automatically:
  • Homebrew — Package manager for macOS
  • Xcode Command Line Tools — Compilers and build utilities
  • xcbeautify — Build log formatter for cleaner output
Click “Install” button and Paperline handles the rest.
Required: iOS SDK and at least one iPhone simulator
  • iOS Runtime — The iOS SDK for building apps
  • iPhone Simulator — Virtual iPhone for testing (e.g., iPhone 17 Pro)
Click “Install” and Paperline will:
  1. Download the latest iOS runtime via xcodebuild -downloadPlatform iOS
  2. Create an iPhone 17 Pro simulator automatically

​
Status Indicators

StatusMeaning
GreenComponent is installed and ready
RedComponent is missing — click to install
PulsingInstallation in progress

​
Troubleshooting

Open Xcode from Applications folder and accept the license agreement. You may need to enter your Mac password.
iOS runtime download is several GB. It can take 10-30 minutes depending on your internet connection. Progress is shown in the Paperline UI.
  1. Open Xcode 2. Go to Window → Devices and Simulators 3. Click + to add a new simulator 4. Click “Check tools” in Paperline to refresh
Try installing Homebrew manually:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Then click “Check tools” in Paperline.