// the find
tomekvenits/react-native-map-clustering
React Native map clustering both for Android and iOS.
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