@maplibre/maplibre-react-native

MapLibre React Native

React Native library for creating maps with MapLibre Native for Android & iOS.

This project originated as a fork of rnmapbox, a community-maintained React Native library for building maps with the Mapbox iOS and Android mobile SDKs. The original product supported both Mapbox and MapLibre for some time, but as the MapLibre and Mapbox SDKs have diverged, it has become necessary to separate the projects into specific wrappers by underlying renderer.

Documentation

https://maplibre.org/maplibre-react-native/

Contributing & Development

Read the CONTRIBUTING guide in order to get familiar with how we do things around here and set up your local development environment.

Community

Join the #maplibre-react-native or #maplibre on the Open Street Map Slack.

Changelog

10.0.1 (2025-01-21)

Bug Fixes

• plugin remove obsolete gradle.properties (#621) (31bf300)

For upgrading review the v10 migration guide.

Bug Fixes

• VectorSource onPress returning null geometry on Android (250ee6f), closes #538
• VectorSource onPress returning null geometry on Android (a130786), closes #538
• add @babel/plugin-transform-private-methods for jest (3a2188f)
• add generic expo config plugin to remove duplicate signature (#453) (2671381)
• added GeometryCollection to GeoJSONUtils (#556) (e6b7a66)
• allow MapView and Images to have no children (#521) (1e35bf6)
• allow resetting contentInset with 0 (#468) (1fe42c6)
• android example crashing on launch (#372) (aeef5c3)
• cleanup yarn setup (#463) (d9a4d30)
• corepack enable on publish workflow (2d13f33)
• correct types in MapView (#268) (0ea35c4)
• disable code signing for release builds (b3cf088)
• disable library code signing (22030dd)
• empty pbxproj and dwarf-with-dsym plugin config for EAS (#458) (0d54b46)
• expo-app should load library from workspace:. (016b44a)
• export custom header methods (#552) (58abdb0), closes #551
• group dependabot commits by core, dev and example (#165) (b697978)
• keep ts-ignore for headingIcon in library #476 (#477) (ef62454)
• make follow props on Camera deterministic (#550) (e9256e7)
• make MarkerView props with defaults optional (#460) (185cf3e)
• plugin for debug simulator (#164) (06b23d4)
• remove AbortController test mock (#403) (698b558)
• round compass margins and attribution position to nearest integers [android] (#294) (c89c842)
• setMaxAnimationFps on null (#440) (2884256)
• style expressions (#466) (2202908)
• trigger release after npm maintenance (#548) (f0fca00)
• types of getPointInView and getCoordinateFromView (#601) (c7537b5)
• updated Mapbox callstack check for iOS custom headers to check for MapLibre instead (#461) (a6d6216)
• use UIManager exported from react-native (#511) (a4030b5)
• yarn implementation (#419) (39233b1)

Continuous Integration

• add semantic release (#526) (069b6c5)

Features

• add Expo plugin props (#589) (51fbb00)
• align react and react-native versions for development (b92abfe)
• allow using google location engine on Android (#586) (92ffdb7)
• configure packages/examples (c4510c3)
• drop MapLibreGL naming and deprecate export default (#567) (aa0c73d)
• export RegionPayload and MapLibreRNEvent types (#544) (b342f1b)
• extract android UserLocation FPS (#428) (8c0abaa)
• make setAccessToken(null) obsolete (#593) (df44b48)
• make Camera pure (#471) (23ecf88)
• MapLibre Android SDK 11.5.0 (#455) (042b759)
• monorepo configuration (343e7ac)
• mv example packages/react-native-app (5c9d3d0)
• mv examples, styles, assets, utils and scenes to packages/examples (13600fe)
• packages/expo-app (c01abd5)
• remove deprecations (#543) (0c41ada)
• remove duplicate of OfflinePackStatus type (#542) (9e231b7)
• remove Style component (#547) (9d4c458)
• remove style property enums (#558) (b89a0dd)
• setup build step (#504) (a017d64)
• shared dependencies through packages/examples (01a9586)
• support new arch through interop layer (#483) (951e9cf)
• unify MapViews styleURL and styleJSON to mapStyle (#559) (7d22f16)
• update maplibre native version (#61) (25c418a)
• upgrade turf to v7 and remove geo utils (#478) (a45fc55)
• upgrade Android gradle setup (#539) (761ae0d)
• upgrade dependencies (#535) (047f87f)
• upgrade MapLibre Native (#563) (d2b7f5d)
• upgrade MapLibre Native Android to v11.8.0 (#597) (410d0c3)
• upgrade MapLibre Native iOS to v6.10.0 (#598) (b596c76)
• use withPodfile instead of withDangerousMod in Expo Plugin (#587) (56d02e1)

BREAKING CHANGES

• remove styleURL and styleJSON from MapView, use mapStyle instead
• remove style property enums
• remove Style component, use styleJSON of MapView instead
• deprecate UserTrackingModes is removed in favor of UserTrackingMode
• remove deprecated setCamera from MapView
• remove deprecated byId methods from ShapeSource
• remove deprecated children from SymbolSource
• remove deprecated assets key from Images
• remove deprecated event keys
• replace OfflineProgressStatus with OfflinePackStatus
• upgrade native packages and migrate components
• changes to Camera component
  • Remove allowUpdates prop
  • Remove triggerKey prop
  • Set default animationMode for controlled Camera to CameraMode.None