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
11.8.0
iOS
6.10.0

Requirements​

React Native
≥ 0.74.0 (lower versions might work)
Android API Level
≥ 23
Map Style/Tiles
  • This library defaults to the MapLibre Demo Tiles
  • For production use, please use 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 <MapView />​

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

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

function App() {
  return <MapView style={{ flex: 1 }} />;
}