React Native SDK

Install

npm i @errtap/react-native

The SDK reads React Native's supported global ErrorUtils runtime handler for uncaught JS errors, forwards them to ErrTap, then hands off to the previous handler. Repeated init calls update configuration without stacking handlers. Production Hermes promise rejections are captured only when Hermes exposes its native rejection-tracker hook; other runtimes are not monkey-patched.

Initialise

Call init once, as early as possible in your entry file:

// App.tsx (or index entry — call once at startup)
import { init } from '@errtap/react-native';

init({
  dsn: process.env.EXPO_PUBLIC_ERRTAP_DSN!, // https://et_…@host
  environment: __DEV__ ? 'development' : 'production',
  release: '1.0.0',
});

With Expo, expose the DSN through an EXPO_PUBLIC_-prefixed env var. DSN keys are write-only, so shipping one in the app binary is by design.

Manual capture & logs

import { captureException, captureMessage, logger } from '@errtap/react-native';

logger.info('checkout started');

try {
  await pay();
} catch (e) {
  captureException(e as Error, { tags: { screen: 'Checkout' } });
  throw e;
}

Source maps (de-minify stack traces)

Release bundles are minified, so production traces read like index.android.bundle:1:428079. ErrTap de-minifies them at ingest when it has the bundle's source map for that release. @errtap/react-native ships an errtap-upload-sourcemaps command; run it once per platform after you build a release bundle with a sourcemap:

# produce a release bundle + sourcemap (Android shown; iOS: main.jsbundle)
npx react-native bundle --platform android --dev false \
  --entry-file index.js \
  --bundle-output index.android.bundle \
  --sourcemap-output index.android.bundle.map

# upload the map, keyed by the release you pass to init()
ERRTAP_DSN=https://et_<key>@your-host ERRTAP_RELEASE=1.0.0 \
  errtap-upload-sourcemaps --sourcemap index.android.bundle.map

--bundle defaults to the sourcemap name minus .map (the filename the runtime stack references); pass it explicitly if they differ. The map isn't deleted — it's a build artifact, not part of your app.

Hermes: upload the composed map (the Metro map composed with the Hermes bytecode map via react-native/scripts/compose-source-maps.js), or the columns won't match the runtime stack. Your release build usually emits this as the final .map — point --sourcemap at it.

Options