Newrelic React Native Agent banner
newrelic newrelic

Newrelic React Native Agent

Development community

Description

New Relic Mobile Agent SDK for React-Native Applications

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

[![Community Plus header](https://github.com/newrelic/opensource-website/raw/main/src/images/categories/Community_Plus.png)](https://opensource.newrelic.com/oss-category/#community-plus)

[![npm](https://img.shields.io/npm/v/newrelic-react-native-agent?color=blue)](https://www.npmjs.com/package/newrelic-react-native-agent) [![codecov](https://codecov.io/github/newrelic/newrelic-react-native-agent/branch/main/graph/badge.svg?token=J597PET0X4)](https://codecov.io/github/newrelic/newrelic-react-native-agent)

New Relic React Native Agent

This agent uses native New Relic Android and iOS agents to instrument the React-Native Javascript environment. The New Relic SDKs collect crashes, network traffic, and other information for hybrid apps using native components.

[!IMPORTANT] **⚠️ Breaking change in error reporting (v1.9.0)**

Starting with version **1.9.0**, JavaScript errors are reported via a new event type: **`MobileJSError`**. They will no longer appear under the `MobileHandledException` event type.

**Action required:**

  • Alerts: Update your NRQL alert conditions to target MobileJSError.
  • Dashboards: Update any custom charts that query MobileHandledException for JavaScript-layer errors.
  • Symbolication: Update your build scripts to the latest version to support source map uploads for this new event. See React Native JavaScript error reporting.

**Migrate your NRQL:**

  • Old query: SELECT count(*) FROM MobileHandledException WHERE platform = 'reactnative'
  • New query: SELECT count(*) FROM MobileJSError

Known Issues

**Crash reports may not be sent when ProGuard rules are not properly configured for New Relic in hybrid Android applications.**

Symptoms:

  • Crashes occur but are not visible in New Relic dashboard
  • Crash reporting appears to be non-functional despite correct initialization

Solution: Ensure proper ProGuard rules are added to your ProGuard configurati