Error Tracking React Native — Agent Skill by PostHog

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

Download the skill as a ZIP:
https://mp-staging.autogineer.com/agent-skills/posthog/error-tracking-react-native/download

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

ATTRIBUTION.mdAdded by AutoGineer981 B
LICENSELicence file added by AutoGineer1.0 KiB
SKILL.md1.8 KiB
references/alerts.md4.1 KiB
references/assigning-issues.md5.5 KiB
references/fingerprints.md3.4 KiB
references/monitoring.md8.6 KiB
references/react-native.md6.2 KiB
references/upload-source-maps.md2.7 KiB

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.

Claude API
AnthropicOfficial
Comprehensive reference for integrating Anthropic's Claude API, SDKs, and Managed Agents into your applications.
Data and AIClaude CodeClaude appsOpenAI Codex+14 more
Apache-2.0Medium riskHas scriptsGitHub stars of the source repository188.6k
Transformers
K-Dense· Community
Integrate Hugging Face Transformers for model loading, inference, and fine-tuning across NLP, vision, and audio tasks.
Data and AIClaude CodeClaude appsOpenAI Codex+14 more
MITLow riskGitHub stars of the source repository56.4k
Open Notebook
K-Dense· Community
Integrate with the self-hosted Open Notebook platform to automate research ingestion, context-aware chat, and AI-driven analysis.
Data and AIClaude CodeClaude appsOpenAI Codex+14 more
MITLow riskHas scriptsGitHub stars of the source repository56.4k
Vision Sft
Seth Hobson· Community
A structured workflow for supervised fine-tuning of vision-language models, focusing on adapter configuration and silent failure prevention.
Data and AIClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository42.3k
LLM Evaluation
Seth Hobson· Community
A comprehensive framework for evaluating LLM application performance using automated metrics, human feedback, and LLM-as-a-judge techniques.
Data and AIClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository42.3k
Lora Qlora Recipes
Seth Hobson· Community
Provides configuration recipes and best-practice hyperparameters for LoRA and QLoRA supervised fine-tuning.
Data and AIClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository42.3k