Settings Schema
Settings control iOS and Android device simulation, appearance, network, locale, and simulator behavior.
Device
| key | type | default | description |
|---|---|---|---|
| deviceModel | DeviceModel | iphone-17-pro | device model to simulate |
| orientation | portrait | landscape | portrait | screen orientation |
| homeScreenVersion | ios26 | ios27 | device’s os | which iOS home screen the simulator portrays (ios26 = the flat home, ios27 = the measured 27 home the iPhone Duo ships) |
Choose an iPhone or Android device model. For example, use pixel-8 for an
Android profile or iphone-17-pro for an iOS profile.
Appearance
| key | type | default | description |
|---|---|---|---|
| colorScheme | light | dark | auto | auto | color scheme (auto follows system) |
| reduceMotion | boolean | false | reduce motion |
| boldText | boolean | false | bold text |
| fontSize | number | 1.0 | font size multiplier (0.5-4.0) |
Network
| key | type | default | description |
|---|---|---|---|
| networkCondition | wifi | lte | fast-3g | slow-3g | offline | wifi | simulated network |
Locale
| key | type | default | description |
|---|---|---|---|
| language | string | en | ISO 639-1 language code |
| region | string | US | ISO 3166-1 region code |
Simulator
| key | type | default | description |
|---|---|---|---|
| showTouches | boolean | false | show touch indicators |
| showFrame | boolean | true | show device frame |
| showMenuBar | boolean | true | keep the menu bar pinned instead of hover-reveal |
| showStatusBar | boolean | true | show status bar |
| showHomeIndicator | boolean | true | show home indicator |
| alwaysShowLiveWebViews | boolean | false | render WebViews as live browser views |
| a11yMode | off | delayed | active | delayed | accessibility tree sync (delayed=100ms, active=30ms) |
| a11yDepth | shallow | deep | deep | accessibility tree structure depth |
| inspectMode | boolean | false | inspect mode |
Screenshot Mode and 3D Mode add their own screenshot* / three* keys; see
App Store screenshots.
Setting these values
Three surfaces write settings, in order of override priority (highest last):
- +
rnx.config.ts, under thesettingskey, for project-level defaults. See Configuration. - +The simulator itself, through the notification center pull-down, for runtime changes.
- +A CLI flag on the command, for a per-invocation override. The
CLI flagcolumn in Configuration lists which keys have one.
Keys with no CLI flag are set from rnx.config.ts or the simulator UI.