Flutter MapLibre GL

Interactive, fully styleable vector maps on Android, iOS and Web, powered by open source MapLibre.
Vendor-neutral: host your own tiles or mix providers, no account or API key required to get started.

✨ Try it before you install: run the package live in your browser and read the full docs, no setup and no API keys.

🖼️ What it looks like

Android, iOS and web

Globe, on web	Heatmaps

Clustering	Annotations

The demo runs the plugin in your browser, and every guide embeds an interactive map you can pan and click.

🚀 Quick start

flutter pub add maplibre_gl

import 'package:maplibre_gl/maplibre_gl.dart';

// Anywhere with bounded constraints, a Scaffold body for example:
MapLibreMap(
  initialCameraPosition: const CameraPosition(target: LatLng(0, 0), zoom: 2),
  styleString: 'https://demotiles.maplibre.org/style.json',
  onStyleLoadedCallback: () {
    // Add sources, layers and images here.
  },
);

Requires Flutter 3.44+ · Dart 3.12+ · JDK 21 for Android builds · Android 7.0 (API 24)+ · iOS 15.5+ · a browser with WebGL2 (Safari 15+).

Then head to the getting started guide for platform setup (location permissions on iOS/Android; web needs no index.html changes) and to learn how to add markers, layers, offline tiles and more.

Upgrading from 0.27? The migration guide lists what to check.

🗺️ Feature support

Engines: maplibre-native (Android/iOS), maplibre-gl-js (Web). Only a subset of native SDK APIs is exposed, PRs to extend coverage are welcome.

Feature	Android	iOS	Web
Style, Camera, Gesture	✅	✅	✅
User Location	✅	✅	✅
Annotations	✅	✅	✅
All layer types (Symbol to Hillshade)	✅	✅	✅
GeoJSON, vector, raster & PMTiles sources	✅	✅	✅
Offline regions	✅	✅	❌
Feature state	✅	✅	✅

See the full feature matrix for details.

Not supported: desktop targets (Windows, macOS, Linux), and Flutter widgets inside the map. The map is a platform view rendered by the native engines, so your widgets go over it in a Stack, not between its layers.

🔗 Links

Example app · API reference · Changelog · Discussions · Issues · Slack (#maplibre-flutter)

🤝 Contributing

dart pub global activate melos
melos bootstrap

This is a melos workspace (maplibre_gl, maplibre_gl_web, maplibre_gl_platform_interface and the example app). Layer/source helpers are generated, don't edit them directly; run melos run generate && melos run format-all. See CONTRIBUTING.md before opening a PR, and the architecture docs for an overview.

This project is a fork of flutter-mapbox-gl. ❤️

💝 Contributors

A huge thanks to everyone who has contributed to this project!

Made with contrib.rocks.

📄 License

See LICENSE.