Skip to main content

iOS Emulator Setup

📖 Documentation View✅ Interactive Checklist
View the complete documentation

iOS Emulator Setup Guide

Prerequisites​

1. Install Xcode​

  1. Open the Mac App Store
  2. Search for "Xcode"
  3. Click "Get" or "Install"
  4. Wait for the download and installation to complete (this may take a while)

2. Install Xcode Command Line Tools​

# Check if already installed
xcode-select -p

# If not installed, run:
xcode-select --install

Setting Up the iOS Simulator​

1. Run the Setup Script​

# Run the setup script
npm run setupEmulator:ios

2. Simulator Selection​

You'll see a list of available simulators:

Enter the number of your desired simulator (e.g., 2 for iPhone 16 Pro).

3. Verify Simulator Launch​

After selecting a simulator, it will launch automatically:

You should see:

  • The iOS device simulator window
  • Default iOS home screen
  • Correct iOS version (e.g., iOS 18.1)
  • Standard iOS apps and interface

5. Configuration Setup​

Create or update your config/config.json:

{
  "WEBVIEW_CONFIG": {
    "port": "3005",
    "ios": {
      "buildType": "debug",
      "appBundleId": "com.your.app",
      "simulatorName": "iPhone 16 Pro"
    }
  }
}