Data · waterfall-bridge
Waterfall bridge
A waterfall / bridge chart: an opening total, then floating increase and decrease bars that grow one after another from the running level, joined by dashed connectors, with signed count-up values and a closing total; vertical on 16:9 and 1:1, horizontal on 9:16.
A free, MIT-licensed animated chart from the Opus Motion Library — 616 motions for Remotion, React and plain HTML.

What Waterfall bridge is for
Explaining how one number became another: revenue bridge, profit walk, budget variance, headcount change, price-volume-mix. Give the opening total, the deltas and let the end total compute itself.
Details
- Category
- Animated charts & data visualisation
- Length
- 6.0 s (180 frames at 30 fps)
- Formats
- 16:9, 1:1, 9:16
- Weight
- light
- Transparent overlay
- yes
- Seamless loop
- no
- Text props
titlesubtitleprefix- Colour props
increaseColordecreaseColortotalColorbackgroundink- Mood
- nature, hud
- Roles
- accent, subject
Use Waterfall bridge in Remotion, React or HTML
Remotion project
# copy this motion into your Remotion project
node cli/mgl.mjs add waterfall-bridge --to ../my-app/src
# render an mp4 (run in the library folder)
node cli/mgl.mjs render waterfall-bridge --props '{"title":"From opening to closing","subtitle":"What moved the number, in thousands","prefix":"","increaseColor":"#16B39A","decreaseColor":"#E5487F","totalColor":"#2F6FED","background":"#F5F3EE","ink":"#18212B"}'
# or export for apps / editors: mp4 | webm-alpha | prores-alpha | gif | png | poster
node cli/mgl.mjs export waterfall-bridge --as webm-alpha --props '{"title":"From opening to closing","subtitle":"What moved the number, in thousands","prefix":"","increaseColor":"#16B39A","decreaseColor":"#E5487F","totalColor":"#2F6FED","background":"#F5F3EE","ink":"#18212B"}'React / Next.js
import {MotionPlayer} from 'opus-motion-library/web';
<MotionPlayer
motion="waterfall-bridge"
props={{
title: 'From opening to closing',
subtitle: 'What moved the number, in thousands',
prefix: '',
increaseColor: '#16B39A',
decreaseColor: '#E5487F',
totalColor: '#2F6FED',
background: '#F5F3EE',
ink: '#18212B',
}}
playOnView
loop="auto"
/>Plain HTML / WordPress
<script src="opus-motion.element.js" defer></script>
<opus-motion motion="waterfall-bridge"
props='{"title":"From opening to closing","subtitle":"What moved the number, in thousands","prefix":"","increaseColor":"#16B39A","decreaseColor":"#E5487F","totalColor":"#2F6FED","background":"#F5F3EE","ink":"#18212B"}'>
</opus-motion>Compose spec (multi-scene video)
{
"width": 1920,
"height": 1080,
"fps": 30,
"scenes": [
{
"motion": "waterfall-bridge",
"props": {
"title": "From opening to closing",
"subtitle": "What moved the number, in thousands",
"prefix": "",
"increaseColor": "#16B39A",
"decreaseColor": "#E5487F",
"totalColor": "#2F6FED",
"background": "#F5F3EE",
"ink": "#18212B"
}
}
]
}Waterfall bridge props
22 parameters — change any of them to make the motion yours.
| Prop | Default | What it does |
|---|---|---|
steps | [{"label":"Opening","value":120,"total":true},{"label":"New customers","value":45},{"la… | bars in order [{label, value, total?}]; total:true sets the running level (usually the first), otherwise value is a +/- change |
autoTotal | true | append a closing total bar computed from the steps |
endLabel | "Closing" | label of the closing total bar |
title | "From opening to closing" | headline (empty = none) |
subtitle | "What moved the number, in thousands" | small line under the headline (empty = none) |
prefix | "" | text before numbers, e.g. "$" |
suffix | "K" | text after numbers, e.g. "K", "%" |
decimals | 0 | decimal places |
showConnectors | true | dashed lines joining bars at the running level |
showGrid | true | value gridlines (with axis labels on 16:9 and 1:1) |
showLegend | true | increase / decrease / total legend |
increaseLabel | "Increase" | legend text for increases (empty = hide entry) |
decreaseLabel | "Decrease" | legend text for decreases |
totalLabel | "Total" | legend text for totals |
increaseColor | "#16B39A" | colour of increase bars |
decreaseColor | "#E5487F" | colour of decrease bars |
totalColor | "#2F6FED" | colour of total bars |
background | "#F5F3EE" | page colour, or "transparent" |
ink | "#18212B" | text and grid colour |
fontFamily | "" | CSS font family (empty = Space Grotesk) |
startAt | 10 | frame the first bar starts |
speed | 1 | animation speed multiplier |
Related motions

Donut breakdown
Share-of-total stories on any brand: revenue by channel, budget split, traffic sources, survey answers, market share. Replace data,…
donut-breakdown
Progress rings stats
Goal progress and KPI sets: completion rates, daily targets, quota attainment, fitness-style stats, survey scores. Each ring has its own…
progress-rings-stats
Stacked area flow
Composition over time: revenue by product line, traffic by source, energy mix, users by plan, time spent by activity. Replace xLabels and…
stacked-area-flow
Bar chart race
Rankings over time: market share by year, top products by quarter, followers by month, league tables, "who is winning" stories. Give the…
bar-race
Funnel conversion
Sales and signup funnels, hiring pipelines, checkout drop-off, content-to-lead stories, any "how many survive each step" breakdown.…
funnel-conversion
Radar compare
Comparing two or three things across the same criteria: products, plans, candidates, teams, skill profiles, before / after. Replace axes,…
radar-compare
Notes & credits
Technique sources:
- original round-3 chart motion