# Application Calendar and Scheduling: Team Availability Heatmap

Week by hour heat grid of team overlap with day columns, a ring highlighted best slot, density legend, and a propose time callout.

- Page: https://www.shadcn-ui-blocks.com/blocks/application-pro/calendar-scheduling/team-availability-heatmap
- Collection: [Application](https://www.shadcn-ui-blocks.com/blocks/application-pro), Standard tier
- Group: [Calendar and Scheduling](https://www.shadcn-ui-blocks.com/blocks/application-pro/calendar-scheduling)
- Created: 2026-07-04
- Preview image: https://www.shadcn-ui-blocks.com/blocks/application-pro/calendar-scheduling/team-availability-heatmap.png

## Install

```bash
npx shadcn@latest add @shadcn-ui-blocks/application-pro-calendar-scheduling-team-availability-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: badge, button
- Installs to: `@/components/blocks/application-pro/calendar-scheduling/team-availability-heatmap`

## About this block

Team Availability Heatmap is the overlap grid for the
platform team, week of Jun 22 to 26, showing how many of
6 people are free in each slot from 9:00 am to 4:00 pm.
Cells darken as more teammates are free, a legend runs
from 0 free to 6 free, and the single full overlap slot,
Tuesday Jun 23 at 10:00 am, is ring highlighted in the
grid and repeated in a callout as the only slot this week
where all 6 people are free, paired with Propose this
time. A footer note explains free and busy state comes
from each connected calendar in the team timezone (UTC+1).

Rows are one array of hourly counts, and a level helper
maps each count to a foreground opacity step so the shade
scales with the number free. A best slot constant drives
both the in-grid ring and the callout, so a recomputed
peak moves both at once.

## When to use

Reach for this block when an organiser is hunting for the
one hour a whole team can meet. Derive the counts from
your connected calendars, wire Propose this time to your
invite draft, and set the best slot from the densest cell.

A natural flow around it on an Application Pro page:

**Before**

- [Teams orgs](https://www.shadcn-ui-blocks.com/blocks/application-pro/teams-orgs)
- [Calendar shell](https://www.shadcn-ui-blocks.com/blocks/application-pro/app-shells)

**After**

- [Meeting poll panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/calendar-scheduling)
- [Notifications](https://www.shadcn-ui-blocks.com/blocks/application-pro/notifications)

## What you can display

One strong use is the team meeting overlap finder. Other
team availability heatmap uses:

- **Coverage grid.** Read the shades as staffing depth
  across a support week instead of meeting overlap.
- **Booking demand.** Flip the meaning so darker cells
  mark the busiest slots to avoid.
- **Usage heatmap.** Reuse the grid for room or resource
  utilization by day and hour.

> Tip: the ring on the single full overlap slot is the
> whole answer; keep it the one visually loud cell so the
> organiser sees the meeting time at a glance.

## More in Application Calendar and Scheduling

- [Availability Grid](https://www.shadcn-ui-blocks.com/blocks/application-pro/calendar-scheduling/availability-grid)
- [Booking Confirmation Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/calendar-scheduling/booking-confirmation-card)
- [Calendar Sync Status](https://www.shadcn-ui-blocks.com/blocks/application-pro/calendar-scheduling/calendar-sync-status)
- [Event Detail Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/calendar-scheduling/event-detail-panel)
- [Event List Day](https://www.shadcn-ui-blocks.com/blocks/application-pro/calendar-scheduling/event-list-day)
- [Invite RSVP Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/calendar-scheduling/invite-rsvp-card)
- [Meeting Poll Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/calendar-scheduling/meeting-poll-panel)
- [Mini Calendar Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/calendar-scheduling/mini-calendar-card)
- [Month Calendar](https://www.shadcn-ui-blocks.com/blocks/application-pro/calendar-scheduling/month-calendar)
- [Recurring Event Form](https://www.shadcn-ui-blocks.com/blocks/application-pro/calendar-scheduling/recurring-event-form)
- [Reschedule Request Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/calendar-scheduling/reschedule-request-panel)
- [Room Booking Timeline](https://www.shadcn-ui-blocks.com/blocks/application-pro/calendar-scheduling/room-booking-timeline)
- [Scheduling Link Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/calendar-scheduling/scheduling-link-card)
- [Timezone Compare Row](https://www.shadcn-ui-blocks.com/blocks/application-pro/calendar-scheduling/timezone-compare-row)
- [Week Agenda](https://www.shadcn-ui-blocks.com/blocks/application-pro/calendar-scheduling/week-agenda)
- [Working Hours Editor](https://www.shadcn-ui-blocks.com/blocks/application-pro/calendar-scheduling/working-hours-editor)
