Generated banner for Error Tracking React Native
Generated logo for Error Tracking React Native

Error Tracking React Native

PostHogOfficialCreated by PostHog

  • Skill
  • Tool integration
  • Data and AI
  • MIT
  • No issues found

From the author

PostHog error tracking for React Native
— the description by PostHog

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

This skill provides guidance on implementing PostHog error tracking within React Native projects. It covers SDK installation, configuration best practices, and the integration of source maps to ensure stack traces are readable. The skill emphasizes non-intrusive implementation, recommending that developers maintain existing error handling logic while augmenting it with PostHog's capture capabilities. It also outlines how to leverage PostHog's broader platform features, such as automated issue assignment and alerting, to streamline debugging workflows.

What it does

  • Guides the installation of the posthog-react-native SDK.
  • Provides best practices for managing environment variables and project tokens.
  • Explains how to upload source maps for readable stack traces.
  • Details the use of manual capture for specific error boundaries.
  • Outlines configuration for automated issue assignment and alerting.
  • Describes how to monitor and search for issues within the PostHog dashboard.

When to use it

  • When you need to track and monitor runtime errors in a React Native application.
  • When you want to centralize error reporting and team-based issue triage.
  • When you need to set up automated alerts for critical application crashes.
  • When you are setting up a new React Native project and want to include observability from the start.

Advantages

  • Maintains existing application error handling structures.
  • Enables detailed debugging through unminified stack traces via source maps.
  • Supports team collaboration through automated issue assignment rules.
  • Provides flexible alerting options including Slack, Discord, and webhooks.

Usage examples

“How do I initialize PostHog in my React Native app?”
The agent will explain installing the posthog-react-native and react-native-svg packages, configuring environment variables, and wrapping your app with the PostHogProvider.
“How can I make sure my error stack traces are readable?”
The agent will provide instructions on generating and uploading source maps to PostHog so that minified production code can be mapped back to the original source.
“How do I get notified when a specific error happens?”
The agent will guide you through setting up alerting rules in the PostHog error tracking configuration, including filtering by exception type or message.

Install

  1. Download the skill as a ZIP:

    https://autogineer.com/agent-skills/posthog/error-tracking-react-native/download
  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip error-tracking-react-native.zip -d .agents/skills

Documentation by PostHog

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

Files

references/assigning-issues.md

Assign issues to teammates - Docs

Error tracking enables you to assign issues to specific PostHog roles or teammates. This helps your team find relevant issues through filtering. You can also set up team-specific alerting to notify them when assigned issues are created or reopened.

Assign issues

You can manually assign issues as you triage them in the UI. This can be done both in the issue list and issue detail pages.

Image: Error tracking assignment UIImage: Error tracking assignment UI

  1. In your error tracking issue list, click the unassigned selector under each issue to assign it to a role or user.

  2. On the detail page of each issue, click the Assignee selector to assign it to a role or user.

Want to assign issues to a team rather than an individual teammate? You can create a role in your project settings.

Image: Error tracking role assigneesImage: Error tracking role assignees

Automatic issue assignment

You can set up automatic issue assignment through a set of rules. This can be configured in the error tracking settings using auto assignment rules.

Image: Error tracking auto assignment rulesImage: Error tracking auto assignment rules

Assignment conditions are evaluated against the properties of the exception event that created the issue. Because assignment rules are evaluated during ingestion, the stack trace (if present) will be unminified, which enables filtering on exception properties such as function name and source file.

Issues can be automatically assigned to a role or user by configuring a set of filters. These filters can be configured to match any or all of the criteria.

You can configure automatic assignment to filter on any event property in PostHog. When there are multiple values for a property, the filters return true if it matches any of the values. For example, if you have multiple exception_functions values, the filters returns true if it matches any of the functions.

Here are some common properties you can filter on:

PropertyEvent propertyDescription
Exception type$exception_typesThe type of exception(s) that occurred
Exception message$exception_valuesThe message(s) detected on the error
Exception function$exception_functionsThe function(s) where the exception occurred
Exception source$exception_sourcesThe source file(s) where the exception occurred
Exception was handled$exception_handledWhether the exception was handled by the application
Device type$device_typeThe type of device that the error occurred on
Browser$browserThe browser that the error occurred in
Current URL$current_urlThe URL that the error occurred on
Feature flag$feature_flagThe feature flag that the error occurred on

You can also set custom properties on the error tracking event to filter on. For example, setting a custom params_received property to provide more context or debug information.

Order of issue assignment rules

Issue assignment filters are evaluated in the order they are configured. They can also be reordered once created. The first filter that matches is used to assign the issue. This means you should configure the most specific filters first, and then the more general filters later.

Disabled assignment rules

Assignment rules can become disabled if an error occurs during ingestion. When a rule is disabled, a banner displays the original error message. To re-enable the rule, edit it to fix the problem and save your changes. If the issue persists, reach out to support.

Alerting based on assignment

A common use case for automatic issue assignment is to alert assignees of new issues. Once the issues are automatically assigned, you can set up alerts to notify the assignee. See the alerts guide for more information.

Create external issues

You can also create issues in external tracking systems like GitHub Issues, Linear, GitLab, or Jira.

First, set up an integration with your tracking system. Then, from an issue's details page, under External references, click Create issue.

Image: Error tracking create issue in external tracking systemImage: Error tracking create issue in external tracking system

The new issue will have a partial stack trace and a link to the issue in PostHog.

If you use another issue tracking system and would like to request it, let us know in-app.

Community questions

Ask a question

Was this page useful?

HelpfulCould be better

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Created by
PostHog
Publisher
PostHog (Official)
Source
PostHog/skills · skills/posthog/error-tracking/skills/react-native · commit a5d30e7
Licence
MIT License (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced
Also distributed in
PostHog/skills

AutoGineer is not affiliated with or endorsed by PostHog or PostHog.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download error-tracking-react-native.zip