README media #
The README has image slots, not reviewed app screenshots yet. The app icon is exported from the shipped Keystone artwork. Do not publish a capture until the owner has checked every frame for private content.
Capture #
Use the owner’s unlocked Mac on an empty desktop with the default wallpaper,
2× scaling, and Parcel’s default 8-point inner and outer gaps. Quit any running
Parcel first. Grant build/Parcel.app Accessibility and the capture host
(usually the terminal) Screen Recording. Install ffmpeg for GIF and PNG export.
mise trust && mise run setup
Scripts/capture-media.sh --check
Scripts/capture-media.sh --list
Scripts/capture-media.sh --record --appearance light
Scripts/capture-media.sh --record --appearance dark
Scripts/capture-media.sh --record --appearance light --scene accessibility
Scripts/capture-media.sh --record --appearance light --scene icon
Switch macOS appearance yourself before each batch. The script checks it; it
never changes your system preferences. --scene captures just one scene. The
light batch includes hero, layouts, stacks, shortcuts, and tour; the dark batch
includes hero, snap-and-undo, and shortcuts. Icon and accessibility are separate.
Existing captures are never overwritten: move reviewed files aside before a retake.
The script builds an isolated Swift Testing driver from the existing e2e harness.
It uses FixtureApp’s acknowledged control channel and the app’s CLI. Only the
harness launches Parcel; it refuses an existing instance and cleans up its own
processes. No app is launched by --help, --list, or --check.
Menu, shortcut-recorder, and tour scenes pause for you to prepare the actual UI.
For Settings and tour, use the capture crosshair to select only public fixture UI.
Layout, stack, and snap scenes run automatically. Their overlays show commands
and the fixture configuration’s default shortcuts, read from prcl schema rather
than hard-coded. They do not inject keyboard events or use your personal bindings.
Scene list #
| Scene | Files | Display size and content |
|---|---|---|
| Icon | icon-readme.png |
200×200, exported at 400×400 from the shipped icon |
| Hero | hero-light.png, hero-dark.png |
860×538; four grid windows, focus border, menu showing layout and tile cap |
| Layouts | layouts.gif, layouts-reduced.png |
720×450; grid → columns → side → tree → accordion |
| Stacks | stacks.gif, stacks-reduced.png |
720×450; cap three, create windows four and five, cycle the stack |
| Snap and undo | snap-undo.gif, snap-undo-reduced.png |
720×450, dark; left half, make a tiled window primary, undo each focused window’s edit |
| Shortcuts | settings-shortcuts-light.png, settings-shortcuts-dark.png |
720 wide; a conflict warning and another binding mid-record |
| Accessibility | settings-accessibility.png |
Optional, 720 wide; Increase Contrast and a stronger focus border |
| Tour | tour.png |
520 wide, light; a step showing the resolved shortcut |
Stills are exported at 2×. GIFs loop at 12 fps, last less than six seconds, and must stay under 3 MB. The reduced-motion layouts still uses a 3×2 contact sheet so all five layouts fit; the sixth cell is empty. Other motion stills show the settled scene. Raw recordings stay in the harness’s temporary directory.
README slots #
The hero uses <picture> with prefers-color-scheme: dark. Motion uses
prefers-reduced-motion: no-preference to opt into GIFs; the fallback is a still,
including for readers whose browser does not understand the query. Keep descriptive
alt text on every fallback image. The shortcut and optional captures can be added
after review; they are not needed to fill the main README slots.
Scripts/check-doc-links.sh allows only these named, pending image files to be
absent. It still checks the icon, documentation links, and anchors. Once all the
captures exist, remove the pending-slot allowance and the README’s slot notice.
Preview the rendered README on both repository hosts: support for media queries
can differ, and an unverified renderer is not a promise of reduced-motion support.