Configuration
sootsim.config.ts
Create a config file in your project root:
terminal
Full config reference
Settings
All settings can be configured via:
sootsim.config.ts— project-level defaults- CLI flags — per-invocation overrides
- simulator UI — runtime changes (notification center pull-down)
Device settings
| setting | CLI flag | values | default |
|---|---|---|---|
| deviceModel | --device | iphone-se, iphone-15, …, iphone-16-pro-max | iphone-15-pro |
| orientation | --orientation | portrait, landscape | portrait |
Appearance settings
| setting | CLI flag | values | default |
|---|---|---|---|
| colorScheme | --theme | light, dark, auto | light |
| reduceMotion | — | boolean | false |
| boldText | — | boolean | false |
| fontSize | — | 0.5-2.0 | 1.0 |
Network settings
| setting | CLI flag | values | default |
|---|---|---|---|
| networkCondition | --network | wifi, lte, fast-3g, slow-3g, offline | wifi |
Locale settings
| setting | CLI flag | values | default |
|---|---|---|---|
| language | --language | ISO 639-1 codes | en |
| region | --region | ISO 3166-1 codes | US |
Simulator settings
| setting | CLI flag | values | default |
|---|---|---|---|
| showFrame | --frame | boolean | true |
| showTouches | — | boolean | false |
| showStatusBar | — | boolean | true |
| showHomeIndicator | — | boolean | true |
| a11yMode | — | off, default, always | default |
| inspectMode | — | boolean | false |
Optional dev-server integration
If you want a stable /__soot URL on the same dev server your team already
runs, use the integration that matches your stack:
- Metro Plugin for Expo, bare React Native, and other Metro-based apps
- One Plugin for One apps
These integrations do not replace sootsim.config.ts. They simply expose
SootSim on the existing dev server. You can still skip them entirely and use
sootsim open <port> against a running app.