Settings Schema
Settings control iOS and Android device simulation, appearance, locale, and simulator behavior.
Device, appearance and locale
Devices and Settings lists every setting of the simulated device with its default and values, generated from the settings schema the simulator runs, next to every device profile you can pick.
Simulator
| key | type | default | description |
|---|---|---|---|
| showTouches | boolean | false | show touch indicators |
| systemCursor | boolean | false | keep the computer pointer instead of a touch cursor |
| hardwareKeyboard | boolean | false | type on the host keyboard and never show the on-screen one (packaged apps default to true) |
| 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):
- 1.
peach.config.ts, under thesettingskey, for project-level defaults. See Configuration. - 2.The simulator itself, through the notification center pull-down, for runtime changes.
- 3.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 peach.config.ts or the simulator UI.