# Error Tracking React Native

> PostHog error tracking for React Native apps using the posthog-react-native SDK, covering exception

PostHog error tracking for React Native apps using the posthog-react-native SDK, covering exception autocapture, manual captureException() calls at error boundaries and catch blocks, source map upload so stack traces resolve, fingerprints, alerts, and issue assignment. Use when adding or configuring error tracking, crash reporting, or source map uploads in a React Native project, or when handling PostHog keys and hosts via react-native-config.

- Page: https://ss33.ai/skills/posthog/error-tracking-react-native-86147120247
- Publisher: posthog
- Category: [Software Development](https://ss33.ai/skills/category/software-development-t44z8z) › [Mobile apps](https://ss33.ai/skills/category/software-development-t44z8z/mobile-apps-p8puwc)
- License: MIT
- Source: https://github.com/posthog/skills/blob/4922922c4ca74db4e6705cecbced2a46fd103f27/skills/posthog/all/skills/error-tracking-react-native/SKILL.md

## Skill

SKILL.md: https://ss33.ai/api/v1/ss33/download/posthog/error-tracking-react-native-86147120247

# PostHog error tracking for React Native

This skill helps you add PostHog error tracking to React Native applications.

## Reference files

- `references/react-native.md` - React native error tracking installation - docs
- `references/fingerprints.md` - Fingerprints - docs
- `references/alerts.md` - Send error tracking alerts - docs
- `references/monitoring.md` - Monitor and search issues - docs
- `references/assigning-issues.md` - Assign issues to teammates - docs
- `references/upload-source-maps.md` - Upload source maps - docs

Consult the documentation for API details and framework-specific patterns.

## Key principles

- **Environment variables**: Always use environment variables for PostHog keys and host URLs. Never hardcode them.
- **Minimal changes**: Add error tracking alongside existing error handling. Don't replace or restructure existing error handling code.
- **Autocapture first**: Enable exception autocapture in the SDK initialization before adding manual captures.
- **Source maps**: Upload source maps so stack traces resolve to original source code, not minified bundles.
- **Manual capture for boundaries**: Use `captureException()` at error boundaries and catch blocks for errors that don't propagate to the global handler.

## Framework guidelines

- posthog-react-native is the React Native SDK package name
- Use react-native-config to load POSTHOG_PROJECT_TOKEN and POSTHOG_HOST from .env (variables are embedded at build time, not runtime)
- react-native-svg is a required peer dependency of posthog-react-native (used by the surveys feature) and must be installed alongside it
- Place PostHogProvider INSIDE NavigationContainer for React Navigation v7 compatibility