sentry-react-native-setup

Sentry React Native Setup

Install and configure Sentry in React Native projects using the official wizard CLI.

Invoke This Skill When

• User asks to "add Sentry to React Native" or "install Sentry" in a React Native app
• User wants error monitoring, logging, or tracing in React Native or Expo
• User mentions "@sentry/react-native" or mobile error tracking

Important: The configuration options and code samples below are examples. Always verify against docs.sentry.io before implementing, as APIs and defaults may have changed.

Wizard Setup (Recommended)

npx @sentry/wizard@latest -i reactNative

What the Wizard Does

Task	Description
Install SDK	Adds @sentry/react-native package
Metro config	Adds @sentry/react-native/metro to metro.config.js
Expo config	Adds @sentry/react-native/expo to app.json
Android setup	Enables Gradle build step for source maps
iOS setup	Wraps Xcode build phase, adds debug symbol upload
Pod install	Runs pod install for iOS
Credentials	Stores in ios/sentry.properties, android/sentry.properties, env.local
Init code	Configures Sentry in App.tsx or _layout.tsx

Manual Configuration

If not using wizard, add to your app entry point:

import * as Sentry from "@sentry/react-native";

Sentry.init({
  dsn: "YOUR_SENTRY_DSN",
  sendDefaultPii: true,
  
  // Tracing
  tracesSampleRate: 1.0,
  
  // Logs
  enableLogs: true,
  
  // Profiling
  profilesSampleRate: 1.0,
  
  // Session Replay
  replaysOnErrorSampleRate: 1.0,
  replaysSessionSampleRate: 0.1,
  integrations: [Sentry.mobileReplayIntegration()],
});

Wrap Your App

export default Sentry.wrap(App);

Expo Projects

For Expo, follow the Expo-specific setup:

npx @sentry/wizard@latest -i reactNative

Works for both managed and bare Expo projects.

Configuration Options

Option	Description	Default
dsn	Sentry DSN	Required
sendDefaultPii	Include user data	false
tracesSampleRate	% of transactions traced	0
profilesSampleRate	% of traces profiled	0
enableLogs	Send logs to Sentry	false
replaysOnErrorSampleRate	% of error sessions replayed	0
replaysSessionSampleRate	% of all sessions replayed	0

Files Created/Modified

File	Purpose
App.js / _layout.tsx	Sentry initialization
metro.config.js	Metro bundler config
app.json	Expo config (if Expo)
ios/sentry.properties	iOS build credentials
android/sentry.properties	Android build credentials
env.local	Environment variables

Environment Variables

SENTRY_DSN=https://xxx@o123.ingest.sentry.io/456
SENTRY_AUTH_TOKEN=sntrys_xxx
SENTRY_ORG=my-org
SENTRY_PROJECT=my-project

Verification

Add test error:

throw new Error("My first Sentry error!");

Or use a test button:

<Button title="Test Sentry" onPress={() => { throw new Error("Test"); }} />

Source Maps

Source maps are automatically uploaded during build when wizard configures:

• Android: Gradle plugin
• iOS: Xcode build phase

Troubleshooting

Issue	Solution
Wizard fails	Try manual setup, check Node version
iOS build fails	Run cd ios && pod install
Source maps not uploading	Verify sentry.properties files have auth token
Expo errors	Ensure using compatible Expo SDK version
App not wrapped	Add export default Sentry.wrap(App)