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.0.2
iOS
6.25.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" />;
}