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.

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.
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
titlesubtitleprefix- Colour props
accentbackgroundink- Mood
- hud
- Roles
- accent, subject
Use Heatmap calendar in Remotion, React or HTML
Remotion project
# 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
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
<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)
{
"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.
| Prop | Default | What it does |
|---|---|---|
values | [] | one number per day, up to 371 (empty = seeded sample year) |
sampleSeed | 7 | seed 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" |
levels | 5 | number 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 |
showStats | true | show the three count-up stats |
showLegend | true | show the less / more legend |
showWeekdays | true | show Mon / Wed / Fri labels (strip layout) |
accent | "#16A34A" | colour of the busiest days |
emptyOpacity | 0.09 | opacity 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) |
startAt | 8 | frame the first square appears |
speed | 1 | animation speed multiplier |
Related motions

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
Bubble scatter grow
Three-variable comparisons: markets by size, growth and margin, countries, products, campaigns, startups. Pass points as [{label, x, y,…
bubble-scatter-grow
Comparison dumbbell
Change between two states per item: before vs after, last year vs this year, plan vs actual, men vs women, A vs B, scores pre- and…
comparison-dumbbell
Donut breakdown
Share-of-total stories on any brand: revenue by channel, budget split, traffic sources, survey answers, market share. Replace data,…
donut-breakdown
Sankey flow
Where things go: traffic to conversions, budget to departments, energy or cash flows, funnels with leaks, user journeys. Pass links as…
sankey-flow
Treemap split
Part-to-whole with many items: portfolio or budget breakdowns, disk usage, market caps, revenue by product, survey categories, file sizes.…
treemap-split
Notes & credits
Technique sources:
- original round-3 chart motion