Settings schema

Settings control device simulation, appearance, network, locale, and simulator behavior.

Device

keytypedefaultdescription
deviceModelDeviceModeliphone-15-prodevice model to simulate
orientationportrait | landscapeportraitscreen orientation

Appearance

keytypedefaultdescription
colorSchemelight | dark | autolightcolor scheme
reduceMotionbooleanfalsereduce motion
boldTextbooleanfalsebold text
fontSizenumber1.0font size multiplier (0.5-2.0)

Network

keytypedefaultdescription
networkConditionwifi | lte | fast-3g | slow-3g | offlinewifisimulated network

Locale

keytypedefaultdescription
languagestringenISO 639-1 language code
regionstringUSISO 3166-1 region code

Simulator

keytypedefaultdescription
showTouchesbooleanfalseshow touch indicators
showFramebooleantrueshow device frame
showStatusBarbooleantrueshow status bar
showHomeIndicatorbooleantrueshow home indicator
a11yModeoff | default | alwaysdefaultaccessibility tree mode
inspectModebooleanfalseinspect mode

Runtime API

import { settingsStore } from 'sootsim-engine/settings'
settingsStore.get('deviceModel') // 'iphone-15-pro'
settingsStore.set('colorScheme', 'dark')
settingsStore.apply({ deviceModel: 'iphone-16-pro', colorScheme: 'dark' })
settingsStore.subscribe(() => { ... })
settingsStore.reset()