Expo Basic Setup

This guide explains how to configure React Native Naver Map in Expo projects.

Expo Go does not support native modules, so you need a Development Build.

1. Add expo-build-properties Package

This is required to inject the Naver Maven repository:

npx expo install expo-build-properties

2. Add Config Plugin to app.json

Configure the Config Plugin with your issued Client ID:

app.json

{
  "expo": {
    "name": "your-app-name",
    "plugins": [
      [
        "@mj-studio/react-native-naver-map",
        {
          "client_id": "YOUR_CLIENT_ID_HERE"
        }
      ],
      [
        "expo-build-properties",
        {
          "android": {
            "extraMavenRepos": ["https://repository.map.naver.com/archive/maven"]
          }
        }
      ]
    ]
  }
}

Replace YOUR_CLIENT_ID_HERE with your actual Client ID issued from Naver Cloud Platform.

3. Run Prebuild

Generate native project files:

npx expo prebuild -p android
npx expo prebuild -p ios

4. Create Development Build

Local Build

# iOS
npx expo run:ios

# Android
npx expo run:android

EAS Build (Cloud Build)

# Configure EAS Build
npx eas build:configure

# Create Development Build
npx eas build --profile development --platform ios
npx eas build --profile development --platform android

5. Start Development Server

Once the Development Build is complete, start the development server:

npx expo start --dev-client

Setup

On this page