An auto tiler for macOS
parcel docs media README.md
4.2 kB · 71 lines
Markdown
at main

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.