Calendar chart

A count per day over a year, a square per day in weeks across: uploads, casts, alarms.

Uploads

402 files uploaded over a year: weekdays only, busier from March to October, quiet over Christmas and the first three weeks of July.

Medium

Usage

<CalendarChart
	data={[{ date: '2026-03-02', value: 4 }, { date: '2026-03-03', value: 1 }]}
	valueLabel="Uploads"
	levels={[1, 2, 4, 7]}
/>

Rules

  • For rhythm and gaps, not values: the weeks a buoy was quiet, the season a project ran. A value someone needs to read belongs in a bar or a table.
  • Every day is drawn, the empty ones too. Weeks run across, Monday on top.
  • Five levels, the first one empty. The key names each level exactly (0, 1, 2–3), not "less" and "more".
  • Pass levels when the numbers mean something (one upload a day is normal, seven is a backlog). Otherwise they are quarters of the busiest day.
  • One colour, faded. A second colour for a second kind of count is a second calendar.