GeezerVison

why: Demo GIFs must render at their real size without shifting the page
as they load, and the recorded sources (tapes, casts, mp4/webm) should
stay in the repo without being published to the static site.

what:
- Add the aspect_ratio extension, stamping each demo <img> with
  width:<W>px; max-width:100%; aspect-ratio:W/H from the source GIF, so
  narrow demos never upscale and the browser reserves the box up front
- Index the embedded asciinema GIFs last so their cropped size wins the
  basename over same-named vhs/legacy gifs regardless of walk order
- Exclude "demos/**" from the build; referenced GIFs still reach the
  site via Sphinx's _images/ collection

why: Give each tmuxp subcommand a short terminal demo so the docs,
README, and homepage show real output instead of only prose.

what:
- Add asciinema casts and agg-rendered GIFs (cropped to content with a
  10px sampled-background margin) for ls, load, search, freeze, convert,
  shell, edit, import, and debug-info
- Add VHS tapes with rendered GIF/MP4/WebM source assets
- Record the load demo attached (no -d) over a small Flask web-dev
  workspace, so it shows tmuxp building windows and panes and handing a
  live session over before detaching
- Add setup-sandbox.sh, which builds an isolated, PII-free demo sandbox
  (sandbox venv install + fun workspace configs + TMUX_TMPDIR server)
  themed with a Solarized Dark .tmux.conf

why: Show each command's real output next to its reference.

what:
- Embed the demo GIF on each of the nine CLI subcommand pages
- Replace the legacy shell -c screencast with the recorded shell demo
- Resize the load embed and correct its alt text to match the attached
  recording

why: Let readers on GitHub and PyPI see tmuxp's commands in action.

what:
- Embed the load, ls, shell, freeze, convert, and debug-info demos under
  their sections, replacing the stale hand-recorded screenshot
- Size each <img> to the demo's real pixel width so narrow demos are not
  upscaled and blurred, and match the load embed to the attached recording

why: Lead the homepage with the pitch and the navigation cards; show the
load demo once, at the foot, instead of between the intro and the cards.

what:
- Replace the stale hand-recorded homepage screencast with the attached
  load demo
- Place it in a Screenshot section at the bottom of the page, sized and
  alt-texted to match the attached recording

why: Temporarily build and deploy the docs from this branch so the new
CLI demo recordings can be previewed on the live site before merge.

what:
- Add screen-recording-2026-07-12 to the docs workflow push trigger

Drop this commit before merging; it exists only to trigger a preview
deploy and must not reach master.