React Native SDK

npm install @growth-rail/react-native @growth-rail/core
# or
yarn add @growth-rail/react-native @growth-rail/core

import { GrowthRailProvider } from '@growth-rail/react-native';

export default function App() {
  return (
    <GrowthRailProvider
      projectSecretKey="sk_your_project_secret"
      userId={userId}       // optional: auto-init user
      debug={__DEV__}        // verbose logging in dev
    >
      <Navigation />
    </GrowthRailProvider>
  );
}

import { useGrowthRail } from '@growth-rail/react-native';

function MyScreen() {
  const {
    // Methods
    initAppUser,
    showReferralDashboard,
    hideReferralDashboard,
    showFloatingButton,
    hideFloatingButton,
    getReferralTrackingId,
    getAttributionToken,
    getReferralLink,

    // State
    isInitialized,
    isUserReady,
    isLoading,
    isDebugEnabled,
    error,
  } = useGrowthRail();

  // ...
}

import { ReferralDashboard } from '@growth-rail/react-native';

function ReferralsScreen() {
  return (
    <View style={{ flex: 1 }}>
      <ReferralDashboard
        title="Invite Friends"
        onLinkCopied={() => Alert.alert('Link copied!')}
      />
    </View>
  );
}

import { TriggerButton } from '@growth-rail/react-native';

function HomeScreen() {
  return (
    <View style={{ flex: 1 }}>
      {/* Your screen content */}
      <TriggerButton position="bottom-right" />
    </View>
  );
}

import { Banner } from '@growth-rail/react-native';

function SignupScreen() {
  return (
    <View style={{ flex: 1 }}>
      <Banner position="center-top" />
      {/* Your signup form */}
    </View>
  );
}

// The SDK automatically handles deep link URLs like:
// yourapp://open?referralCode=ABC123&rewardEventName=user_signup

// For manual handling with React Navigation:
import { useGrowthRail } from '@growth-rail/react-native';

function DeepLinkHandler({ url }) {
  const { trackReferral } = useGrowthRail();

  useEffect(() => {
    if (url) {
      const params = new URLSearchParams(url.split('?')[1]);
      const code = params.get('referralCode');
      if (code) {
        trackReferral(code, params.get('rewardEventName'));
      }
    }
  }, [url]);
}

import React, { useEffect } from 'react';
import { View, Button, Alert } from 'react-native';
import { GrowthRailProvider, useGrowthRail } from '@growth-rail/react-native';

// 1. Wrap your app
export default function App() {
  return (
    <GrowthRailProvider
      projectSecretKey="sk_your_project_secret"
      debug={__DEV__}
    >
      <MainScreen />
    </GrowthRailProvider>
  );
}

// 2. Use the hook in your screens
function MainScreen() {
  const {
    initAppUser,
    showReferralDashboard,
    isUserReady,
    isLoading,
  } = useGrowthRail();

  // Register user after auth
  useEffect(() => {
    initAppUser('user_123');
  }, []);

  // Show referral UI
  const handleInvite = () => {
    showReferralDashboard({
      title: 'Invite Friends',
      description: 'Share your link and earn 500 credits!',
    });
  };

  return (
    <View style={{ flex: 1, justifyContent: 'center', padding: 20 }}>
      <Button
        title="Invite Friends"
        onPress={handleInvite}
        disabled={!isUserReady}
      />
      <Button
        title="Track Signup Reward"
        onPress={handleSignupComplete}
        disabled={isLoading}
      />
    </View>
  );
}