Motion style
Values below are the house defaults in brand/house.tokens.json. Templates read them as tokens; change the tokens, not template code, to retune.
Looks
House templates implement three looks through shared helpers in motion-toolkit/engine (choreo, reveal, typo). New templates must support all three the same way.
| Look | Type | Entrance | Shapes | Pace |
|---|---|---|---|---|
minimal | Medium weights, tight display tracking, wide-tracked uppercase labels | Blur + 26 px rise + fade | None or hairlines; soft text shadow on overlays | 1.4× enter, 1.75× stagger |
bold | Heavy, uppercase titles | Spring pop (slight overshoot, small rotation) | Solid accent slabs and pills, text color picked for contrast | 0.8× enter, 0.9× stagger |
corporate | Font token weights | Rise from a mask, panel wipes | Surface panels, accent bars | Token timing |
Pick the look from the brief: premium, product, Apple-keynote style → minimal; YouTube, social, energetic → bold; business, interviews, training → corporate. Set it once per client with the look token; use the look prop only for a one-off.
Easing
| Token | Curve | Use |
|---|---|---|
enter | [0.16, 1, 0.3, 1] (expo out) | Elements arriving: fast start, long settle |
exit | [0.7, 0, 0.84, 0] (expo in) | Elements leaving: slow start, quick finish |
standard | [0.4, 0, 0.2, 1] | Moves between two on-screen states |
Never use linear easing for position or scale. Opacity alone may be linear only when paired with a moving property.
Timing
- Enter 0.6–0.8 s (
durations.enter= 0.7). Exit shorter than enter (durations.exit= 0.45). - Stagger related elements 0.06–0.1 s (
stagger= 0.08) in reading order: accent, container, primary line, secondary line. - Hold for reading time: at least 1 s per 3 words, minimum 2.5 s for a lower third. Shot props set it (
holdSeconds). - Exit in reverse order of entry or all together; never leave a lone element on screen.
Movement
- Prefer reveals (mask, clip, wipe) over fades. Text rises in from a mask by 100–110 % of its line height.
- Move 20–60 px at 1080p for secondary motion; large travel only for full-frame transitions.
- One accent motion per graphic (bar grow, underline draw). Avoid bounce/overshoot unless the brand asks for it; if used,
spring({ damping: 200 })for no overshoot, lower damping for playful brands.
Layout
- Keep text inside title-safe (
layout.safeArea.title= 5 % each side) and logos inside action-safe (3.5 %). - Lower thirds sit in the bottom third, aligned to the title-safe edge, 40 px (at 1080p) above the bottom safe line.
- Sizes are authored at 1080p and scaled with
px(). Minimum text size 24 px at 1080p.
Frame rate
Match the edit's timeline (mg.json, client.json, project.json or shot video.fps). Do not render 30 fps graphics for a 25 fps timeline.