# Application Activity: Activity Heatmap

Weekday by hour heatmap of workspace events with intensity cells, a Less to More legend, and peak and quiet window callouts.

- Page: https://www.shadcn-ui-blocks.com/blocks/application-pro/activity/activity-heatmap
- Collection: [Application](https://www.shadcn-ui-blocks.com/blocks/application-pro), Standard tier
- Group: [Activity](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity)
- Created: 2026-07-04
- Preview image: https://www.shadcn-ui-blocks.com/blocks/application-pro/activity/activity-heatmap.png

## Install

```bash
npx shadcn@latest add @shadcn-ui-blocks/application-pro-activity-activity-heatmap
```

Needs an API key from a Pro or Team plan: add `@shadcn-ui-blocks` to the registries in components.json with the key as an `Authorization: Bearer` header. Setup: https://www.shadcn-ui-blocks.com/docs/shadcn-cli. The MCP server installs it without the setup: https://www.shadcn-ui-blocks.com/docs/mcp.

## Depends on

- npm packages: class-variance-authority, lucide-react, radix-ui
- shadcn/ui components: button
- Installs to: `@/components/blocks/application-pro/activity/activity-heatmap`

## About this block

Activity Heatmap is the when-is-the-workspace-busy
view: weekday rows read against twelve hour columns
where each cell's intensity shows how much happened in
that window, with a Less to More legend and callout
rows naming the peak and quietest stretches. Cells are
plain divs stepped through foreground opacity, so the
grid needs no chart library and reads cleanly in both
themes.

Each day is one row with a levels array, and every
value indexes a foreground opacity class from
bg-foreground/5 up to bg-foreground/80. The hour label
array marks every third column, the two window callouts
summarize the peak and quiet times, and the footer
states the event count the grid was built from.

## When to use

Reach for this block on a workspace analytics or admin
overview page, wired to your events grouped by weekday
and hour. The Last 30 days button drives the range, and
the window callouts should recompute from the same
buckets.

A natural flow around it on an Application Pro page:

**Before**

- [App shell](https://www.shadcn-ui-blocks.com/blocks/application-pro/app-shells)
- [Kpi cards row](https://www.shadcn-ui-blocks.com/blocks/application-pro/stat-cards)

**After**

- [Activity calendar](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity)
- [Reports](https://www.shadcn-ui-blocks.com/blocks/application-pro/reports)

## What you can display

One strong use is the workspace activity rhythm. Other
heatmap reads:

- **Team availability.** The same grid mapped to who is
  online, so coverage gaps show at a glance.
- **Support load.** Tickets opened per hour, guiding
  when to staff the queue.
- **Deploy windows.** Quiet cells marked as the safe
  hours for releases.

> Tip: the two callouts do the interpreting; a heatmap
> shows the shape, the peak and quiet lines say what to
> do about it.

## More in Application Activity

- [Activity Calendar](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity/activity-calendar)
- [Approvals Queue](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity/approvals-queue)
- [Audit Export Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity/audit-export-card)
- [Audit Trail Timeline](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity/audit-trail-timeline)
- [Automation Run Log](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity/automation-run-log)
- [Catch Up Digest](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity/catch-up-digest)
- [Changelog Feed](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity/changelog-feed)
- [Comment Mentions List](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity/comment-mentions-list)
- [Comment Thread Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity/comment-thread-panel)
- [Deploy Activity Feed](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity/deploy-activity-feed)
- [Edit History Diff](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity/edit-history-diff)
- [Filtered Activity Log](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity/filtered-activity-log)
- [Inactivity Watch Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity/inactivity-watch-card)
- [Live Presence Bar](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity/live-presence-bar)
- [Member Activity Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity/member-activity-panel)
- [Mention Feed](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity/mention-feed)
- [Pinned Updates Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity/pinned-updates-card)
- [Project Activity Breakdown](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity/project-activity-breakdown)
- [Reaction Activity Feed](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity/reaction-activity-feed)
- [Sign In Activity List](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity/sign-in-activity-list)
- [Status Change Log](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity/status-change-log)
- [Team Activity Feed](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity/team-activity-feed)
- [Team Pulse Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity/team-pulse-card)
- [Version History List](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity/version-history-list)
- [Who Did What Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity/who-did-what-table)
