Mobile SDK

Error monitoring for React Native

A pure-JS package — no native modules, no pod install, no Gradle wiring. It hooks the global error handler and unhandled promise rejections. (For native crashes, run the platform SDKs alongside.)

Frameworks React NativeRequires React Native 0.70+Package @errorgap/react-nativeSource ↗Package ↗Agent guide ↗

On this page

Install
Configure
Trigger a test error
Verify

Install

npm install @errorgap/react-native

No native modules ship in v1 — nothing to link. Native crash reporting is pending; use the platform SDKs alongside for native crashes.

Configure

In your entry file (index.js / App.tsx):

import { Errorgap } from "@errorgap/react-native";
import { Platform } from "react-native";

Errorgap.init({
  endpoint:    "https://your-endpoint",
  projectSlug: "your-project",
  apiKey:      "flk_...",
  environment: __DEV__ ? "development" : "production",
  deviceInfo: {
    os_name:    Platform.OS,
    os_version: String(Platform.Version),
  },
});

The SDK hooks ErrorUtils.setGlobalHandler and unhandled promise rejections automatically.

Trigger a test error

tsx

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

Verify

Verify the connection

Confirm your key and endpoint reach errorgap before wiring anything else — send one event straight to the ingestion API:

bash

curl -sS -X POST "$ERRORGAP_ENDPOINT/api/projects/$ERRORGAP_PROJECT_SLUG/notices" \
  -H "content-type: application/json" \
  -H "x-errorgap-project-key: $ERRORGAP_API_KEY" \
  -d '{"errors":[{"type":"ErrorgapInstallTest","message":"Errorgap install verification"}]}'

A 201 with a group_id means ingestion works (202 = received but sampled; 401 = wrong key). Then trigger the test error above through the SDK. Your onboarding screen's Verify step checks the stack off automatically once the first event lands — it polls every three seconds.

Next: the full ingestion API, or browse every SDK.