Features · type

Calendar heatmap

native

Days laid out as a calendar grid

Matrix status native. Verification types · strong. ChartKit option: ChartKitChartSpecV1.mark.layout=calendar.

Cells stay square, or at most 1.5:1, and cap at 32px. Extra width centres the grid. The last week includes the latest day. Unsized calendars stay at 12px.

Source: chartkit:packages/core/src/generated/schema.ts:2165

ChartKit spec

Passed validate() during npm run matrix:refresh. The SVG is the server render.

Activity peaked on January 2.Activity peaked on January 2.JanFebMarAprMayJunJulAugSepOctNovDecJanMonWedFri2025-01-05: 02025-01-06: 02025-01-07: 02025-01-08: 02025-01-09: 02025-01-10: 02025-01-11: 02025-01-12: 02025-01-13: 02025-01-14: 02025-01-15: 02025-01-16: 02025-01-17: 02025-01-18: 02025-01-19: 02025-01-20: 02025-01-21: 02025-01-22: 02025-01-23: 02025-01-24: 02025-01-25: 02025-01-26: 02025-01-27: 02025-01-28: 02025-01-29: 02025-01-30: 02025-01-31: 02025-02-01: 02025-02-02: 02025-02-03: 02025-02-04: 02025-02-05: 02025-02-06: 02025-02-07: 02025-02-08: 02025-02-09: 02025-02-10: 02025-02-11: 02025-02-12: 02025-02-13: 02025-02-14: 02025-02-15: 02025-02-16: 02025-02-17: 02025-02-18: 02025-02-19: 02025-02-20: 02025-02-21: 02025-02-22: 02025-02-23: 02025-02-24: 02025-02-25: 02025-02-26: 02025-02-27: 02025-02-28: 02025-03-01: 02025-03-02: 02025-03-03: 02025-03-04: 02025-03-05: 02025-03-06: 02025-03-07: 02025-03-08: 02025-03-09: 02025-03-10: 02025-03-11: 02025-03-12: 02025-03-13: 02025-03-14: 02025-03-15: 02025-03-16: 02025-03-17: 02025-03-18: 02025-03-19: 02025-03-20: 02025-03-21: 02025-03-22: 02025-03-23: 02025-03-24: 02025-03-25: 02025-03-26: 02025-03-27: 02025-03-28: 02025-03-29: 02025-03-30: 02025-03-31: 02025-04-01: 02025-04-02: 02025-04-03: 02025-04-04: 02025-04-05: 02025-04-06: 02025-04-07: 02025-04-08: 02025-04-09: 02025-04-10: 02025-04-11: 02025-04-12: 02025-04-13: 02025-04-14: 02025-04-15: 02025-04-16: 02025-04-17: 02025-04-18: 02025-04-19: 02025-04-20: 02025-04-21: 02025-04-22: 02025-04-23: 02025-04-24: 02025-04-25: 02025-04-26: 02025-04-27: 02025-04-28: 02025-04-29: 02025-04-30: 02025-05-01: 02025-05-02: 02025-05-03: 02025-05-04: 02025-05-05: 02025-05-06: 02025-05-07: 02025-05-08: 02025-05-09: 02025-05-10: 02025-05-11: 02025-05-12: 02025-05-13: 02025-05-14: 02025-05-15: 02025-05-16: 02025-05-17: 02025-05-18: 02025-05-19: 02025-05-20: 02025-05-21: 02025-05-22: 02025-05-23: 02025-05-24: 02025-05-25: 02025-05-26: 02025-05-27: 02025-05-28: 02025-05-29: 02025-05-30: 02025-05-31: 02025-06-01: 02025-06-02: 02025-06-03: 02025-06-04: 02025-06-05: 02025-06-06: 02025-06-07: 02025-06-08: 02025-06-09: 02025-06-10: 02025-06-11: 02025-06-12: 02025-06-13: 02025-06-14: 02025-06-15: 02025-06-16: 02025-06-17: 02025-06-18: 02025-06-19: 02025-06-20: 02025-06-21: 02025-06-22: 02025-06-23: 02025-06-24: 02025-06-25: 02025-06-26: 02025-06-27: 02025-06-28: 02025-06-29: 02025-06-30: 02025-07-01: 02025-07-02: 02025-07-03: 02025-07-04: 02025-07-05: 02025-07-06: 02025-07-07: 02025-07-08: 02025-07-09: 02025-07-10: 02025-07-11: 02025-07-12: 02025-07-13: 02025-07-14: 02025-07-15: 02025-07-16: 02025-07-17: 02025-07-18: 02025-07-19: 02025-07-20: 02025-07-21: 02025-07-22: 02025-07-23: 02025-07-24: 02025-07-25: 02025-07-26: 02025-07-27: 02025-07-28: 02025-07-29: 02025-07-30: 02025-07-31: 02025-08-01: 02025-08-02: 02025-08-03: 02025-08-04: 02025-08-05: 02025-08-06: 02025-08-07: 02025-08-08: 02025-08-09: 02025-08-10: 02025-08-11: 02025-08-12: 02025-08-13: 02025-08-14: 02025-08-15: 02025-08-16: 02025-08-17: 02025-08-18: 02025-08-19: 02025-08-20: 02025-08-21: 02025-08-22: 02025-08-23: 02025-08-24: 02025-08-25: 02025-08-26: 02025-08-27: 02025-08-28: 02025-08-29: 02025-08-30: 02025-08-31: 02025-09-01: 02025-09-02: 02025-09-03: 02025-09-04: 02025-09-05: 02025-09-06: 02025-09-07: 02025-09-08: 02025-09-09: 02025-09-10: 02025-09-11: 02025-09-12: 02025-09-13: 02025-09-14: 02025-09-15: 02025-09-16: 02025-09-17: 02025-09-18: 02025-09-19: 02025-09-20: 02025-09-21: 02025-09-22: 02025-09-23: 02025-09-24: 02025-09-25: 02025-09-26: 02025-09-27: 02025-09-28: 02025-09-29: 02025-09-30: 02025-10-01: 02025-10-02: 02025-10-03: 02025-10-04: 02025-10-05: 02025-10-06: 02025-10-07: 02025-10-08: 02025-10-09: 02025-10-10: 02025-10-11: 02025-10-12: 02025-10-13: 02025-10-14: 02025-10-15: 02025-10-16: 02025-10-17: 02025-10-18: 02025-10-19: 02025-10-20: 02025-10-21: 02025-10-22: 02025-10-23: 02025-10-24: 02025-10-25: 02025-10-26: 02025-10-27: 02025-10-28: 02025-10-29: 02025-10-30: 02025-10-31: 02025-11-01: 02025-11-02: 02025-11-03: 02025-11-04: 02025-11-05: 02025-11-06: 02025-11-07: 02025-11-08: 02025-11-09: 02025-11-10: 02025-11-11: 02025-11-12: 02025-11-13: 02025-11-14: 02025-11-15: 02025-11-16: 02025-11-17: 02025-11-18: 02025-11-19: 02025-11-20: 02025-11-21: 02025-11-22: 02025-11-23: 02025-11-24: 02025-11-25: 02025-11-26: 02025-11-27: 02025-11-28: 02025-11-29: 02025-11-30: 02025-12-01: 02025-12-02: 02025-12-03: 02025-12-04: 02025-12-05: 02025-12-06: 02025-12-07: 02025-12-08: 02025-12-09: 02025-12-10: 02025-12-11: 02025-12-12: 02025-12-13: 02025-12-14: 02025-12-15: 02025-12-16: 02025-12-17: 02025-12-18: 02025-12-19: 02025-12-20: 02025-12-21: 02025-12-22: 02025-12-23: 02025-12-24: 02025-12-25: 02025-12-26: 02025-12-27: 02025-12-28: 02025-12-29: 02025-12-30: 02025-12-31: 02026-01-01: 12026-01-02: 42026-01-03: 2value14
{
  "version": "1",
  "type": "heatmap",
  "data": [
    {
      "date": "2026-01-01",
      "value": 1
    },
    {
      "date": "2026-01-02",
      "value": 4
    },
    {
      "date": "2026-01-03",
      "value": 2
    }
  ],
  "encoding": {
    "x": {
      "field": "date",
      "type": "temporal"
    },
    "color": {
      "field": "value"
    }
  },
  "mark": {
    "layout": "calendar"
  },
  "a11y": {
    "alt": "Activity peaked on January 2."
  },
  "size": {
    "width": 640,
    "height": 260
  }
}

