[subwaymatch]

This PR does three things:

• It adds video/, a Remotion project that renders a walkthrough video with music and sound effects.
• It puts the video on the docs site's overview page.
• It replaces every sample photo in the docs with minimal, Korea-themed ones, and the video uses those photos.

Docs sample photos

• scripts/generate_photos.py now generates 13 minimal photos of Korean subjects with gpt-image-2.5-flare at quality: low: a palace pond at sunrise, a portrait in hanbok and gat, a Seoul alley at night, bibimbap, lotus lanterns, palace eaves, the Jeju coast, a bamboo forest, a celadon tea set in a hanok, Gamcheon Culture Village, a fishing harbor, a hanbok silhouette and a snowy hanok. Each keeps what its recipes rely on, such as a hazy harbor, a night street, or a silhouette against a white sky.
• scripts/docs_examples.py has the new slugs and alt text. The few recipe descriptions that named something in a photo are updated, for example "the beard and the woven gat hat" and "the turquoise houses violet".
• Two recipes were tuned to the new photos:
  • The flat-photo Levels points (0.16 → black, 0.82 → white) now match the harbor's actual tonal range, which is about 0.17–0.80.
  • The red-filter B&W recipe moves to the Jeju coast, so the sky and clouds carry the effect. On the dark palace eaves it came out almost entirely black.
• The README's operation gallery (docs/previews/) is now generated from the Gamcheon Culture Village photo instead of test-images/piano-man-01.jpg. The README markdown is unchanged and still matches generate_previews.py --markdown.
• scripts/build_docs.py rebuilt every page and image. The old photos and their renders are removed.

Video on the docs site

• The overview page (index.html) has a new Video section after the interactive looks. It's a plain <video controls> showing docs/video/layeris.mp4, with docs/video/poster.jpg (the intro's logo and wordmark) as its poster.
• The overview's sidebar links to the section.
• The styling is a small .video rule in docs/assets/site.css, matching the page's other images.
• The Remotion project renders straight into docs/video/ (npm run render, npm run poster), so there's a single copy of the MP4.

Video

The video is 1920×1080, 30 fps, 52.1 s, H.264 in BT.709, with AAC audio. It walks through the package rather than selling it, styled like the docs site: white page, the docs' fonts and syntax colors, and section headings with a rule above. The layeris wordmark is typed in DM Mono, as on the docs home page.

• Intro: the logo vector's three layers draw their outlines while fanned out, then settle into place as the fills fade in. The wordmark then types in.
• 01 Install: pip install layeris, with pip's Collecting and Downloading lines and a quick progress bar before the success line. The wheel name and size match pip wheel . for 0.4.0.
• 02 Chain operations: the hanbok portrait, edited one chained call at a time.
• 03 Blend modes: all 14 modes on the Jeju coast.
• 04 Curves: r and b control points easing into place on the bamboo forest.
• 05 Looks: cross-processed (Gamcheon Culture Village), cyanotype (palace pond), and a duotone loaded with apply_from_json (palace eaves).
• Outro: logo, wordmark, install command, links and license.

video/scripts/build_assets.py renders every edited image in the video from docs/photos/ with layeris. It records the exact code that ran in video/src/data/assets.json, and the video reads its code snippets from that file. Fonts are bundled through @fontsource, and all npm versions are pinned.

Sound

• Sound effects: these come from video/scripts/generate_sound_effect.py, using the ElevenLabs Sound Effects API.
  • A short shimmer (video/public/logo.mp3) plays as the logo's outlines start to draw.
  • A soft keystroke (video/public/key.mp3) plays on the exact frame each letter of the wordmark appears.
• Music: a mellow lo-fi instrumental (Rhodes chords over a laid-back beat with upright bass, about 86 BPM). It starts as the logo fades out at the end of the intro (4.3 s) and fades over the last second.
  • It's video/public/music.mp3, generated by video/scripts/generate_music.py with the ElevenLabs Music API (music_v2_5, lofi style).
  • This take is 52.1 s long, so the video fades out its last second. By then the take is already winding down.
  • New takes from the script are sized to the 47.8 s the music plays for.
• Levels: the final mix is about -15.9 LUFS, with a -1.3 dBFS peak.

Checks

• pytest: 313 passed.
• Every image that docs/*.html and the README reference exists.
• npx tsc --noEmit passes for the video.
• I reviewed contact sheets of the new photos, all 24 recipe results and the README previews, and frames extracted from the rendered MP4.
• I measured where each sound sits in the final file and its loudness. The detected keystroke onsets fall within about 15 ms of their letters' frames.
• I took screenshots of the overview page served locally, and the MP4 is served with a 200.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Lpfz52CucHEw9WyhgzPjmj