// the find
flutter-mapbox-gl/maps
A Mapbox GL flutter package for creating custom maps
Community-maintained Flutter plugin wrapping Mapbox GL Native (Android/iOS) and Mapbox GL JS (web) to render interactive vector maps inside Flutter widgets. It covers the core mapping use cases — layers, annotations, offline regions, snapshots — but explicitly wraps an older Mapbox SDK generation (GL Native, not the newer Maps SDK v10+). For Flutter devs who need Mapbox and can't use the official Mapbox Flutter plugin, this is the practical choice.
The layer coverage is genuinely solid: raster, symbol, circle, line, fill, fill-extrusion, hillshade, and heatmap all work across Android, iOS, and web without platform carve-outs. Offline map support goes beyond just downloading regions — you can sideload a pre-built tiles.db as an asset, which is useful for field apps with zero connectivity. The code-generation setup (scripts/templates/) for layer properties means the Dart API stays in sync with the underlying native style spec without hand-editing hundreds of properties. Example app covers 15+ distinct scenarios so you can actually see how each feature behaves before wiring it up.
This wraps mapbox-gl-native, not the current Mapbox Maps SDK v10. The upstream SDK it depends on is deprecated; Mapbox's own official Flutter plugin targets the v10 SDK with a completely different API surface, so migration will be a full rewrite, not a version bump. The Flutter 3.x disposal race condition acknowledged in the README ('not yet production ready') is a real problem — map-heavy apps that push and pop routes will hit crashes, and the workaround flag just delays them. Style DSL support is missing across all platforms, so dynamic runtime styling is limited to what the annotation/layer API exposes. There's also no Dart null-safety migration visible in the structure, which is a red flag for any project targeting modern Flutter.