# mapbox/supercluster

A very fast geospatial point clustering library for browsers and Node.

Repository: https://github.com/mapbox/supercluster
Canonical: https://ross.abutalabs.com/products/supercluster
Language: JavaScript
License: ISC
License Family: permissive
Topics: clustering, algorithm, computational-geometry, javascript, maps
Last push: 2026-08-10T09:43:43+00:00

## Health v2 (maintenance only)
Score: 86/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 97, release rhythm 65, longevity 100
- inputs: {"age_days": 3918, "days_push": 23, "days_rel": 23, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2352, forks 304 (observed 2026-08-28T04:06:40.444203+00:00)

## What it is
A very fast JavaScript library for clustering large sets of geospatial points (GeoJSON features) for browsers and Node. It powers marker clustering in Mapbox GL JS and supports millions of points efficiently.

## Use cases
- cluster map markers for millions of points
- show aggregated map pins at low zoom levels
- implement click-to-zoom on map clusters
- paginate points inside a map cluster
- generate vector tiles with clustered points
- cluster GeoJSON point data in Node

## When to choose
- you need fast client-side or server-side clustering of large GeoJSON point datasets
- you use Leaflet, Mapbox GL JS, or MapLibre and need marker clustering
- you need cluster drill-down, expansion zoom, or tile output

## When to avoid
- you need clustering of non-point geometries like lines or polygons
- you need heatmaps rather than discrete clusters
- your dataset is tiny and simple marker rendering suffices

## Facets
- artifact type: library
- maturity: stable
- function: geospatial, search-engine, developer-tools
- domain: web-development, data-visualization
- platform: browser, cross-platform
- tags: point-clustering, geojson, maps, leaflet, mapbox-gl-js, spatial-indexing, kd-tree, geospatial, nodejs, javascript

## Member repositories
- mapbox/supercluster (main) score 86

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:40.444203+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:36:52.562622+00:00, confidence not recorded.
  - readme: https://github.com/mapbox/supercluster (fetched 2026-08-28T04:06:40.444203+00:00, sha 4531ca0c68aa)
  - registry_npm: https://registry.npmjs.org/supercluster (fetched 2026-08-29T10:17:30.987404+00:00, sha ba9569018fe2)
- Data as of 2026-08-30T08:39:29.467469+00:00.