Quick Start

Get from zero to a working onboarding flow in under 10 minutes.

①Install→

③SDK Key→

Install the SDK

Add recus-react-native to your React Native project.

bash

npm install recus-react-native

Compatibility

Recus works with Expo (SDK 49+) and bare React Native (0.72+). No native linking required — pure JavaScript.

Create an account and your first App

Head to recus.app and sign up. After signing in you'll land on your dashboard.

Create an App

An App in Recus represents your React Native application. Each App:

Has its own SDK key
Can have multiple onboarding flows
Has its own analytics and user data

Click ‘New App’ → give it a name (e.g. ‘My Health App’) → click Create.

recus.app/dashboard

My Apps

+ New App

My Health App

2 flows · 1,240 MAU

SDK key: pk_live_...

+ Create new app

Copy your SDK key

Inside your App, go to Settings → SDK Keys.

Key	Prefix	Use
Publishable key	`pk_live_`	In your React Native app — safe to expose
Secret key	`sk_live_`	On your server only — never in the app

Copy the publishable key (pk_live_...). This is what you'll pass to the SDK.

Never use your secret key (sk_live_) in your React Native app. It provides full API access to your account and should only be used on your backend server.

Wrap your app with RecusAppProvider

app/_layout.tsx

// app/_layout.tsx
import { RecusAppProvider } from 'recus-react-native'
import { Stack } from 'expo-router'
import { useAuth } from '../hooks/useAuth'

export default function RootLayout() {
  const { user } = useAuth()

  return (
    <RecusAppProvider
      sdkKey="pk_live_xxxxxxxxxxxx"
      user={user ? {
        userId: user.id,
        email:  user.email,
        name:   user.name,
      } : undefined}
    >
      <Stack />
    </RecusAppProvider>
  )
}

How it works

RecusAppProvider sits above your entire app. When user is undefined(not logged in yet) Recus does nothing — it's completely invisible. The moment user.userIdis set, Recus checks if that user needs to complete onboarding. If they do, the onboarding flow appears above your app. If they've already completed it, nothing happens. Your existing navigation is never touched.

Create a flow in the dashboard

Back in the Recus dashboard, inside your App:

Click ‘New Flow’
Give it a name — e.g. ‘User Onboarding’
Click Create

You'll enter the flow editor. Add your first screen:

Click ‘Add Screen’
A new screen appears with a blank canvas
Set a background color, gradient, or image
Add inputs — name, email, role selector, etc.
Add a Continue button

Repeat for as many screens as you need. When you're ready: click Publish → your flow is live instantly.

See it working

Run your app. Sign in with a test user.

The moment the user object is set in RecusAppProvider, Recus will check if that user has completed onboarding. Since they haven't — your flow will appear.

Fill the screens, tap Continue, complete the flow. Reload the app — the flow won't appear again for that user.

That's it. You're live.

You've set up Recus

From here you can:

→ Add more screens to your flow
→ Make fields mandatory
→ View drop-off analytics in the dashboard
→ Set up webhooks to receive completed data
→ Create multiple flows for different user segments