NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #2381 most downloaded on pub.dev
Web implementation of the Flutter MapLibre plugin.
Latest stable
0.3.7+1
Last release 15 days ago
07 Nov 2026
Release timing varies
gaps range from 8 days to 4 months
Nearly every release is documented
notes for 6 of 6 stable releases
Nothing withdrawn
no release was ever pulled
9 months old
8 releases · first in 2026
Drag across the ruler to compare, or tap a release to open it.
The second pre-release of 0.4 reworks the event, camera, query and gesture APIs, adds drag, click and hover events to layers, and fixes Linux. The mig
The second pre-release of 0.4 reworks the event, camera, query and gesture APIs, adds drag, click and hover events to layers, and fixes Linux. The migration guide covers every change from 0.3.x and from 0.4.0-pre.1.
onClick, onCameraMove and onIdle, replaces onEvent.moveCamera, animateCamera and MapOptions.initCamera take a CameraUpdate, animateCamera takes a CameraAnimation, and MapCamera is renamed to CameraPosition.queryRenderedFeatures replaces featuresAtPoint and featuresInRect, and returns geobase geometries.MapOptions.movements limits how the camera may move, and MapOptions.gestures has one switch per gesture.GeoJsonData instead of a string, and setProjection takes an expression.getVisibleRegion is renamed to getVisibleBounds, and MapCompass.animation replaces its duration and speed.draggable: true (#544, #151).MapLibreNetwork sets HTTP headers and rewrites request URLs for every map and the OfflineManager.querySourceFeatures, and filter expressions for feature queries.cameraFor, stopCamera, and camera roll and padding.MapOptions.fastPforEnabled (#635).StyleImageOptions.maxZoom of double.infinity download tiles.Full Changelog: v0.4.0-pre.1...v0.4.0-pre.2 Contributors: @frosenb, @teamacco, @ishafiul, @josxha
Your coding agent can read these notes before it upgrades. Set up the MCP server →
One column per month.
Removed the deprecated MapOptions.pitch (use initCamera), circumferenceOfEarth (use earthCircumferenceWgs84) and VectorSource.sourceLayer, which had n…
This pre-release replaces the MapLibre Android and iOS SDKs and the WebView desktop integration with one implementation on the MapLibre Native C API. Read the migration guide to upgrade from 0.3.x, and please report the bugs you find.
Known issue: maplibre_native_ffi has a bug that stops maps after about 30 frames in profile and release builds. maplibre_native works around it, but the workaround is only tested on Windows so far. If a map stops rendering in a profile or release build, please comment on #597.
paint and layout maps, for example width: const .literal(3) instead of paint: {'line-width': 3}. Annotation layers take expressions too.style.layers and style.sources replace the layer and source methods of StyleController: style.addLayer(layer) is style.layers.add(layer), style.updateGeoJsonSource(...) is style.sources.updateGeoJsonData(...).<script> and <link> tags from your web/index.html. With v6, WebGL2 is required, nested objects in GeoJSON feature properties are returned as maps instead of JSON strings, and zoomLevelsToOverscale defaults to 4, which can change label rendering and featuresAtPoint() results. See the maplibre-gl-js migration guide.maplibre_android, maplibre_ios and maplibre_webview. maplibre now uses maplibre_web in the browser and maplibre_native, built on the MapLibre Native C API, on every other platform. maplibre_native renders on Android, iOS, macOS, Windows and Linux.MapOptions properties of the removed packages: androidMode, androidTextureMode, androidTranslucentTextureSurface, androidForegroundLoadColor and webviewDebugMode, and the AndroidPlatformViewMode enum.MapController.featuresAtPoint and MapController.featuresInRect return a Future, because MapLibre Native answers feature queries asynchronously.MapController.queryLayers and QueriedLayer. Use featuresAtPoint with layerIds to test layers, and the new RenderedFeature.sourceId, RenderedFeature.sourceLayer and RenderedFeature.layerId for the source and the style layer.RenderedFeature equality and hashCode compare id, sourceId, sourceLayer and layerId.pointer_interceptor dependency. Widgets over the map no longer need a PointerInterceptor on web; WidgetLayer.allowInteraction works the same on every platform.OfflineManager.downloadRegion takes an OfflineRegionDefinition, either an OfflineTilePyramidRegionDefinition of bounds or the new OfflineGeometryRegionDefinition of a geometry, instead of mapStyleUrl, bounds, minZoom, maxZoom, pixelDensity and includeIdeographs. OfflineRegion holds that definition instead of its own bounds, minZoom, maxZoom, pixelRatio and styleUrl.DownloadProgress holds an OfflineRegionStatus as status instead of loadedBytes, loadedTiles, totalTiles and totalTilesEstimated, and its progress counts every resource, not only tiles.OfflineDownloadException is sealed: download streams report an OfflineResourceException with its reason, or an OfflineTileCountLimitException, both with the regionId.OfflineManager.getOfflineRegion returns null for an unknown region. setOfflineTileCountLimit and runPackDatabaseAutomatically were removed, as MapLibre Native offers neither.PermissionManager, MapController.enableLocation, MapController.trackLocation, MapController.userLocationIsSupported, BearingRenderMode and BearingTrackMode. Show the user location with a UserLocationLayer, and ask for permissions with geolocator or permission_handler. MapControlButtons takes tracking and onTrackingPressed instead of showTrackLocation.StyleController.addImage, addImages and addImageFromAssets take a pixelRatio of image pixels per logical pixel, 1 by default, instead of using the device pixel ratio. An image of N pixels shows N logical pixels wide at an icon size of 1 on every platform and screen, so images grow by the device pixel ratio on high-DPI screens; pass the ratio the image was made for to keep their size.addImageFromCanvas and addImageFromIconData take their sizes in logical pixels and render at the device pixel ratio. addImageFromCanvas requires width and height as doubles, the painter draws in logical pixels, and addImageFromIconData makes a 48 pixel icon by default.setProjection(MapProjection.globe) keeps Mercator, and adding a VideoSource throws an UnsupportedError.http:// URLs need a network-security-config that permits cleartext traffic for their hosts.OfflineManager.createInstance throws an UnsupportedError instead of an Exception.MapOptions.pitch (use initCamera), circumferenceOfEarth (use earthCircumferenceWgs84) and VectorSource.sourceLayer, which had no effect.VideoSource.coordinates is a LngLatQuad, like ImageSource.coordinates, instead of a list of four Geographics.ImageSource.url replaces ImageSource(url:).GeoJsonSource.url and GeoJsonSource.data replace GeoJsonSource(data:), which took either a URL or a GeoJSON string.RasterSource, RasterDemSource and VectorSource have .url for a TileJSON URL and .tiles for tile URLs, instead of optional url and tiles.VideoSource.urls replaces VideoSource(urls:).MapOptions.initStyle (a String) is replaced by MapOptions.style, a MapStyle: MapStyle.url, MapStyle.json, MapStyle.asset or MapStyle.file (not on web), so the style is no longer guessed from the string. The map loads a new style when style changes, and MapController.setStyle was removed.MapOptions.initCenter, initZoom, initBearing and initPitch are replaced by MapOptions.initCamera, an InitialCamera.position or InitialCamera.bounds. Without initCamera the map starts at the camera stored in its style instead of at zoom 0.LngLatBounds is replaced by geobase's GeoBox (west, south, east, north; GeoBox.from replaces LngLatBounds.fromPoints) in MapController.fitBounds, MapController.getVisibleRegion, MapOptions.maxBounds and the offline region definitions.maplibre exports only the geobase types of its API (Geographic, Position, PositionSeries, GeoBox, the geometries, Feature, FeatureCollection and earthCircumferenceWgs84) instead of all of geobase. Import package:geobase/geobase.dart for the others.StyleController.getAttributions() and getAttributionsSync() are replaced by the synchronous getter StyleController.attributions.InitialCamera.bounds starts a map fitted to bounds, with padding, bearing and pitch, from its first frame.
MapLibreMap.paused stops a map from rendering while it stays mounted, and maps hidden by an IndexedStack, a Visibility or a disabled TickerMode pause on their own. MapController.isRenderingPaused and MapEventRenderingChanged report the state.
UserLocationLayer shows a stream of UserLocations on every platform and can track them; the new maplibre_geolocator package adapts geolocator positions.
Gestures are the same on every platform: drag, pinch and twist, scroll wheel, double tap, double tap and drag, two-finger tilt, and right-button or Ctrl + left-button rotate and tilt.
OfflineGeometryRegionDefinition downloads only the tiles that a geometry such as a route touches. New OfflineManager.getRegionStatus, updateRegionMetadata, invalidateRegion and resumeDownload.
Maps cache resources in maplibre_native.db in the app support directory, which also holds the offline regions.
Typed style expressions, typed style layers and ColorReliefStyleLayer.
style.layers and style.sources list, add, update, move and remove the layers and sources of the style. Setting a property of a layer updates the map, also every frame for animations.
Changing a layer in MapLibreMap.layers no longer moves it above all other layers.
ImageSource.bytes and ImageSource.provider show images from encoded bytes or any Flutter ImageProvider, such as an AssetImage or a FileImage, not only from a URL.
Web: VideoSource.bytes and VideoSource.asset show videos from encoded bytes or a Flutter asset.
StyleController.addImageFromUiImage adds a dart:ui Image to the map from its pixels, without encoding it.
Windows, macOS and Linux are supported out of the box, rendered by MapLibre Native instead of the opt-in maplibre_webview.
Web: maplibre-gl-js and PMTiles load on their own. The latest maplibre-gl-js v6 is loaded by default, never a new major version. window.flutterMapLibre sets another version range or your own URL. See the setup instructions.
SourceAttribution updates when sources are added or removed, or a source loads its attribution, not only when the camera moves.StyleController.attributions includes the attribution of a source's TileJSON.MarkerLayer applies textOpacity (it used iconOpacity) and iconTranslate, and PolylineLayer applies blur.addImage, addImageFromIconData and addImageFromWidget keep their size with the skwasm renderer (--wasm).animateCamera no longer hangs when the animation ends at once, and removing a source that does not exist is not an error.Full Changelog: v0.3.7+1...v0.4.0-pre.1 Contributors: @josxha
This bug fix release is the last planned release for the v0.3 series. The focus now will be on replacing the Android and iOS SDK as well as the WebVie
This bug fix release is the last planned release for the v0.3 series. The focus now will be on replacing the Android and iOS SDK as well as the WebView desktop integration with unified C bindings. Stay tuned!
parseExpression.Full Changelog: v0.3.7...v0.3.7+1 Contributors: @miakh, @josxha
This release brings some important bug fixes and updates package dependencies to the newest version. The pub.dev release happend a couple of days ago
This release brings some important bug fixes and updates package dependencies to the newest version. The pub.dev release happend a couple of days ago but the GitHub release was missing. Thanks for everyone who contributed in this release!
OfflineManager.downloadRegion no longer leaks a JNI global reference per status event, which aborted the process with a global reference table overflow partway through a large region download.StyleController whose native style was already released are ignored instead of aborting the process with a JNI error.maplibre_android.colorArray and numberArray paint properties.animateCamera() crash when called before the native view has a layout size.MLNMapView and its gesture recognizers when the map is disposed.fitBounds() no longer reuses padding from a previous camera move.Contributors: @glandais, @miakh, @teamacco, @Mazen-Embaby, @fmt-Println-MKO, @BartoszStasiurka, @josxha
Full Changelog: v0.3.6...v0.3.7
Thanks for everyone who contributed in this release!
Thanks for everyone who contributed in this release!
FrameLayout and its native map state per map create/dispose
cycle.StyleController now releases its native style reference when
the owning MapLibreMap is disposed, instead of staying technically
usable on a torn-down map.StyleController and several map query methods
(updateGeoJsonSource, removeLayer/removeSource/removeImage,
getLayerIds, getAttributionsSync, featuresAtPoint/featuresInRect)
leak JNI global references on every call.Contributors: @josxha, @emanuelesenis, @BartoszStasiurka, @D3CK3R, @Mazen-Embaby, @teamacco, @lukeboyden
This release contains a couple of bug fixes and improvements. Thanks to @BartoszStasiurka for his contributions in this release!
This release contains a couple of bug fixes and improvements. Thanks to @BartoszStasiurka for his contributions in this release!
maxZoom to 22 for RasterSource, RasterDemSource and VectorSource.DownloadProgressdeleteRegion() to OfflineManageronStyleLoaded() unreliable if style not loaded immediatelyfeaturesAtPoint causes ClassNotFoundException in release buildsjni to v1.0.0, jnigen to 0.16.0Full Changelog: v0.3.4+1...v0.3.5 Contributors: @BartoszStasiurka, @josxha
This feature release introduces a complete migration of the iOS platform to FFI and experimental support for Windows and macOS has been added using wi
This feature release introduces a complete migration of the iOS platform to FFI and experimental support for Windows and macOS has been added using with web view. The package has also been restructured into a federated plugin with separate packages for each platform.
padding parameter to moveCamera() and animateCamera().padding parameter of fitBounds() doesn't account for device pixel ratio.setState() if widget is not mounted.listOfflineRegions() throws exception if region packs are not available yet.addImage()Full Changelog: v0.3.3+2...v0.3.4 Contributors: @josxha
Web: fix addSource() with raster and raster-dem source throws exception.
addSource() with raster and raster-dem source throws exception.addImage() results in image with wrong pixel ratio.animateCamera() causes the zoom level to jumps to the target zoom level.onStyleLoaded() callback is not called when style loads immediately.Full Changelog: v0.3.4...v0.3.4+1 Contributors: @josxha