Skip to main content
Version: 6.0

Release Notes

Mappedin SDK for React Native v6 release notes are posted here and this page will be kept up-to-date as updates are released. The SDK is available from @mappedin/react-native-sdk on NPM.

v6.0.0​

October 01, 2025

Breaking Changes​

⚠️ Blue Dot Moved to Separate Package​

Blue Dot functionality is now exclusively available through @mappedin/blue-dot. The temporary mapView.__BlueDot accessor has been removed.

Migration:

import { MapView } from '@mappedin/react-native-sdk';
import { useBlueDot } from '@mappedin/blue-dot/rn';

function MyComponent() {
  const { enable, isReady } = useBlueDot()
  
  React.useEffect(() => {
    if (isReady) {
      enable();
    }
  }, [isReady]);
}

Bug Fixes​

  • Fixed baseUrl configuration issue where web view was blocking access token retrieval
  • Updated React Native SDK readme

v6.0.0-rc.5​

Breaking Changes​

⚠️ State Management API Update​

Change: getState() and updateState() methods no longer accept entity ID directly as a parameter

Before:

mapView.getState('entity-id-123')
mapView.updateState('entity-id-123', newState)

Now:

const entity = mapView.getById('space', id)
mapView.getState(entity)
mapView.updateState(entity, newState)

Why: Improves API consistency and type safety across the SDK

Bug Fixes​

React Native Web Improvements​

  • Input Focus Issue: Fixed React Native web examples where input fields were losing focus during user interaction
  • State Hydration: updateState() now correctly processes state objects for hydration and deserialization
  • Iframe Serialization: React Native web messaging with iframe now properly serializes/deserializes data, resolving directions.draw functionality

Dependency Management​

  • Fixed peer dependency issue. Now react-native correctly peer depend on the corresponding @mappedin/mappedin-js version. Currently v6.0.0-rc.5

Documentation​

  • React Native & React Integration: Added @mappedin/mappedin-js documentation to React Native and React SDK guides for improved developer experience

v6.0.0-beta.1​

Features​

🔵 React Native SDK now supports useBlueDot hook extension​

import { MapView } from '@mappedin/react-native-sdk';
import { useBlueDot } from '@mappedin/blue-dot';

function MyComponent() {
  const { enable, isReady, state, following } = useBlueDot()

  // Use the Blue Dot API
  React.useEffect(() => {
    if (isReady) {
      enable({ radius: 15, color: '#ff0000' });
    }
  }, [isReady]);
}

🚀 New api mapView.getInView('label') supports getting label that's in the viewport​

Breaking Changes​

  • Rename Images to Image3D and Image to Image3DView
  • mapView.Query.nearest is now async and added travel mode to Query.nearest for fast searching of features around a coordinate.

Bug fixes​

  • fixed an issue mapData language option is not respected

v6.0.0-beta.0​

Features​

Breaking Change: useDynamicFocus hook moved to dedicated package

  • Before: Imported from @mappedin/react-native-sdk
  • Now: Import from @mappedin/dynamic-focus
  • Why: React Native SDK now supports our extension system architecture

Usage:


import { MapView } from '@mappedin/react-native-sdk';
import { useDynamicFocus } from '@mappedin/dynamic-focus';

function MyComponent() {
  const { updateState, isReady } = useDynamicFocus();

  // Use the Dynamic Focus API
  React.useEffect(() => {
    if (isReady) {
      updateState({ autoFocus: true });
    }
  }, [isReady]);
}

Breaking Change​

  • rename useEvent to useMapViewEvent
  • Remove useDynamicFocus hook
  • Add @mappedin/mappedin-js as peer dependency
  • removed useDynamicFocus in favour of extension

v6.0.0-alpha.14​

Aug 28, 2025

Features​

  • React Native SDK Browser Support: The React Native SDK can now run directly in browser environments.
  • Introduced new path.width property: short hand for pathOptions.nearRadius, pathOptions.farRadius, pathOptions.nearZoom, pathOptions.farZoom
mapView.updateState(path, {
	on: 'zoom-level',
	input: [17, 18],
	output: [1, 2],
	easing: 'ease-in',
});

Breaking Changes​

  • Marker API Update: Renamed marker.anchor to marker.placement
  • Experimental Labels: Renamed mapView.Labels.auto to mapView.Labels.__EXPERIMENTAL__auto to reflect its status
  • BlueDot Deprecation:
    • mapView.BlueDot is now deprecated
    • Temporary access available via mapView.__BlueDot
    • Will be moved to separate package in future release

Bug Fixes​

  • EU Environment Loading: Resolved issue preventing mapData loading in eu environment
  • Deep API Calls: Fixed nested API calls (2+ levels deep) - mapView.Camera.interactions.set() now works correctly

v6.0.0-alpha.13​

July 21, 2025

Features​

Dynamic Focus Hook​

New useDynamicFocus hook to RN user to utilize the @mappedin/dynamic-focus package.

const dynamicFocus = useDynamicFocus();
dynamicFocus.enable();

Offline Map Support​

Load maps without internet connectivity by passing pre-hydrated map data to <MapView /> component

const mapData = await hydrateMapData(mvf);
<MapView mapData={mapData} />

Offline 3D Models​

Support for offline GLB and GLTF files (base64 encoded)

<Models url={base64EncodedModelUri} />

Smaller & Cleaner WaterMark​

Smaller, icon-only Mappedin watermark for cleaner map displays

v6.0.0-alpha.12 - June 30, 2025​

  • Initial release.