Settings Schema

Settings control 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

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-2.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
showTopBar	boolean	true	show the simulator top bar
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.

Runtime API

import { settingsStore } from 'sootsim-engine/settings'

settingsStore.get('deviceModel')         // 'iphone-17-pro'
settingsStore.set('colorScheme', 'dark')
settingsStore.apply({ deviceModel: 'iphone-16-pro', colorScheme: 'dark' })
settingsStore.subscribe(() => { ... })
settingsStore.reset()

Config

Metro Plugin

Settings Schema

#Device

#Appearance

#Network

#Locale

#Simulator

#Runtime API