Opus Motion ★ Star on GitHub

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.

Waterfall bridge: three frames of the animated chart, start, middle and end
Waterfall bridge — start, middle and end of the 6.0-second motion.

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.

  • waterfall
  • bridge
  • variance
  • walk
  • finance
  • chart
  • data
  • increase
  • decrease
  • infographic
  • count-up
  • legend
  • overlay

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
title subtitle prefix
Colour props
increaseColor decreaseColor totalColor background ink
Mood
nature, hud
Roles
accent, subject

Use Waterfall bridge in Remotion, React or HTML

Remotion project

terminal
# 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

tsx
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

html
<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)

json
{
  "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.

PropDefaultWhat 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
autoTotaltrueappend 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", "%"
decimals0decimal places
showConnectorstruedashed lines joining bars at the running level
showGridtruevalue gridlines (with axis labels on 16:9 and 1:1)
showLegendtrueincrease / 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)
startAt10frame the first bar starts
speed1animation speed multiplier

Notes & credits

Technique sources:

  • original round-3 chart motion