Back to the changelog
RecordedSDKsBreaking

MapLibre GL JS 6, and the packages at 0.7.0

@unmap/maps moves to MapLibre GL JS 6 and takes maplibre-gl as a peer dependency, so an app that also uses MapLibre directly gets one copy, not two. @unmap/sdk still depends on it directly, so npm i @unmap/sdk remains a working map with nothing else to install.

  • import { maplibregl } from "@unmap/maps" is unchanged; v6 is ESM-only, needs WebGL2, and the docs' no-build example is now a module script
  • The quickstart explains the grey map that never paints under Turbopack: MapLibre needs a one-time setWorkerUrl(), and both worker files must be copied
  • The docs link to MapLibre's own reference for the map API, and say where unmap's documentation stops and MapLibre's begins

Action requiredIf you import @unmap/maps next to MapLibre, install maplibre-gl as a peer so the app has one copy. Under Turbopack, call setWorkerUrl() once and copy both worker files.

Packages@unmap/maps@0.7.0