# Activity cell heatmap

https://fieldbook.lizardi.mx/components/activity-cell-heatmap

Category: Charts
![Still of the Activity cell heatmap component, a Fieldbook UI component in Charts.](https://fieldbook.lizardi.mx/thumbs/activity-cell-heatmap.webp)
Preview video: https://ejpqcxcjbiyabxkx.public.blob.vercel-storage.com/previews/activity-cell-heatmap-af47222212.mp4 (5 s, silent)

Activity cell heatmap: A calendar grid of small tinted squares that sweeps in on a diagonal wave and lets a level strip isolate one intensity at a time.

## Frameworks

react, vue, svelte, astro, html

## Preview controls

These controls are passed to the demo. Defaults and limits describe the preview; consult the implementation for its full prop API.

| Name | Type | Default | Options or constraints |
| --- | --- | --- | --- |
| accent | color | #9BE15D | No additional limit in the metadata. |
| weeks | number | 30 | From 12 to 53; step 1 |
| gap | number | 2 | From 1 to 6; step 1 |
| cornerRadius | number | 2 | From 0 to 6; step 1 |
| weekStart | select | sunday | Options: sunday, monday |
| interactive | boolean | true | No additional limit in the metadata. |

## Usage notes

Use this calendar heatmap to explore a compact activity display with five intensity levels and a shared color legend.

Activity cell heatmap uses the wide preview frame with a light/dark theme setting.

Change the number of weeks and the start of the week to compare dashboard layouts. Hover or focus a day to inspect its readout when interaction is enabled.

This implementation generates deterministic sample activity around a fixed date. Connect real data and update the date model before presenting it as a live activity report.

### Which frameworks are available for Activity cell heatmap?

Activity cell heatmap is available for React, Vue, Svelte, Astro, HTML. The live preview uses React; the source observations below apply to index.tsx. Check the selected port before relying on the same interactions.

### What does Activity cell heatmap depend on?

The React metadata lists these npm dependencies beyond React: motion, clsx, tailwind-merge.

### What accessibility details are visible in Activity cell heatmap?

The React source for Activity cell heatmap includes: native elements (button); attributes and handlers (aria-hidden, aria-label, onKeyDown, tabIndex); key comparisons (ArrowDown, ArrowLeft, ArrowRight, ArrowUp). These are source observations. Verify accessible names, focus order and keyboard behavior in the composed page.

### How does Activity cell heatmap handle reduced motion?

Activity cell heatmap reads the motion preference in its React source through useReducedMotion(). Preference-dependent expressions in index.tsx: duration: reduce ? 0 : 0.12; isActive &amp;&amp; !reduce ? "scale(1.26)" : "scale(1)"; transitionDelay: !reduce &amp;&amp; ready &amp;&amp; !revealed ? \`$\{((cell.col + cell.row) \* stepMs).toFixed(0)\}ms\` : "0ms". Check the full implementation, shared styles and selected port with reduced motion enabled; these observations do not establish that every animation stops.

## Install through MCP

Connect your client, call get_component to retrieve the implementation, then get_install_command for installation instructions. Choose a listed framework, integrate the returned source and verify it in your application.

```json
{
  "tool": "get_component",
  "arguments": {
    "slug": "activity-cell-heatmap",
    "framework": "react"
  }
}
```

[For agents](https://fieldbook.lizardi.mx/docs/agents)
[MCP](https://fieldbook.lizardi.mx/api/mcp)

## Related open components

- [Spoke area chart](https://fieldbook.lizardi.mx/components/spoke-area-chart)
- [Vertex Dot Radar](https://fieldbook.lizardi.mx/components/vertex-dot-radar-chart)
- [Animated Time Axis](https://fieldbook.lizardi.mx/components/animated-time-axis)
- [Area chart lite](https://fieldbook.lizardi.mx/components/area-chart-lite)
- [Candle Price Chart](https://fieldbook.lizardi.mx/components/candle-price-chart)
- [Concentric Ring Chart](https://fieldbook.lizardi.mx/components/concentric-ring-chart)
