sentry-react-native-setup

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

getsentry/sentry-agent-skills|Updated Apr 8, 2026

Works with

Claude CodeCursorClineWindsurfCodexGoose

Installation Guide

Select your AI agent

How to use sentry-react-native-setup on Cursor

AI-first code editor with Composer

Prerequisites

Before installing skills in Cursor, ensure your development environment meets these requirements:

›Cursor installed and configured on your machine
›Node.js 16+ with npm — verify with node --version
›Active project directory where you want to add sentry-react-native-setup

Run the install command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/getsentry/sentry-agent-skills --skill sentry-react-native-setup

Fetches sentry-react-native-setup from getsentry/sentry-agent-skills and configures it for Cursor.

Select Cursor when prompted

The CLI shows a list of agents. Use arrow keys and space to select Cursor:

◆ Which agents do you want to install to?

│

│ ── Universal (.agents/skills) ────────────────

│ · Cline · Codex · Goose · Windsurf

│ ●Cursor(selected)

│ · Cursor · Aider · Continue

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/sentry-react-native-setup

Restart Cursor to activate sentry-react-native-setup. Access via /sentry-react-native-setup in your agent's command palette.

⚠

Security Notice

We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.

Skills execute code in your environment. Always review source, verify the publisher, and test in isolation before production.

›View source on GitHub ›Skills CLI docs ›About Cursor ›What are agent skills?

Documentation

List & Monetize Your Skill

Submit your Claude Code skill and start earning

Get started →

Use Cases

Task Automation & Efficiency

Automate repetitive workflows and reduce manual effort

Example

Generate reports, summarize documents, draft communications

✓

Save 3-5 hours per week on routine tasks

Knowledge Enhancement

Learn new skills, understand complex topics, get expert guidance

Example

Explain concepts, provide examples, suggest learning resources

✓

Accelerate learning and skill development by 2x

Quality Improvement

Enhance output quality through reviews, suggestions, and refinements

Example

Review drafts, suggest improvements, catch errors

✓

Improve work quality by 30-40% with less effort

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);

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

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

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)

sentry-react-native-setup

Installation Guide

How to use sentry-react-native-setup on Cursor

Prerequisites

Run the install command

Select Cursor when prompted

Verify installation

Security Notice

Documentation

List & Monetize Your Skill

Use Cases

Task Automation & Efficiency

Knowledge Enhancement

Quality Improvement

Install Skill

Sentry React Native Setup

Invoke This Skill When

Wizard Setup (Recommended)

What the Wizard Does

Manual Configuration

Wrap Your App

Expo Projects

Configuration Options

Files Created/Modified

Environment Variables

Verification

Source Maps

Troubleshooting

Implementation Guide

Best Practices

When to Use This

Learning Path

Related Skills

react-vite-best-practices

frontend-design

premium-frontend-ui

ui-animation

high-end-visual-design

antigravity-design-expert

Reviews

Discussion