mcpField
E
error-tracking-react-native

error-tracking-react-native

github.com/posthogDevelopment76102 installsUpdated today
Repository

About error-tracking-react-native

A skill for adding PostHog error tracking to React Native apps. It covers SDK setup, exception capture, source maps, and issue monitoring guidance.

Key features

  1. 01React Native SDK setup guidance
  2. 02Exception autocapture and manual capture
  3. 03Source map upload guidance
  4. 04Issue monitoring and alerts
  5. 05Environment-variable configuration

Use cases

  1. 01Add PostHog tracking to a React Native app
  2. 02Capture errors missed by global handlers
  3. 03Resolve stack traces to original source
  4. 04Monitor issues and notify teams

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/posthog/skills --skill error-tracking-react-native

After installing, type/error-tracking-react-nativein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
alerts.md
assigning-issues.md
fingerprints.md
monitoring.md
react-native.md
upload-source-maps.md

Details

From the project README

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

Comments

Markdown supported