Integration React React Router 7 Declarative — Agent Skill by PostHog

From the author

PostHog integration for React Router v7 - Declarative mode applications

— the description by PostHog

AutoGineer summary

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

This skill provides a systematic, multi-step process for implementing PostHog analytics, session replay, feature flags, and error tracking within React Router v7 applications. It emphasizes declarative patterns, proper user identification, and the use of environment variables for configuration. The workflow includes a planning phase to identify key business events and ensures that both client-side and server-side tracking are implemented correctly to capture the full user journey.

What it does

Guides the integration of PostHog into React Router v7 projects.
Provides a structured 4-step workflow for setup, editing, revision, and conclusion.
Includes patterns for user identification and error boundary implementation.
Offers best practices for event tracking and feature flag usage.
Ensures consistent environment variable management for API keys.
Supports both client-side event capture and server-side event correlation.

When to use it

When adding PostHog analytics to a new or existing React Router v7 project.
When you need to implement consistent event tracking across a declarative React application.
When you need to correlate client-side sessions with server-side events.
When you want to follow established patterns for error tracking and user identification.

Advantages

Follows a clear, step-by-step procedure to minimize integration errors.
Promotes clean code by separating configuration from business logic.
Ensures critical business events are captured on both client and server.
Provides standardized patterns for React hooks and error handling.

Usage examples

“How do I start integrating PostHog into my React Router v7 app?”: The agent will initiate the workflow by guiding you through the project analysis and the creation of an event tracking plan.
“Where should I place my PostHog capture calls in a declarative component?”: The agent will advise placing capture calls within event handlers rather than useEffect hooks, following the provided framework guidelines.

Install

Download the skill as a ZIP:
https://mp-staging.autogineer.com/agent-skills/posthog/integration-react-react-router-7-declarative/download

Unzip it into the cross-client skills folder of your project:

mkdir -p .agents/skills && unzip integration-react-react-router-7-declarative.zip -d .agents/skills

Documentation by PostHog

PostHog integration for React Router v7 - Declarative mode

This skill helps you add PostHog analytics to React Router v7 - Declarative mode applications.

Workflow

Follow these steps in order to complete the integration:

basic-integration-1.0-begin.md - PostHog Setup - Begin ← Start here
basic-integration-1.1-edit.md - PostHog Setup - Edit
basic-integration-1.2-revise.md - PostHog Setup - Revise
basic-integration-1.3-conclude.md - PostHog Setup - Conclusion

Reference files

references/EXAMPLE.md - React Router v7 - Declarative mode example project code
references/react-router-v7-declarative-mode.md - React router v7 declarative mode - docs
references/identify-users.md - Identify users - docs
references/basic-integration-1.0-begin.md - PostHog setup - begin
references/basic-integration-1.1-edit.md - PostHog setup - edit
references/basic-integration-1.2-revise.md - PostHog setup - revise
references/basic-integration-1.3-conclude.md - PostHog setup - conclusion

The example project shows the target implementation pattern. Consult the documentation for API details.

Key principles

Environment variables: Always use environment variables for PostHog keys. Never hardcode them.
Minimal changes: Add PostHog code alongside existing integrations. Don't replace or restructure existing code.
Match the example: Your implementation should follow the example project's patterns as closely as possible.

Framework guidelines

For feature flags, use useFeatureFlagEnabled() or useFeatureFlagPayload() hooks - they handle loading states and external sync automatically
Add analytics capture in event handlers where user actions occur, NOT in useEffect reacting to state changes
Do NOT use useEffect for data transformation - calculate derived values during render instead
Do NOT use useEffect to respond to user events - put that logic in the event handler itself
Do NOT use useEffect to chain state updates - calculate all related updates together in the event handler
Do NOT use useEffect to notify parent components - call the parent callback alongside setState in the event handler
To reset component state when a prop changes, pass the prop as the component's key instead of using useEffect
useEffect is ONLY for synchronizing with external systems (non-React widgets, browser APIs, network subscriptions)

Identifying users

Identify users during login and signup events. Refer to the example code and documentation for the correct identify pattern for this framework. If both frontend and backend code exist, pass the client-side session and distinct ID using X-POSTHOG-DISTINCT-ID and X-POSTHOG-SESSION-ID headers to maintain correlation.

Error tracking

Add PostHog error tracking to relevant files, particularly around critical user flows and API boundaries.

Files

ATTRIBUTION.mdAdded by AutoGineer1.0 KiB
LICENSELicence file added by AutoGineer1.0 KiB
SKILL.md3.0 KiB
references/EXAMPLE.md15.0 KiB
references/basic-integration-1.0-begin.md2.1 KiB
references/basic-integration-1.1-edit.md2.5 KiB
references/basic-integration-1.2-revise.md937 B
references/basic-integration-1.3-conclude.md1.6 KiB
references/identify-users.md8.1 KiB
references/react-router-v7-declarative-mode.md11.6 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.

Build MCP App
AnthropicOfficial
Build interactive UI widgets for MCP servers to render forms, pickers, and dashboards directly within the chat interface.
Automation and integrationsClaude CodeClaude appsOpenAI Codex+14 more
Apache-2.0GitHub stars of the source repository46.3k
MCP Integration
AnthropicOfficial
Comprehensive guide for integrating Model Context Protocol (MCP) servers into Claude Code plugins.
Automation and integrationsClaude CodeClaude appsOpenAI Codex+14 more
Apache-2.0GitHub stars of the source repository46.3k
Social Publishing
Seth Hobson· Community
Programmatically schedule and publish content across 13 social media platforms using the SocialClaw API.
Automation and integrationsClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository42.3k
Hermes Tweet
Seth Hobson· Community
Integrates X/Twitter research and action capabilities into the Hermes Agent framework with strict approval-gated security.
Automation and integrationsClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository42.3k
Paypal Integration
Seth Hobson· Community
A guide to integrating PayPal payment processing, including checkout flows, subscriptions, and IPN webhook handling.
Automation and integrationsClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository42.3k
Social Publishing Publisher
Seth Hobson· Community
An agent-driven social media publishing specialist for multi-platform campaign management via the SocialClaw API.
Automation and integrationsClaude Code
MITGitHub stars of the source repository42.3k

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download integration-react-react-router-7-declarative.zip