Expo quickstart

import { FlowPilot } from '@flowpilotjs/react-native-sdk';

FlowPilot.configure({
  apiKey: 'fp_live_xxxxxxxxxxxxxxxx',
  appId: 'your-app-id',
});

import { useEffect, useState } from 'react';
import { useSafeAreaInsets } from 'react-native-safe-area-context';
import {
  FlowPilot,
  FlowPilotPresenter,
  type FlowSession,
} from '@flowpilotjs/react-native-sdk';

export function OnboardingGate() {
  const [session, setSession] = useState<FlowSession | null>(null);
  const insets = useSafeAreaInsets();

  useEffect(() => {
    // resolveSession is non-throwing: returns null when nothing is presentable.
    FlowPilot.resolveSession('onboarding').then(setSession);
  }, []);

  if (!session) return <MyNativeOnboarding />; // host fallback

  return (
    <FlowPilotPresenter
      session={session}
      safeAreaInsets={insets}
      onComplete={({ outcome }) => {
        console.log('Outcome:', outcome);
        setSession(null);
      }}
      fallback={<MyNativeOnboarding />}
    />
  );
}

function handle(result: { outcome: string; error?: Error }) {
  switch (result.outcome) {
    case 'completed':
      // The user finished the flow.
      break;
    case 'dismissed':
      // The user closed the flow before finishing.
      break;
    case 'error':
      // FlowPilot had nothing to present, or rendering failed.
      console.warn(result.error?.message);
      break;
  }
}