Sets: capture and publish
A set is a directory of files with a share URL. vitrinka set is how one gets made, filled and sent — and the whole set is re-sent on every push, so a push after a period offline backfills everything.
Start a set
Creates a .vitrinka set config in the repository so pushes know where they are going.
vitrinka set initCapture a shot
Captures a screenshot straight into the set and pushes it. It drives an iOS simulator, an Android emulator, macOS or a browser — or adopts an image you already have.
vitrinka set capture web \
--route /checkout \
--note "discount applies twice" \
--open https://localhost:3000/checkout--note and --route are required: a shot with neither is a picture nobody can place.
Capture flags
| Flag | What it does |
|---|---|
--route | Required. The app route the shot was taken on. |
--note | Required. The caption. |
--title | Human title — also names the file. |
--label | A stable shot label. Journey wiring targets it. |
--next | Journey branch: the target shot's label. Repeatable. |
--target | {X,Y,W,H} JSON bbox of the clicked element — follows a --next. |
--open | A deep link to open before capturing. |
--settle | Seconds to wait before capturing. Default 4 with --open, otherwise 0. |
--viewport | WxH or WxH@scale, e.g. 393x852@3. |
--udid | iOS simulator UDID. |
--region | macOS capture region, x,y,w,h. |
--file | Adopt an existing image instead of capturing one. |
--hq | Full-fidelity asset: no lossy re-encode, no resize. |
--src | The implementing source file. Repeatable or comma-separated. |
--state | Notable app or auth state. |
--url | Provenance URL — beats --open in the manifest. |
--root | Capture root. Default .vitrinka/screenshots. |
Push the set
Archives the capture root and uploads it. Idempotent — the whole set goes every time, so re-running replaces the content rather than appending to it.
vitrinka set push --title "Checkout — pass 3"| Flag | What it does |
|---|---|
--root | Capture root. Default .vitrinka/screenshots. |
--title | Human title, re-sent on every push. |
--source | Cross-link a source set: project/branchSlug/key. |
Name and frame it
meta sets the journey header — kicker, title, accent, intro and chips. rename gives the set a stable custom name so a readable URL works alongside the numeric one.
vitrinka set meta --title "Checkout" --kicker "pass 3"
vitrinka set rename myapp/main/7 payout-flowArtifacts
An artifact is a self-contained interactive page rather than a gallery. init scaffolds one with its set config; create builds a report from an existing screenshot set.
vitrinka artifact init
vitrinka artifact create