# DKirwan/calendar-heatmap

A d3 heatmap for representing time series data similar to github's contribution chart

Repository: https://github.com/DKirwan/calendar-heatmap
Canonical: https://ross.abutalabs.com/products/calendar-heatmap
Language: TypeScript
License: MIT
License Family: permissive
Topics: heatmap, d3, javascript, data-visualization
Last push: 2026-02-09T23:27:46+00:00

## Health v2 (maintenance only)
Score: 71/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 66, release rhythm 60, longevity 100
- inputs: {"age_days": 3851, "days_push": 205, "days_rel": 219, "gap_med": 0, "n_releases_24m": 2}
- flags: prerelease_only
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2036, forks 139 (observed 2026-08-28T04:06:08.009777+00:00)

## What it is
A reusable D3.js calendar heatmap component for visualizing daily time series data, styled after GitHub's contribution chart. It is configurable via options like cell size, colors, legend, tooltips, and accessibility features, and is distributed as an npm package.

## Use cases
- visualize daily activity counts like GitHub contributions
- render a year-long calendar heatmap in a web app
- show time series data as a color-coded calendar grid
- add an accessible calendar heatmap with tooltips and click handlers
- display user streaks or daily metrics in a dashboard

## When to choose
- you need a GitHub-style contribution heatmap in a D3-based frontend
- you want a configurable, lightweight calendar heatmap with accessibility support
- your data is daily-granularity date/count pairs

## When to avoid
- you need actively maintained software with guaranteed bug fixes
- you need sub-daily or hourly granularity
- you are not using D3 or a DOM-based rendering environment

## Facets
- artifact type: library
- maturity: maintenance
- function: data-visualization, charts
- domain: data-visualization, frontend, web-development
- platform: browser
- tags: d3, heatmap, calendar-heatmap, github-contribution-chart, time-series, typescript, unmaintained, nodejs, javascript

## Member repositories
- DKirwan/calendar-heatmap (main) score 71

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:08.009777+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:59:18.233864+00:00, confidence not recorded.
  - readme: https://github.com/DKirwan/calendar-heatmap (fetched 2026-08-28T04:06:08.009777+00:00, sha 5b97093e49d4)
- Data as of 2026-08-30T08:39:29.467469+00:00.