Skip to main content

Getting Started

This guide gets you started with MapLibre in your Expo or React Native project.

Native Versions​

This package wraps MapLibre Native for Android and iOS, these are the currently used versions:

Android
13.6.1
iOS
6.31.0

Requirements​

React Native
≥ 0.80.0 (lower versions might work)
Architecture
From v11 onwards only the new architecture is supported
Android API Level
≥ 23
Map Style/Tiles
  • For development the MapLibre Demo Tiles are used
  • For production use, please provide your own style/tiles or use a provider like Stadia Maps or MapTiler

Installation​

Installing the @maplibre/maplibre-react-native package differs for Expo and bare React Native projects. Please follow the guide corresponding to your app setup:

Rendering a <Map />​

After completing the installation and rebuilding the app, you can start using the library:

import React from "react";
import { Map } from "@maplibre/maplibre-react-native";

function App() {
return <Map mapStyle="https://demotiles.maplibre.org/style.json" />;
}