Getting started

expo-arcgis is a native Expo module wrapping the ArcGIS Maps SDK for Kotlin (Android) and Swift (iOS). It is not available in Expo Go — use a development build.

Requirements

	Supported
Expo	SDK 56, 57 and 58 (New Architecture)
iOS	18.0+, built with Xcode 26 or 27
Android	API 28+ (Android 9), compileSdk 37 — Esri deprecated API 28 in ArcGIS 300.1; the next SDK release requires API 29
Auth	An ArcGIS API key (or token / OAuth)

Every change is built in a fresh app on each supported Expo SDK — Android, iOS, and a typecheck + bundle — so the table is what CI checks, not a guess:

Expo SDK	React Native
58	0.88 (verified on the beta, 0.88.0-rc.3)
57	0.86
56	0.85

The iOS and Android minimums come from ArcGIS Maps SDK 300.1; the config plugin raises your app to them. On Xcode 27, Expo SDK 56 builds only from 56.0.23 on (npx expo install --fix) — earlier expo-modules-jsi releases don’t compile with its Swift.

Install

npx expo install expo-arcgis

Add the config plugin to your app config. It wires the Esri Maven repository (Android), raises minSdk / compileSdk and the iOS deployment target, and (optionally) injects your API key.

app.config.js

module.exports = {
  expo: {
    plugins: [['expo-arcgis', { apiKey: process.env.ARCGIS_API_KEY }]],
  },
};

Then regenerate the native projects:

npx expo prebuild --clean

Your first map

The API is declarative and mirrors the ArcGIS SDK object model — a <Map> model inside a <MapView> host, wrapped in <MapSettings>:

import { MapSettings, Map, MapView } from 'expo-arcgis';

export function Screen() {
  return (
    <MapSettings config={{ apiKey: process.env.EXPO_PUBLIC_ARCGIS_API_KEY }}>
      <Map
        basemap="arcGISTopographic"
        initialViewpoint={{ latitude: 34.027, longitude: -118.805, scale: 72_000 }}
      >
        <MapView style={{ flex: 1 }} onMapLoaded={() => console.log('loaded')} />
      </Map>
    </MapSettings>
  );
}

3D works the same way with <Scene> + <SceneView>. See the Samples for each capability.

Next: the Toolkit

The ArcGIS Toolkit’s components (a compass, a scalebar, search, popups, feature forms, offline map areas, sign-in, augmented reality and more) are in expo-arcgis-toolkit:

npx expo install expo-arcgis-toolkit

Add its config plugin after expo-arcgis’s (plugins: [['expo-arcgis', { … }], 'expo-arcgis-toolkit']), prebuild again, and put components in your view:

import { Map, MapView } from 'expo-arcgis';
import { Compass, Scalebar } from 'expo-arcgis-toolkit';

<Map basemap="arcGISTopographic">
  <MapView style={{ flex: 1 }}>
    <Compass />
    <Scalebar units="metric" />
  </MapView>
</Map>

The Toolkit guide lists every component. A few exist on one platform only: see Platform differences.