PostHog integration for Expo

Workflow

1. basic-integration-1.0-begin.md

   - PostHog Setup - Begin ← Start here

2. basic-integration-1.1-edit.md

   - PostHog Setup - Edit

3. basic-integration-1.2-revise.md

   - PostHog Setup - Revise

4. basic-integration-1.3-conclude.md

   - PostHog Setup - Conclusion

Reference files

• references/EXAMPLE.md

  - Expo example project code

• references/react-native.md

  - React native - 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

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

• posthog-react-native is the React Native SDK package name (same as bare RN)
• Use expo-constants with app.config.js extras for POSTHOG_PROJECT_TOKEN and POSTHOG_HOST (NOT react-native-config)
• Access config via

  Constants.expoConfig?.extra?.posthogProjectToken

  in your posthog.ts config file
• For expo-router, wrap PostHogProvider in app/_layout.tsx and manually track screens with

  posthog.screen(pathname, params)

  in a useEffect
• 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

Identifying users

X-POSTHOG-DISTINCT-ID

X-POSTHOG-SESSION-ID

Error tracking