# MapLibre Flutter > Permissive and performant mapping library that supports Mapbox Vector Tiles (MVT) powered by MapLibre SDKs. ## Writing code for 0.4 - Code for 0.3 or older doesn't compile. Signs: `featuresAtPoint`, `MapOptions(initCenter: …)`, `setStyle`, styles as strings, and the `maplibre_android`, `maplibre_ios` and `maplibre_webview` packages. See the [migration guide](https://maplibre.org/flutter-maplibre/docs/migrate/upgrade-from-v0.3.x.md). - Declarative: `MapLibreMap` parameters and annotation layers (`CircleLayer`, `MarkerLayer`, `PolylineLayer`, `PolygonLayer`, `WidgetLayer`); change them with `setState()`. - Imperative: sources and style layers, through `style.sources` and `style.layers`, usually in `onStyleLoaded`. - Variants are sealed classes with named constructors: `MapStyle.url`, `CameraUpdate.position`, `CameraAnimation.fly`, `QueryGeometry.point`, `GeoJsonData.featureCollection`, `MarkerIcon.asset`. - Style layer properties and filters take `Expression`; write constants as `const .literal(…)`. - Positions are `Geographic(lon: …, lat: …)`, bounds are `GeoBox` (geobase, re-exported). - Feature queries and camera methods return futures; `await` them. ## Getting Started - [Overview](https://maplibre.org/flutter-maplibre/docs.md): What the maplibre package does and where to find each part of its documentation. - [Installation](https://maplibre.org/flutter-maplibre/docs/getting-started/setup.md): Add maplibre to a Flutter app and check the supported platforms and versions. - [Platform setup](https://maplibre.org/flutter-maplibre/docs/getting-started/platforms.md): The setup steps that each platform needs, such as permissions and minimum versions. - [First map](https://maplibre.org/flutter-maplibre/docs/getting-started/usage.md): Show a first map with MapLibreMap and control it with the MapController. - [AI tools](https://maplibre.org/flutter-maplibre/docs/getting-started/ai-tools.md): Give AI coding assistants the current maplibre docs through llms.txt and llms-full.txt. ## Guides - [Map & Camera](https://maplibre.org/flutter-maplibre/docs/map.md): Map options, camera updates and animations, gestures, feature queries and paused rendering. - [Styles](https://maplibre.org/flutter-maplibre/docs/styles.md): Load a map style from a URL, an asset, a file or JSON, and find style providers. - [Events](https://maplibre.org/flutter-maplibre/docs/events.md): React to taps, drags, camera changes and style loads with the on… callbacks of MapLibreMap. - [User Interface](https://maplibre.org/flutter-maplibre/docs/ui.md): The compass, scale bar, attribution and zoom buttons, and how to place them on the map. - [Plugins](https://maplibre.org/flutter-maplibre/docs/plugins.md): Build map features as widgets that add layers, callbacks and UI to the map, in your app or in a package. - [User Location](https://maplibre.org/flutter-maplibre/docs/user-location.md): Show the location of the user on the map and let the camera follow it. - [Offline & Cache](https://maplibre.org/flutter-maplibre/docs/offline.md): Download regions for offline use and manage the cache of maps. - [Network](https://maplibre.org/flutter-maplibre/docs/network.md): Request headers and URL transforms for the styles, tiles and other resources that maps load. ## Annotations - [Annotation Layers](https://maplibre.org/flutter-maplibre/docs/annotations.md): Show circles, markers, polygons and polylines on the map and update them with setState(). - [Widgets](https://maplibre.org/flutter-maplibre/docs/annotations/widgets.md): Show Flutter widgets on the map at geographic positions. - [Drag](https://maplibre.org/flutter-maplibre/docs/annotations/drag.md): Let the user drag annotations on the map. - [Click and Hover](https://maplibre.org/flutter-maplibre/docs/annotations/click-and-hover.md): React to taps and the mouse on annotations. ## Sources - [Overview](https://maplibre.org/flutter-maplibre/docs/sources.md): The data sources that style layers draw on the map. - [GeoJSON](https://maplibre.org/flutter-maplibre/docs/sources/geojson.md): Add points, lines and polygons from GeoJSON, and cluster points. - [Tiles](https://maplibre.org/flutter-maplibre/docs/sources/tiles.md): Vector, raster and elevation tiles from tile servers, PMTiles and MBTiles. - [Images & Video](https://maplibre.org/flutter-maplibre/docs/sources/media.md): Place an image or a video on the map. ## Style Layers - [Layer Types](https://maplibre.org/flutter-maplibre/docs/style-layers.md): Draw the data of a source on the map with the layer types of the MapLibre style spec. - [Paint & Layout](https://maplibre.org/flutter-maplibre/docs/style-layers/paint-and-layout.md): Paint and Layout properties can be used to style your layers and change their behaviors. - [Expressions](https://maplibre.org/flutter-maplibre/docs/style-layers/expressions.md): Typed style expressions for filters, data-driven and zoom-dependent styling. - [Click and Hover](https://maplibre.org/flutter-maplibre/docs/style-layers/click-and-hover.md): React to taps and the mouse on the features of style layers. ## Contributing - [Architecture](https://maplibre.org/flutter-maplibre/docs/contributing/architecture.md): How the packages fit together, and how maps render, take gestures and change styles. - [Local development](https://maplibre.org/flutter-maplibre/docs/contributing/development.md): Set up the repository, run the example app and the tests, and check a change. - [API guidelines](https://maplibre.org/flutter-maplibre/docs/contributing/api-guidelines.md): The rules behind the public API of maplibre, for contributors and plugin authors. ## More - [Features](https://maplibre.org/flutter-maplibre/features.md): Which features each platform supports. ## API reference - [maplibre on pub.dev](https://pub.dev/documentation/maplibre/latest/maplibre/): the dartdoc of every public class and member. - [llms-full.txt](https://maplibre.org/flutter-maplibre/llms-full.txt): every page above in one file. ## Skills - [maplibre-migrate](https://maplibre.org/flutter-maplibre/skills/maplibre-migrate/SKILL.md): Migrate a Flutter app to maplibre 0.4, from maplibre 0.3 or older, maplibre_gl, flutter_map, google_maps_flutter or mapbox_maps_flutter. Use when upgrading maplibre or replacing another map package with it. ## Optional - [Upgrade to 0.4](https://maplibre.org/flutter-maplibre/docs/migrate/upgrade-from-v0.3.x.md): Every breaking change of 0.4 and how to update code written for 0.3. - [From maplibre_gl](https://maplibre.org/flutter-maplibre/docs/migrate/maplibre_gl.md): Move an app from maplibre_gl to maplibre. - [From flutter_map](https://maplibre.org/flutter-maplibre/docs/migrate/flutter_map.md): Move an app from flutter_map to maplibre. - [From google_maps_flutter](https://maplibre.org/flutter-maplibre/docs/migrate/google_maps_flutter.md): Move an app from google_maps_flutter to maplibre. - [From mapbox_maps_flutter](https://maplibre.org/flutter-maplibre/docs/migrate/mapbox_maps_flutter.md): Move an app from mapbox_maps_flutter to maplibre. - [Upgrade from 0.2.x](https://maplibre.org/flutter-maplibre/docs/migrate/upgrade-from-v0.2.x.md): The breaking changes of 0.3 and how to update code written for 0.2. - [Upgrade from 0.1.x](https://maplibre.org/flutter-maplibre/docs/migrate/upgrade-from-v0.1.x.md): The breaking changes of 0.2 and how to update code written for 0.1. - [Upgrade from 0.0.x](https://maplibre.org/flutter-maplibre/docs/migrate/upgrade-from-v0.0.x.md): The breaking changes of 0.1 and how to update code written for 0.0. - [Compare](https://maplibre.org/flutter-maplibre/compare.md): How maplibre differs from maplibre_gl, flutter_map, mapbox_maps_flutter and google_maps_flutter.