Motion vocabulary · Timelines and milestones
Roadmap travel
A road draws across; a glowing ball travels it, lighting each milestone with its date; the last one blooms.
Live loop · 8 s · 1920×1080 at 24 fps
Parameters
| Parameter | Type | What it does |
|---|---|---|
| steps | [{label, value?}] | steps: 2-6 steps, low to high; value pops on landing, the last one slams |
| milestones / goal | [{date, label}] / boolean | roadmap: 3-6 milestones; goal blooms the last one (default true) |
| items / clear | string[] / boolean | hurdles: 3-5 labels; clear: the ball hops each one (done) instead of waiting (to do) |
| step_ms | ms | one beat: hop + dwell, move + dwell, hurdle to hurdle |
| ease | {"<move>": ease} | retune any named move (see the entry's moves): a preset name ("out-expo"), a cubic-bezier [x1, y1, x2, y2], {spring: [hz, damping]} or {trapezoid: [accel, decel]}. A wrong move name or curve throws, it never falls back. A move measured from a reference clip (the replica workbench's measure/*.json, frame-keyed) becomes a curve without conversion: MV.fitEase(doc, "x", {from: 133, to: 142}) or `motion-fit <file> --measure x --from 133 --to 142 --ease` |
| camera | {focal?, x?, y?, z?} | the scene's camera: pan x / y and push z as numbers or keyframes [[ms, value, ease?], ...]; objects at different depths move differently (real parallax). focal default 1800 |
| brand | hexDefault: #6B5BFF | the site's brand colour; the component derives its accent (>= 3:1 on the stage), surfaces and ink from it |
| stage | "dark" | "light"Default: "dark" | the stage the component sits on |
| display | font stemDefault: "Inter-Bold" | headline stem; name it in the call so the runtime loads it |
| body | font stemDefault: "Inter-Regular" | UI / body stem; name it in the call so the runtime loads it |
| start_ms | msDefault: 300 | when the component starts, ms into the shot |
| background | booleanDefault: false | draw the stage background (off: transparent over the shot's own stage) |
| place | {x, y, w, h, z?} | the component's place in the shot's layout: it fits its 1920x1080 composition into this stage rect (centred, aspect kept); z orders components front to back. Default: the whole stage |
Moves and their curves
Every move is eased on its own. Retune one with ease: { "<move>": <curve> }, a curve name or cubic-bezier handles.
| Move | Curve | What it does |
|---|---|---|
| road.draw | out-cubic | the road drawing |
| node.in | house | each node ring fading in |
| travel | in-out-sine | the ball travelling from node to node along the road |
| node.spring | {"spring":[2.2,0.7]} | a node springing when the ball reaches it |
| label.in | house | a node's date lighting and label rising in |
| goal.bloom | out-expo | the last node's bloom opening |
This demo
| variant | "roadmap" |
|---|---|
| milestones | [{"date":"Day 1","label":"Paste a link"},{"date":"Day 2","label":"Review the script"},{"date":"Day 3","label":"Approve the shots"},{"date":"Launch","label":"Post the film"}] |
| brand | #6B5BFF |
| stage | dark |
<script src="/vendor/motion-vocab.js"></script>
MV.bind("s3", MV.timeline(el, {"variant":"roadmap","milestones":[{"date":"Day 1","label":"Paste a link"},{"date":"Day 2","label":"Review the script"},{"date":"Day 3","label":"Approve the shots"},{"date":"Launch","label":"Post the film"}],"brand":"#6B5BFF","stage":"dark","display":"Inter-Bold","body":"Inter-Regular"}));When to use it in a launch film
How it works in steps over days, or what comes next. The last milestone is the promise.
Why it works
Travel turns a list into a journey; the bloom at the end gives the film a place to arrive.
Do not combine with
- dates the brief does not give
- more than six milestones
Job in the film
Natural length
5.0–9.0 s