Skip to content

v1.5 • Data • 7kb gzipped • MIT

HeatGrid

Canvas heatmaps for dense matrices, with colour scales that survive an accessibility review.

★ 1.8kGitHub
↓ 7.2k / week● MIT● TS 5.0+
heatgrid-preview.png
Abstract preview graphic for HeatGrid

// why heatgrid

Colour that carries meaning

Ships perceptually uniform scales and checks them against colour-vision deficiency simulations before you ship a dashboard.

● 16ms render● 60fps● 0 deps

// stack

Dense by design

Renders a quarter of a million cells without dropping a frame, because every cell is a rectangle and nothing is a DOM node.

HeatGrid started as a single file in a client project and stayed small on purpose. It does one job, it does it in 7kb gzipped, and it has no runtime dependencies.

Getting started

Install it, import it, call it:

npm i heatgrid-js

Ships perceptually uniform scales and checks them against colour-vision deficiency simulations before you ship a dashboard.

What it does not do

It does not manage your state, style your components or ship a plugin system. Those are your decisions, and keeping them out is what keeps the bundle honest.

  • Perceptual colour scales
  • Cell-level hit testing
  • MIT licensed, commercially friendly

Features

Perceptual colour scales

Uniform in lightness, so a step in value looks like a step in colour.

Cell-level hit testing

Hover and focus resolve to the exact cell without a spatial index you have to maintain.

Six themes

Token-driven, so bringing your own palette is a single object.

ESM and types

Ships module and CommonJS builds with hand-written type definitions and source maps.

Off the main thread

Heavy work moves to a worker automatically when one is available.

Accessible output

Every visual is paired with a text alternative that reflects the same data.

Get HeatGrid v1.5

9 files • .min.js 7kb • .zip 30kb • sha384 verified

Changelog

v1.5 May 23 2026 • latest
  • Two new perceptual scales
  • Hit testing rewritten as direct arithmetic
  • Legend renders on the same canvas
v1.4.2 Apr 16 2026
  • Safari 16 compatibility fixes
  • Bundle size reduced by eleven percent
v1.4.1 Jan 20 2026
  • Improved error messages for invalid options
  • Added twenty regression tests
View full archive →

// related

Related products

Sep 10 • v2.0

ChartForge

Canvas charts in twelve lines. Responsive, accessible and dark-mode ready, with no D3 learning curve.

View →
Aug 30 • v3.2.1

MotionEase

Physics-based micro-animations with a single call. Spring curves that feel right without a tuning session.

View →
Aug 19 • v1.9.4

FormFlow

Validation and multi-step logic that works the same in React, Vue and vanilla. Your markup stays yours.

View →

Ship the dashboard today.

MIT licensed. Commercial friendly. Five-minute setup.