> ## Documentation Index
> Fetch the complete documentation index at: https://docs.prelude.so/llms.txt
> Use this file to discover all available pages before exploring further.

# React Native SDK

> Learn how to use our client side Expo React Native SDK.

<Info>
  We are always happy to help with the implementation of the SDK. If you have any questions, please [reach
  out](mailto:support@prelude.so).
</Info>

<Warning>
  If you find issues uploading your app to the Apple App Store regarding the PreludeCore.xcframework [please follow these steps.](#app-store-upload)
</Warning>

## The React Native Expo SDK

The React Native Expo SDK is published in GitHub at [https://github.com/prelude-so/react-native-sdk](https://github.com/prelude-so/react-native-sdk) .

### Using the Expo React Native SDK

The Expo React Native SDK allows you to capture certain device signals (both in Android and iOS) that will be reported back to Prelude and perform silent verification of mobile devices.

It is provided as an Expo module that you can integrate into your React Native Expo Application.

The Android `minSdkVersion` value in the SDK is set to 26 (Android 8.0). If your application has a lower value you may need to update it.

### Setup

#### Using NPM

The SDK is available in npm. You can install the SDK dependency directly using `npm`:

```
npm install @prelude.so/react-native-sdk
```

#### Using Bun

Bun requires you to trust the `postinstall` script:

```
bun add --trust @prelude.so/react-native-sdk
```

#### Using pnpm

pnpm v10+ requires explicit permission for `postinstall` scripts:

```
pnpm add --allow-build=@prelude.so/react-native-sdk @prelude.so/react-native-sdk
```

You will need to have the Prelude SDK key that you generate in the [Prelude dashboard](https://app.prelude.so/) for your account.

***Important: When you generate the SDK key in the Prelude dashboard, you will be able to copy it, and you should store it somewhere secure, as the dashboard will not allow you to display the same key again.***

#### Gathering Device Signals

**Note**: Starting with v0.3.0 of the SDK, we have removed the status event and made the `dispatchSignals` function return a promise that resolves to the dispatch identifier, simplifying its usage.

To collect the device signals in your application, you can use code like this:

```typescript theme={null}
...
// Import the SDK types
import * as PreludeReactNativeSdk from '@prelude.so/react-native-sdk';
...

...
// Submit the signals in any of your app event handlers (here is a button example)
<Button title={`Dispatch Signals`} onPress={ async () =>
  {
    try {
        const dispatchId = await PreludeReactNativeSdk.dispatchSignals({
          sdk_key: "YOUR_SDK_KEY", // Replace with your Prelude SDK key
        });

        // Handle the dispatch ID as needed,
        // e.g., store it or continue with verification here
        alert(`Dispatch ID: ${dispatchId}`);
    } catch (error) {
        alert(`Signals dispatch error: ${error.message}`);
    }
  }}
/>

```

Then run the Expo application normally (in your application's directory):

```
npx expo run:ios
```

or

```
npx expo run:android
```

Once you get the dispatch identifier through the event, you can report it back to your own API to be forwarded in later network calls, for example, when starting the onboarding verification process for a user.

There are some arguments that you can use to fine-tune the behavior of the `dispatchSignals` function for your use case:

```typescript theme={null}
...
await PreludeReactNativeSdk.dispatchSignals({
  sdk_key: "YOUR_SDK_KEY",
  timeout_milliseconds: 5000, // Optional timeout in milliseconds for each network request (default is 5000 ms)
  max_retries: 3,             // Optional maximum number of automatic retries with exponential backoff for each network request (default is 3)
});
...
```

#### Silent Verification

The Silent Verification feature allows you to verify a phone number without requiring the user to manually enter a verification code.

It is available for certain carriers and requires a server-side service to handle the verification process. For this verification method to work properly, you *must* collect the device signals mentioned before and report the dispatch identifier to your back-end (usually in your APIs verification endpoint).

Please refer to the [Silent Verification documentation](https://docs.prelude.so/verify/v2/documentation/silent-verification) for more information on how to implement this feature.

<h4 id="app-store-upload">
  Uploading your app to the App Store
</h4>

Depending on the mechanism that you use to upload your app to the App Store, you may find errors related to the `PreludeCore.xcframework` file.

If you encounter this error, try uploading the app again with the flag `--use-old-altool`:

```
xcrun altool --upload-app --type ios --file "path/to/your/app.ipa" --apiKey "YourAPIKey" --apiIssuer "YourIssuerID" --use-old-altool
```

If you use `Transporter` it will not allow you to use the `--use-old-altool` flag. You will need to use the `xcrun` command instead.