# geni app screenshots

> Capture authenticated pages of a published app at phone and desktop widths.

Source: https://docs.generalinput.com/cli/resource/app/screenshots



```sh
geni app screenshots [id] --route / --route /customers --out ./shots
geni app screenshot [id] --viewport mobile --route '/?tab=overdue' --json
```

Captures the published app using the same authenticated rendering service as MCP. PNGs are saved locally and the output lists their paths, dimensions, requested routes and actual routes. Publish and wait for the build before capturing changes.

| Flag                | Purpose                                                                 |
| ------------------- | ----------------------------------------------------------------------- |
| `--route <path>`    | App route or query state; repeat for up to six routes. Defaults to `/`. |
| `--viewport <size>` | `mobile` (390px), `desktop` (1280px), or `both` (default).              |
| `--out <path>`      | Output directory; defaults to `app-screenshots`.                        |
| `--dir <path>`      | Resource directory for id resolution; defaults to cwd.                  |
| `--json`            | Machine-readable output with image paths and dimensions.                |

Page loads execute live handlers, so this operation requires run access. Images capture both layout and the live state the handlers return. A failed or unavailable capture exits nonzero.