shadcn/uiNext.jsCopy-paste Block

Heatmap Calendar Component

A reusable React heatmap calendar built with shadcn/ui and Tailwind CSS. Visualize daily activity, fitness data, business metrics, IoT events, or learning progress with a GitHub-style heatmap.

Live Demo

Multiple usage patterns with live preview and copyable code.

Basic Usage
Core

Calendar heatmap with built-in axis labels (months + weekdays).

Activity
Aug
Oct
Nov
Dec
Jan
Feb
Mar
Apr
May
Jun
Jul
Aug
Less More
Axis Labels
Core

Customize month format and which weekday rows are labeled.

Axis Labels
Aug
Oct
Nov
Dec
Jan
Feb
Mar
Apr
May
Jun
Jul
Aug
Less More
Year Selector
Interactivity

Built-in dropdown to browse full calendar years (Jan–Dec), like GitHub profiles.

Activity
Jan
Feb
Mar
Apr
May
Jun
Jul
Aug
Sep
Oct
Nov
Dec
Less More
Quantile Color Scale
Interactivity

Auto-derive intensity buckets from your data instead of GitHub-shaped cutoffs.

Revenue
Aug
Oct
Nov
Dec
Jan
Feb
Mar
Apr
May
Jun
Jul
Aug
Less More
Legend at Bottom
Core

Move the intensity legend below the heatmap.

Activity
Aug
Oct
Nov
Dec
Jan
Feb
Mar
Apr
May
Jun
Jul
Aug
Less More
Compact
Core

Smaller cells and tighter spacing (axis labels disabled).

Compact View
Less More
Themes
Core

Pick a theme and copy CSS variables (like shadcn themes).

Heatmap (Default)
Aug
Oct
Nov
Dec
Jan
Feb
Mar
Apr
May
Jun
Jul
Aug
Less More
90 Days Range
Core

Shorter time window.

Last 90 Days
May
Jul
Aug
Less More
Fitness / Health
Domains

Daily training minutes.

Training Minutes
Aug
Oct
Nov
Dec
Jan
Feb
Mar
Apr
May
Jun
Jul
Aug
Less More
Business / Sales
Domains

Orders per day.

Orders
Aug
Oct
Nov
Dec
Jan
Feb
Mar
Apr
May
Jun
Jul
Aug
Low High
Customer Support
Domains

Support tickets opened per day.

Support Tickets
Aug
Oct
Nov
Dec
Jan
Feb
Mar
Apr
May
Jun
Jul
Aug
Fewer More
Learning / Education
Domains

Study minutes per day.

Study Time
Aug
Oct
Nov
Dec
Jan
Feb
Mar
Apr
May
Jun
Jul
Aug
Less More

Install & Use

Add it with the shadcn CLI, or copy the component by hand.

shadcn CLI

Installs the component and its shadcn/ui dependencies (card, tooltip) in one step.

Install via shadcn CLIbash
npx shadcn@latest add https://heatmap-shadcn.vercel.app/r/heatmap-calendar.json