Activity heatmap
A contribution-style heatmap of daily activity over 26 weeks, with a diagonal reveal, weekday and month labels, hover/focus tooltips, and a Less-to-More legend.
Preview
Resize it, switch the theme, replay the entrance — or read the source.
Activity
Daily contributions over the last 26 weeks.
562 contributions · last 26 weeks
Installation
Add the block to a project that already uses shadcn/ui.
npx shadcn@latest add https://prequelui.terravidhal.me/r/activity-heatmap.jsonRequires a project that already uses shadcn/ui on React and Tailwind CSS v4. The block is copied into your project as a single file you own and can edit.
Usage
Import the named export and render it with your own data.
Every prop is optional and ships with deterministic demo data, so a bare render shows the block at its default. Pass props to plug in your own data and formatters.
import { ActivityHeatmap } from "@/components/prequel/activity-heatmap/activity-heatmap";
export default function DashboardPage() {
return <ActivityHeatmap />;
}import { ActivityHeatmap } from "@/components/prequel/activity-heatmap/activity-heatmap";
export default function DashboardPage() {
return <ActivityHeatmap />;
}Props
Every prop is optional and ships with demo-data defaults.
| Prop | Type | Description |
|---|---|---|
className | string | Extra classes merged onto the root element. |
title | string | — |
description | string | — |
values | number[][] | 26 weeks × 7 days (Mon–Sun) of daily counts. Defaults to a deterministic demo. |
unitLabel | string | What the counts represent, e.g. "contributions". |
formatCount | (count: number) => string | — |
Accessibility
The rules every PrequelUI block follows, verified against this block's source.
Charts and graphics expose a text summary via role="img" and an aria-label describing the data.
Interactive charts respond to arrow keys, Home and End, and show tooltips on keyboard focus.
Every button carries a visible focus ring so keyboard users can always see where they are.
The block honours prefers-reduced-motion: animations are skipped and content is fully visible.
Live updates run on timers inside effects and pause when the block is off-screen or hovered.