config.json

{
  "$comment": ".screenmap/config.json — mechanical knobs for the deterministic lane. All optional.",
  "$effort": "fast | balanced (default) | thorough — token cost and speed vs accuracy. fast: agent only sees screens no flow can reach. balanced: also re-checks routes whose deep link guesses a param. thorough: every screen goes through the agent. Anything you set below wins over the preset.",
  "effort": "balanced",
  "scheme": "myapp",
  "appName": "myapp",
  "$platforms": "Which platforms a local run captures: [\"ios\"] (default), [\"android\"], or both — both puts every screen in one map with a platform switcher. In CI each platform is its own job (see the workflow templates), so the Action takes one platform and the jobs are merged afterwards.",
  "platforms": ["ios"],
  "ios": {
    "$comment": "device is the simulator name; bundleId/appPath are discovered when omitted. The pre-multi-platform top-level device/bundleId/appPath keys still mean iOS.",
    "device": "iPhone 17 Pro"
  },
  "android": {
    "$comment": "device is the AVD name or the model of an attached device; null takes whatever is attached, else the first AVD. packageName/appPath are discovered when omitted.",
    "device": null
  },
  "waits": { "transition": 2500, "network": 6000, "boot": 15000, "relaunch": 4000 },
  "suspects": { "broadCap": 8 },
  "agent": {
    "$comment": "provider: claude (default) | codex | gemini | opencode; or command: a bash template run instead ({promptFile} / $SCREENMAP_PROMPT_FILE carry the task), with keyEnv naming the env var it needs. scan overrides the effort preset: unflowed | params | all",
    "enabled": true,
    "provider": "claude"
  },
  "params": { "name": "bsky.app", "Profile.name": "bsky.app" }
}