Skip to Content
API ReferenceBegynnOnboarding

BegynnOnboarding

The main component for embedding Begynn onboarding flows.

Import

import { BegynnOnboarding } from "@begynn/react-native";

Basic Usage

<BegynnOnboarding placementId="your-placement-id" onComplete={(event) => { console.log("Completed!", event.payload); }} />

How It Works

BegynnOnboarding renders a WebView that loads your onboarding flow from Begynn’s servers. The component:

  1. Generates (or retrieves) a persistent user ID via AsyncStorage
  2. Loads the onboarding content for your placement
  3. Handles communication between the WebView and your React Native app
  4. Dispatches events as users interact with the onboarding

Props Overview

PropTypeRequiredDescription
placementIdstringYesPlacement ID from Begynn dashboard
isPreviewbooleanNoEnable preview mode
baseUrlstringNoCustom base URL
containerStyleViewStyleNoContainer styling
webViewPropsWebViewPropsNoWebView customization
renderLoading() => ReactElementNoCustom loading component
debugbooleanNoEnable debug logging

See Props for detailed documentation.

Event Handlers

HandlerEvent TypeDescription
onReadyReadyEventOnboarding loaded
onStartOnboardingStartEventUser started
onCompleteOnboardingCompleteEventUser completed
onExitOnboardingExitEventUser exited early
onScreenViewScreenViewEventScreen displayed
onScreenLeaveScreenLeaveEventLeft screen
onNavigationBackNavigationBackEventNavigated back
onButtonClickButtonClickEventButton clicked
onChoiceSelectChoiceSelectEventChoice selected
onChoiceDeselectChoiceDeselectEventChoice deselected
onEventSDKEventAll events
onErrorErrorError occurred

See Events for detailed documentation.

Last updated on