Overview Button Copy button Field Input Number field Textarea Select Combobox Multiselect Date picker Date range picker Date-time picker Checkbox Radio group Position picker Switch Slider Dropzone Device controls Avatar Badge Card Collapsible Kbd Map Matrix Proportion bar Separator Stat Table Timeline Chat Playback Pagination Charts Chart theming Profile chart Time series chart Bar chart Isopleth chart TS diagram Box plot Rose chart Calendar chart Banner Toast Loader Progress Skeleton Empty state Error state Dropdown menu Tooltip Info tooltip Dialog Sheet Resizable Confirm dialog Breadcrumbs Command palette Mobile menu Navigation list Outline Scroll rail Sidebar Tabs
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.