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

keytypedefaultdescription
showTouchesbooleanfalseshow touch indicators
systemCursorbooleanfalsekeep the computer pointer instead of a touch cursor
hardwareKeyboardbooleanfalsetype on the host keyboard and never show the on-screen one (packaged apps default to true)
showFramebooleantrueshow device frame
showMenuBarbooleantruekeep the menu bar pinned instead of hover-reveal
showStatusBarbooleantrueshow status bar
showHomeIndicatorbooleantrueshow home indicator
alwaysShowLiveWebViewsbooleanfalserender WebViews as live browser views
a11yModeoff | delayed | activedelayedaccessibility tree sync (delayed=100ms, active=30ms)
a11yDepthshallow | deepdeepaccessibility tree structure depth
inspectModebooleanfalseinspect 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. 1.
    peach.config.ts, under the settings key, for project-level defaults. See Configuration.
  2. 2.
    The simulator itself, through the notification center pull-down, for runtime changes.
  3. 3.
    A CLI flag on the command, for a per-invocation override. The CLI flag column in Configuration lists which keys have one.

Keys with no CLI flag are set from peach.config.ts or the simulator UI.