references/react-native.md
AI agents: this is one page from PostHog's docs. Full index of Markdown docs for LLMs: https://posthog.com/llms.txt
React Native Feature Flags installation
Canonical URL: https://posthog.com/docs/feature-flags/installation/react-native
Cloud region: This page uses US Cloud hosts. For an EU Cloud project, use
https://eu.i.posthog.cominstead ofhttps://us.i.posthog.com(ingestion host).
On this page
- Install with the wizard
- Install the package
- Configure PostHog
- Send events
- Use feature flags
- Running experiments
- Next steps
Install with the wizard
Run this command in your project directory to add PostHog to your React Native project. The wizard detects your framework, installs the SDK, and sets up your first events.
npx @posthog/wizard
Or set it up manually by following the rest of this guide.
-
1
Install the package
Required
Install the PostHog React Native library and its dependencies:
Expo
npx expo install posthog-react-native expo-file-system expo-application expo-device expo-localizationyarn
yarn add posthog-react-native @react-native-async-storage/async-storage react-native-device-info react-native-localize # for iOS cd ios && pod installnpm
npm i -s posthog-react-native @react-native-async-storage/async-storage react-native-device-info react-native-localize # for iOS cd ios && pod install -
2
Configure PostHog
Required
PostHog is most easily used via the
PostHogProvidercomponent. Wrap your app with the provider:App.tsx
import { PostHogProvider } from 'posthog-react-native' export function MyApp() { return ( <PostHogProvider apiKey="<ph_project_token>" options={{ host: "https://us.i.posthog.com", }} > <RestOfApp /> </PostHogProvider> ) } -
3
Send events
Recommended
Once installed, PostHog will automatically start capturing events. You can also manually send events using the
usePostHoghook:Component.tsx
import { usePostHog } from 'posthog-react-native' function MyComponent() { const posthog = usePostHog() const handlePress = () => { posthog.capture('button_pressed', { button_name: 'signup' }) } return <Button onPress={handlePress} title="Sign Up" /> } -
4
Use feature flags
Required
PostHog provides hooks to make it easy to use feature flags in your React Native app. Use
useFeatureFlagEnabledfor boolean flags:Component.tsx
import { usePostHog } from 'posthog-react-native' function MyComponent() { const posthog = usePostHog() const isMyFlagEnabled = posthog.isFeatureEnabled('flag-key') if (isMyFlagEnabled) { // Do something differently for this user // Optional: fetch the payload const matchedFlagPayload = posthog.getFeatureFlagResult('flag-key')?.payload } return <View>...</View> }Multivariate flags
For multivariate flags, use
getFeatureFlag:Component.tsx
import { usePostHog } from 'posthog-react-native' function MyComponent() { const posthog = usePostHog() const enabledVariant = posthog.getFeatureFlag('flag-key') if (enabledVariant === 'variant-key') { // replace 'variant-key' with the key of your variant // Do something differently for this user // Optional: fetch the payload const matchedFlagPayload = posthog.getFeatureFlagResult('flag-key')?.payload } return <View>...</View> } -
5
Running experiments
Optional
Experiments run on top of our feature flags. Once you've implemented the flag in your code, you run an experiment by creating a new experiment in the PostHog dashboard.
-
6
Next steps
Recommended
Now that you're evaluating flags, continue with the resources below to learn what else Feature Flags enables within the PostHog platform.
| Resource | Description | | --- | --- | | Creating a feature flag | How to create a feature flag in PostHog | | Adding feature flag code | How to check flags in your code for all platforms | | Framework-specific guides | Setup guides for React Native, Next.js, Flutter, and other frameworks | | How to do a phased rollout | Gradually roll out features to minimize risk | | More tutorials | Other real-world examples and use cases |