Opus Motion ★ Star on GitHub

Data · heatmap-calendar

Heatmap calendar

A GitHub-style contribution calendar: one rounded square per day, shaded in levels of the accent colour, popping in left to right with month and weekday labels, count-up stats and a less / more legend; the best day gets a pulsing ring. Reflows to a grid of mini-month calendars in square and vertical frames.

A free, MIT-licensed animated chart from the Opus Motion Library — 616 motions for Remotion, React and plain HTML.

Heatmap calendar: three frames of the animated chart, start, middle and end
Heatmap calendar — start, middle and end of the 7.0-second motion.

What Heatmap calendar is for

Activity over a year: commits, workouts, streaks, sales days, habits, support tickets, website traffic by day. Pass values (one number per day) and startDate, set the accent colour and unit; leave values empty to preview with seeded sample data.

  • heatmap
  • calendar
  • github
  • contribution
  • activity
  • streak
  • habit
  • chart
  • infographic
  • data
  • overlay
  • statistics
  • year

Details

Category
Animated charts & data visualisation
Length
7.0 s (210 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
accent background ink
Mood
hud
Roles
accent, subject

Use Heatmap calendar in Remotion, React or HTML

Remotion project

terminal
# copy this motion into your Remotion project
node cli/mgl.mjs add heatmap-calendar --to ../my-app/src

# render an mp4 (run in the library folder)
node cli/mgl.mjs render heatmap-calendar --props '{"title":"A year of activity","subtitle":"Each square is one day, darker means more","prefix":"","accent":"#16A34A","background":"#F5F3EE","ink":"#18212B"}'

# or export for apps / editors: mp4 | webm-alpha | prores-alpha | gif | png | poster
node cli/mgl.mjs export heatmap-calendar --as webm-alpha --props '{"title":"A year of activity","subtitle":"Each square is one day, darker means more","prefix":"","accent":"#16A34A","background":"#F5F3EE","ink":"#18212B"}'

React / Next.js

tsx
import {MotionPlayer} from 'opus-motion-library/web';

<MotionPlayer
  motion="heatmap-calendar"
  props={{
    title: 'A year of activity',
    subtitle: 'Each square is one day, darker means more',
    prefix: '',
    accent: '#16A34A',
    background: '#F5F3EE',
    ink: '#18212B',
  }}
  playOnView
  loop="auto"
/>

Plain HTML / WordPress

html
<script src="opus-motion.element.js" defer></script>

<opus-motion motion="heatmap-calendar"
  props='{"title":"A year of activity","subtitle":"Each square is one day, darker means more","prefix":"","accent":"#16A34A","background":"#F5F3EE","ink":"#18212B"}'>
</opus-motion>

Compose spec (multi-scene video)

json
{
  "width": 1920,
  "height": 1080,
  "fps": 30,
  "scenes": [
    {
      "motion": "heatmap-calendar",
      "props": {
        "title": "A year of activity",
        "subtitle": "Each square is one day, darker means more",
        "prefix": "",
        "accent": "#16A34A",
        "background": "#F5F3EE",
        "ink": "#18212B"
      }
    }
  ]
}

Heatmap calendar props

25 parameters — change any of them to make the motion yours.

PropDefaultWhat it does
values[]one number per day, up to 371 (empty = seeded sample year)
sampleSeed7seed for the sample data used when values is empty
startDate"2025-01-01"date of the first value, "YYYY-MM-DD" (drives month labels and weekday alignment)
weekStart"sun""sun" or "mon": which weekday is the top row
layout"auto""auto" (strip in 16:9, mini months in 1:1 / 9:16), "strip" or "months"
levels5number of shades including empty (3-8)
title"A year of activity"headline (empty = none)
subtitle"Each square is one day, darker means more"small line under the headline (empty = none)
prefix""text before total and best-day numbers
suffix""text after total and best-day numbers, e.g. " commits"
totalLabel"Total contributions"caption under the total
bestLabel"Best day"caption under the best-day value
activeLabel"Active days"caption under the active-days count
lessLabel"Less"legend text at the light end
moreLabel"More"legend text at the dark end
showStatstrueshow the three count-up stats
showLegendtrueshow the less / more legend
showWeekdaystrueshow Mon / Wed / Fri labels (strip layout)
accent"#16A34A"colour of the busiest days
emptyOpacity0.09opacity of days with a zero value
background"#F5F3EE"page colour, or "transparent" to sit over other content
ink"#18212B"text and empty-day colour
fontFamily""CSS font family (empty = Space Grotesk)
startAt8frame the first square appears
speed1animation speed multiplier

Notes & credits

Technique sources:

  • original round-3 chart motion