Configuring Custom iOS Simulator Devices in React Native

Nov 22, 2025 · Programming · 8 views · 7.8

Keywords: React Native | iOS Simulator | Device Configuration

Abstract: This article provides a comprehensive guide on customizing iOS simulator devices in React Native development, covering the use of --simulator flag, listing available devices, and current limitations in setting default devices. Based on official documentation and community discussions, it offers complete configuration examples and best practices.

Overview of iOS Simulator Device Configuration in React Native

In React Native development, selecting appropriate iOS simulator devices is a common configuration requirement. By default, the react-native run-ios command automatically launches the application in a pre-selected simulator device, but developers often need to switch between different device models based on testing requirements.

Specifying Devices with --simulator Parameter

React Native provides the --simulator command-line parameter to explicitly specify the target simulator device. This parameter accepts device names as values, allowing developers precise control over the simulation environment.

Here are available device configurations for iOS 14.0 and later systems:

npx react-native run-ios --simulator="iPhone 8"
npx react-native run-ios --simulator="iPhone 8 Plus"
npx react-native run-ios --simulator="iPhone 11"
npx react-native run-ios --simulator="iPhone 11 Pro"
npx react-native run-ios --simulator="iPhone 11 Pro Max"
npx react-native run-ios --simulator="iPhone SE (2nd generation)"
npx react-native run-ios --simulator="iPhone 12 mini"
npx react-native run-ios --simulator="iPhone 12"
npx react-native run-ios --simulator="iPhone 12 Pro"
npx react-native run-ios --simulator="iPhone 12 Pro Max"
npx react-native run-ios --simulator="iPhone 13 Pro"
npx react-native run-ios --simulator="iPhone 13 Pro Max"
npx react-native run-ios --simulator="iPhone 13 mini"
npx react-native run-ios --simulator="iPhone 13"
npx react-native run-ios --simulator="iPod touch (7th generation)"
npx react-native run-ios --simulator="iPad Pro (9.7-inch)"
npx react-native run-ios --simulator="iPad (9th generation)"
npx react-native run-ios --simulator="iPad Air (4th generation)"
npx react-native run-ios --simulator="iPad Pro (11-inch) (3rd generation)"
npx react-native run-ios --simulator="iPad Pro (12.9-inch) (5th generation)"
npx react-native run-ios --simulator="iPad mini (6th generation)"

Listing Available Devices

To obtain a complete list of all available iOS simulator devices in your system, use the Xcode command-line tool:

xcrun simctl list devices

This command outputs a comprehensive device list including device names, UDIDs, and status information, helping developers identify available simulator options.

Limitations in Default Device Configuration

According to React Native official documentation and community discussions, current versions do not provide a direct method to set default simulator devices. While there have been community proposals for adding a react-native set ios-simulator command, this remains an unimplemented feature to date.

Developers must either explicitly specify the --simulator parameter with each command execution or use script wrappers to simplify repetitive device selection operations.

Best Practice Recommendations

For development scenarios requiring frequent switching between different devices for testing, we recommend:

  1. Encapsulate commonly used device configurations in package.json scripts section
  2. Use environment variables to manage device preference settings
  3. Establish team-wide standardized device testing protocols
  4. Regularly update Xcode to ensure access to the latest simulator device support

Copyright Notice: All rights in this article are reserved by the operators of DevGex. Reasonable sharing and citation are welcome; any reproduction, excerpting, or re-publication without prior permission is prohibited.