# MapLibre for Compose Multiplatform [![Maven Central Version](https://img.shields.io/maven-central/v/org.maplibre.compose/maplibre-compose?label=Maven)](https://central.sonatype.com/namespace/org.maplibre.compose) [![License](https://img.shields.io/github/license/maplibre/maplibre-compose?label=License)](https://github.com/maplibre/maplibre-compose/blob/main/LICENSE) [![Kotlin Version](https://img.shields.io/badge/dynamic/toml?url=https%3A%2F%2Fraw.githubusercontent.com%2Fmaplibre%2Fmaplibre-compose%2Frefs%2Fheads%2Fmain%2Fgradle%2Flibs.versions.toml&query=versions.gradle-kotlin&prefix=v&logo=kotlin&label=Kotlin)](./gradle/libs.versions.toml) [![Compose Version](https://img.shields.io/badge/dynamic/toml?url=https%3A%2F%2Fraw.githubusercontent.com%2Fmaplibre%2Fmaplibre-compose%2Frefs%2Fheads%2Fmain%2Fgradle%2Flibs.versions.toml&query=versions.gradle-compose&prefix=v&logo=jetpackcompose&label=Compose)](./gradle/libs.versions.toml) [![Documentation](https://img.shields.io/badge/Documentation-blue?logo=astro&logoColor=white)](https://maplibre.org/maplibre-compose/) [![API Reference](https://img.shields.io/badge/API_Reference-blue?logo=Kotlin&logoColor=white)](https://maplibre.org/maplibre-compose/api/) [![Slack](https://img.shields.io/badge/Slack-4A154B?logo=slack&logoColor=white)](https://osmus.slack.com/archives/maplibre-compose) ## Introduction MapLibre Compose is a [Compose Multiplatform][compose] wrapper around the [MapLibre][maplibre] SDKs for rendering interactive maps. You can use it to add maps to your Compose UIs across Android, iOS, Desktop, and Web.

iOS Screenshot Android Screenshot

## Usage - [Getting Started](https://maplibre.org/maplibre-compose/getting-started/) - [API Reference](https://maplibre.org/maplibre-compose/api/) - [Demo App](./demo-app) ## Stability MapLibre Compose uses [Kotlin's stability levels][stability] to describe update risk. The public API is still evolving, and minor releases can contain breaking changes. | Platform | Stability | | -------------------- | --------------------------------------------------------------------- | | Android | [![Beta](https://kotl.in/badges/beta.svg)][stability] | | iOS | [![Beta](https://kotl.in/badges/beta.svg)][stability] | | macOS Native (ARM64) | [![Experimental](https://kotl.in/badges/experimental.svg)][stability] | | Desktop (JVM) | [![Alpha](https://kotl.in/badges/alpha.svg)][stability] | | Web | [![Alpha](https://kotl.in/badges/alpha.svg)][stability] | Desktop and Web are Alpha because their platform integrations depend on implementation details in Compose and Skia. [compose]: https://www.jetbrains.com/compose-multiplatform/ [maplibre]: https://maplibre.org/ [stability]: https://kotlinlang.org/docs/components-stability.html