peach map

Builds a screen map of the running app one capture at a time: peach map add screenshots the current sim and ties it to a route, with an optional edge recording the tap that got there. peach map crawl opens each route by deep link and captures it in order, discovering routes from --app or taking a listed --routes. The working file is peach-map.json with pngs under peach-map-assets/. peach map publish uploads the map to Peach Cloud, where the repo Map section shows it by branch, device and appearance. peach canvas map puts the map on a canvas beside anything else there, every route a live app.

terminal
peach map add --route <path> [--title <text>] [--from <screen> --label <text>]
peach map crawl --scheme <myapp://> --routes /,/settings
peach map crawl --app <dir> [--scheme <myapp://>] [--routes /,/settings]
peach map list
peach map publish --owner <org> --repo <name> [--branch <name>]

Options

flagdescription
--route <path>route this screen answers to; also its screen id
--title <text>display title, defaults to the route
--state <name>a second state of the same screen, e.g. signed-in
--from <screen>screen the tap started from; adds an edge
--label <text>tapped control label recorded on the edge
--png <file>use an existing png instead of capturing the sim
--app <dir>crawl: discover routes from the app router dir
--scheme <url>crawl: deep link scheme, e.g. myapp://
--routes <list>crawl: comma separated routes to capture
--settle-ms <n>crawl: wait per route for the tree to change
--owner <org>publish: github owner the cloud repo is linked under
--repo <name>publish: repo name
--branch <name>publish: branch the map belongs to
--file <path>working file, defaults to peach-map.json

Examples

terminal
peach map add --route / --title Home
peach map add --route /settings --from / --label Settings
peach map crawl --scheme myapp:// --routes /,/settings,/profile
peach map crawl --app ~/my-app
peach map publish --owner acme --repo my-app