finds.dev

tomekvenits/react-native-map-clustering

React Native map clustering both for Android and iOS.

View on GitHub

★ 749JavaScriptMITupdated Jul 2025

// the take

A drop-in replacement for react-native-maps' MapView that adds marker clustering via supercluster. You swap in this MapView, keep your existing Marker children, and get cluster bubbles with count labels and spiral expansion for overlapping markers. Targets React Native developers who need clustering without wiring up supercluster manually.

- Dead simple API — same interface as react-native-maps MapView, so adoption is almost zero friction for existing codebases

- Exposes superClusterRef for direct access to the underlying supercluster instance, which means you can do custom queries (e.g. getLeaves, getClusters) without fighting the abstraction

- renderCluster prop lets you replace the default cluster bubble entirely with your own component, so custom designs don't require forking

- Spiral/spider view for overlapping markers is a nice touch that most homegrown clustering implementations skip

- Animation only works on iOS — Android gets nothing, and this is a known gap that hasn't been addressed despite the library being around for years

- Single file implementation (lib/ClusteredMapView.js) with no tests at all — any edge case in region change handling or marker reconciliation is on you to discover

- TypeScript types are in a hand-maintained index.d.ts that lags the actual props; you'll hit runtime surprises that the types don't warn you about

- No support for dynamic marker updates without remounting — adding or removing markers after initial render has historically caused clustering state bugs, and the README doesn't address it

We read the README, the directory tree and a key source file in June 2026. Nobody pays to be listed. How we judge →

// at a glance

Stars
749
Forks
247
Language
JavaScript
License
MIT
Last commit
23 Jul 2025

// nearby

If react-native-map-clustering isn't quite it.

All repos →