Skip to main content
Clever Ops

Stats Activity Grid

Contribution-style React activity heatmap, a dependency-free Tailwind grid of cells stepped through primary opacities, with mono axis labels and an honest text summary.

Preview & code

Loading Stats Activity Grid preview

Installation

pnpm dlx shadcn@latest add @cleverui/stats-activity-grid

Requires the @cleverui registry in your components.json, a one-off, two-line setup.

Usage

tsx
import { StatsActivityGrid } from '@/components/blocks/stats-activity-grid'
Exampletsx
import { StatsActivityGrid } from '@/components/blocks/stats-activity-grid'

/** Deterministic 26-week deploy field, no Date/random in render */
function buildDeployField(): number[] {
  const weeks = 26
  const out: number[] = []
  for (let w = 0; w < weeks; w++) {
    for (let d = 0; d < 7; d++) {
      // Weekends quiet; midweek denser; gentle ramp into later quarters
      if (d === 0 || d === 6) {
        out.push(w % 6 === 2 ? 1 + (w % 3) : 0)
        continue
      }
      const base = ((w * 5 + d * 3) % 11) + Math.floor(w / 4)
      const spike = w === 18 && d === 2 ? 18 : 0
      out.push(base + spike)
    }
  }
  return out
}

const VALUES = buildDeployField()

const COLUMN_LABELS = [
  'Feb',
  '',
  '',
  '',
  'Mar',
  '',
  '',
  '',
  'Apr',
  '',
  '',
  '',
  'May',
  '',
  '',
  '',
  'Jun',
  '',
  '',
  '',
  'Jul',
  '',
  '',
  '',
  'Aug',
  '',
]

export default function StatsActivityGridDemo() {
  return (
    <div className="mx-auto max-w-6xl">
      <StatsActivityGrid
        heading="Deploys, last six months"
        total="1,284 deploys across 26 weeks"
        values={VALUES}
        columnLabels={COLUMN_LABELS}
        rowLabels={['Mon', 'Wed', 'Fri']}
        legendLow="Less"
        legendHigh="More"
      />
    </div>
  )
}

API reference

StatsActivityGrid accepts the following props.

PropTypeDefaultDescription
headingstring'Deploys, last six months'
values*number[]one sample per cell, column-major in columns of 7 (weeks of days)
totalstringpreformatted headline figure set as a mono caption
columnLabelsstring[]sparse mono labels under columns; empty strings render no label
rowLabelsstring[][...DEFAULT_ROW_LABELS]mono labels beside rows 1, 3, and 5
legendLowstring'Less'
legendHighstring'More'

…plus everything from React.HTMLAttributes<HTMLElement>: className, event handlers, aria attributes and the rest pass straight through.

Frequently asked questions

How do I install the Stats Activity Grid component?

Register the @cleverui registry in your components.json ("@cleverui": "https://cleverops.com.au/r/{name}.json"), then run `npx shadcn@latest add @cleverui/stats-activity-grid`. The shadcn CLI copies the source into your project, you own the code from that point. You can also copy the source directly from this page.

What dependencies does Stats Activity Grid require?

Stats Activity Grid uses motion on top of React and Tailwind CSS. You don't need to install it manually, the shadcn CLI resolves and installs npm dependencies automatically when you add the component.

Can I theme Stats Activity Grid to match my brand?

Yes. The component is styled entirely with Tailwind utilities over standard design tokens (primary, background, muted, border), so it inherits your existing shadcn/ui theme automatically. Change your CSS variables and the component follows, no source edits needed for palette, radius, or fonts.

Want this built for you?

CleverUI is built by the Clever Ops web team. If you'd rather ship a hand-coded, fast, custom website than assemble one, we build them for Australian businesses every week.

Explore web development services