Manual Setup

If you can’t (or don’t want) to run the linking step you can see here what is happening on each platform.


You will want to make sure you have already created a file at the root of your react native project. An example of this properties file can be found in the examples GitHub.


Linking the Native Library

You must link the native Sentry project with your project. This can be done by following the Linking Libraries steps described in React Native documentation.

The library you need to link is node_modules/react-native-sentry/ios/RNSentry.xcodeproj.


Update your AppDelegate.m file to pull in the proper native library and initialize it.

#if __has_include(<React/RNSentry.h>)
#import <React/RNSentry.h> // This is used for versions of react >= 0.40
#import "RNSentry.h" // This is used for versions of react < 0.40

/* in your didFinishLaunchingWithOptions */
[RNSentry installWithRootView:rootView];

Build Steps

When you use Xcode you can hook directly into the build process to upload debug symbols. When linking one build phase script is changed and two more are added.

Bundle React Native code and images

We modify the react-native build phase (“Bundle React Native code and images”) slightly from this:

export NODE_BINARY=node

To this:

export NODE_BINARY=node

# If you are using RN 0.46+
../node_modules/@sentry/cli/bin/sentry-cli react-native xcode \

# For RN < 0.46
../node_modules/@sentry/cli/bin/sentry-cli react-native xcode \

Additionally we add a build script called “Upload Debug Symbols to Sentry” which uploads debug symbols to Sentry.

Upload Debug Symbols to Sentry

If you wish to upload the source maps and symbols to Sentry, create a new Run Script build phase with the following script:


../node_modules/@sentry/cli/bin/sentry-cli upload-dif "$DWARF_DSYM_FOLDER_PATH"

For bitcode enabled builds via iTunes Connect, additional steps are required. Follow the instructions at With Bitcode to set up uploads of symbols for all build variants.

Note that uploading of debug simulator builds by default is disabled for speed reasons. If you do want to also generate debug symbols for debug builds you can pass --allow-fetch as a parameter to react-native-xcode in the above mentioned build phase.

Using node with nvm

If you are using nvm, Xcode seems to have problems locating the default node binary. In that case you should change the scripts to this:

# First set the path to

# Setup nvm and set node
[ -z "$NVM_DIR" ] && export NVM_DIR="$HOME/.nvm"

if [[ -s "$HOME/.nvm/" ]]; then
. "$HOME/.nvm/"
elif [[ -x "$(command -v brew)" && -s "$(brew --prefix nvm)/" ]]; then
. "$(brew --prefix nvm)/"

# Set up the nodenv node version manager if present
if [[ -x "$HOME/.nodenv/bin/nodenv" ]]; then
eval "$("$HOME/.nodenv/bin/nodenv" init -)"

[ -z "$NODE_BINARY" ] && export NODE_BINARY="node"

# Run sentry cli script to upload debug symbols
$NODE_BINARY ../node_modules/@sentry/cli/bin/sentry-cli upload-dif "$DWARF_DSYM_FOLDER_PATH"

# OR

$NODE_BINARY ../node_modules/@sentry/cli/bin/sentry-cli react-native xcode \


For Android we hook into gradle for the source map build process. When you run react-native link the gradle files are automatically updated.

We enable the gradle integration in your android/app/build.gradle file by adding the following line after the react.gradle one:

apply from: "../../node_modules/react-native-sentry/sentry.gradle"

You can also enable logging for sentry-cli by adding this config before the above apply from: line:

project.ext.sentryCli = [
    logLevel: "debug"

We also support fetching different files for different flavors. For that you need to add:

project.ext.sentryCli = [
    logLevel: "debug",
    flavorAware: true

The corresponding flavor files should also be placed within the specific build type folder you intend to use them. For example the “Android release” flavor would be react-native/android/

We recommend leaving logLevel: "debug" since we look for specific files depending on your flavors name.

Include the project by adding it to our dependency list in app/build.gradle:

dependencies {
    // ... other dependencies listed here //
    implementation project(':react-native-sentry')

Please make sure your looks something like this:

import io.sentry.RNSentryPackage;

public class MainApplication extends Application implements ReactApplication {

    protected List<ReactPackage> getPackages() {
        return Arrays.<ReactPackage>asList(
                new MainReactPackage(),
                new RNSentryPackage()


Add the following to your settings.gradle file:

include ':react-native-sentry'
project(':react-native-sentry').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-sentry/android')