Files
dong.nguyen e02fe19bbe video: point explanations at the diagram, extend scenes for readable dwell
Explanations become Callout chips (kit.tsx): a leader line draws from the
target element, the chip fades in only after the line completes, timed to
the scene beat. The fixed bottom bullet row in SceneChrome is deleted.
Leaders stop at element outer edges; chips sit fully outside each visual
group (Pipeline push callout narrowed clear of the group box).

Timeline 62s -> 81s (2425 frames): every callout holds >=150 frames after
it appears; scene beats unchanged, hold time added at each scene end.
.vtt cue times, EN+VI chapter times, README take minimums (24s/17s) and
spec-v7 scene table, no-overlap and dwell rules follow the new boundaries.
Re-rendered public/media/how-it-works.mp4.
2026-10-29 00:38:07 +07:00

44 lines
1.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Intro video — `video/`
Standalone [Remotion](https://remotion.dev) project that renders the
`/how-it-works` explainer. It is a pnpm workspace member but the SPA never
imports it; its only output is the committed media in `public/media/`.
Spec: `docs/design/specs/v7/spec-v7-intro-video.md`.
## Render
```sh
pnpm --dir video render # → public/media/how-it-works.mp4 (captions burned in, no footage needed)
pnpm --dir video poster # → public/media/how-it-works-poster.jpg (title-card frame)
pnpm --dir video studio # interactive preview while tuning timings
```
## Captured variant (screen footage)
The composition has a `captured` input prop. With `--propsFile=captured.json`
the two animated mock-browser stages (scenes 02 and 04) are replaced by real
screen recordings — the intended final polish, recorded with Screenity or any
screen recorder:
| File (drop into `video/inputs/`) | Beat | Minimum length |
|---|---|---|
| `take-edit.mp4` | open the live site → append `?edit` → Basic-auth sign-in → edit one heading inline → Save | 24 s |
| `take-pipeline.mp4` | GitHub Actions run: build → generate-resume → deploy, then the updated live page | 17 s |
Record at 1920×1080, browser zoom 100%, dark theme. Trim so each take starts
clean (no cursor scrubbing). Then:
```sh
pnpm --dir video render-captured
```
Raw takes are gitignored — the rendered MP4 is the committed artifact.
## Timeline (source of truth: `src/timeline.ts`)
30 fps · 2425 frames · 81 s. Scene durations include ≥5 s of hold time after
the last callout so every on-screen explanation is readable before the cut.
Scene boundaries drive the chapter list and the `.vtt` caption tracks in
`public/media/` — if the timeline changes, those and the `howItWorks` UI
group's chapters (EN + VI) must change with it.