:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
import { OnboardingComponentsContext, createInstallation } from 'scenes/onboarding/shared/OnboardingDocsContentWrapper'
import { StepDefinition } from '../steps'
export const getReactNativeInstallSteps = (
ctx: OnboardingComponentsContext,
options?: {
minVersion?: string
}
): StepDefinition[] => {
const { CodeBlock, Markdown, dedent } = ctx
const pkg = options?.minVersion ? `posthog-react-native@^${options.minVersion}` : 'posthog-react-native'
return [
{
title: 'Install the package',
badge: 'required',
content: (
<>
<Markdown>Install the PostHog React Native library and its dependencies:</Markdown>
<CodeBlock
blocks={[
{
language: 'bash',
file: 'Expo',
code: dedent`
npx expo install ${pkg} expo-file-system expo-application expo-device expo-localization
`,
},
{
language: 'bash',
file: 'yarn',
code: dedent`
yarn add ${pkg} @react-native-async-storage/async-storage react-native-device-info react-native-localize
# for iOS
cd ios && pod install
`,
},
{
language: 'bash',
file: 'npm',
code: dedent`
npm i -s ${pkg} @react-native-async-storage/async-storage react-native-device-info react-native-localize
# for iOS
cd ios && pod install
`,
},
]}
/>
</>
),
},
{
title: 'Configure PostHog',
badge: 'required',
content: (
<>
<Markdown>
PostHog is most easily used via the `PostHogProvider` component. Wrap your app with the
provider:
</Markdown>
<CodeBlock
blocks={[
{
language: 'tsx',
file: 'App.tsx',
code: dedent`
import { PostHogProvider } from 'posthog-react-native'
export function MyApp() {
return (
<PostHogProvider
apiKey="<ph_project_token>"
options={{
host: "<ph_client_api_host>",
}}
>
<RestOfApp />
</PostHogProvider>
)
}
`,
},
]}
/>
</>
),
},
]
}
export const getReactNativeEventStep = (ctx: OnboardingComponentsContext): StepDefinition => {
const { CodeBlock, Markdown, dedent } = ctx
return {
title: 'Send events',
badge: 'recommended',
content: (
<>
<Markdown>
Once installed, PostHog will automatically start capturing events. You can also manually send events
using the `usePostHog` hook:
</Markdown>
<CodeBlock
blocks={[
{
language: 'tsx',
file: 'Component.tsx',
code: dedent`
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" />
}
`,
},
]}
/>
</>
),
}
}
export const getReactNativeSteps = (
ctx: OnboardingComponentsContext,
options?: {
minVersion?: string
}
): StepDefinition[] => [...getReactNativeInstallSteps(ctx, options), getReactNativeEventStep(ctx)]
export const ReactNativeInstallation = createInstallation(getReactNativeSteps)