Heatmap Grid

A production-scale, light + dark Heatmap Grid component. Copy-paste via the CLI; you own the code.

npx lerpa-cli add heatmap-grid

Live preview available in the gallery.

Usage

import { HeatmapGrid } from "@lerpa/ui";

<HeatmapGrid />

Props

Prop	Type	Default
data	HeatmapDay[]	—
weeks	number	—
colorScale	string[]	—
title	string	—
className	string	—
onSelectDay	(day: HeatmapDay) => void	—

Accessibility

Keyboard accessible interactive elements.
Respects prefers-reduced-motion where animated.
Color is never the only signal.

Overview

The Heatmap Grid component is a UI component in Lerpa UI's 1318-item shadcn-compatible registry, built for React 19 and Tailwind CSS v4. It exposes 6 configurable props, documented in the table below. It needs no dependencies beyond Lerpa UI's standard peer set (React, Tailwind, and Framer Motion). Install it once with the CLI and the source is written into your project as a file you own — read it, edit it, or remove it, with no version to lock.

Install options

Add Heatmap Grid with the Lerpa CLI, or with the shadcn CLI pointed at the registry URL — the source is shadcn-compatible, so either tool writes the same file.

# Lerpa CLI
pnpm dlx lerpa-cli add heatmap-grid

# shadcn-compatible
npx shadcn add https://lerpaui.com/r/heatmap-grid.json

Related components

Browse the full component gallery.