Other libraries

Option names are the paths recorded in the matrix. A grep-only cell names the identifier that matched, not a render test. Markdown copy: type.heatmap.calendar.md.

LibraryStatusOptionVerificationSource
Chart.jsplugin—matrix recipenpm · weak—
Rechartsnone—absence · absence—
Apache EChartsnativecalendarcalendar coordinate + heatmap seriestypes · strongecharts/types/dist/shared.d.ts:12581
Highchartspartialseries.type=heatmapdocumented calendar heatmap demotypes · stronghighcharts/options/abands.d.ts:1386
Plotly.jsmanuallayout.shapesmechanism · weakplot-schema.json#layout.layoutAttributes.shapes
NivonativeCalendar, TimeRangetypes · strong@nivo/calendar/dist/types/Calendar.d.ts:1
Victorynone—absence · absence—
visxmanualGroupmechanism · weak@visx/group/lib/Group.d.ts:15
ApexChartsunknown—unverified · unknown—
Tremor (npm)nativeTrackerday-status strip, not a full calendartypes · strong@tremor/react/dist/index.d.ts:703
Observable Plotnativecellcell with utcWeek/utcDay channels (documented)types · strong@observablehq/plot/src/marks/cell.d.ts:47
Vega-Litenativemark=recttimeUnit day/weektypes · strongvega-lite/build/spec/unit.d.ts:19
AG Chartsunknown—unverified · unknown—
amCharts 5manualGraphicsmechanism · weak@amcharts/amcharts5/.internal/core/render/Graphics.d.ts:162
Google ChartsnativeCalendartypes · strong@types/google.visualization/index.d.ts:1397
uPlotnone—absence · absence—
TradingView Lightweight Chartsnone—absence · absence—
MUI X ChartsmanualChartsContainermechanism · weak@mui/x-charts/ChartsContainer/ChartsContainer.d.mts:34
Mermaid (chart-ish diagrams only)none—absence · absence—
AntV G2manualgrep: registermechanism · weak@antv/g2/lib/exports.d.ts:2