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

# Installation

# Installation

Install the Privacy Boost React Native SDK in your project.

## Requirements

* React Native 0.71+
* iOS 15+ / Android API 26+
* Node.js 20+
* Xcode 15+ (for iOS builds)

## Install

```bash theme={null}
npm install @sunnyside-io/privacy-boost-react-native
```

Or with Yarn:

```bash theme={null}
yarn add @sunnyside-io/privacy-boost-react-native
```

## iOS Setup

After installing, run CocoaPods:

```bash theme={null}
cd ios && pod install
```

The package ships a prebuilt `PrivacyBoostReactNativeFramework.xcframework`
vendored via the podspec — no extra Xcode configuration is needed.

## Android Setup

Auto-linked. The package ships prebuilt Rust static libraries for
`arm64-v8a`, `armeabi-v7a`, and `x86_64`. The Android Gradle build picks
them up via the CMake configuration shipped with the package.

If your app targets architectures outside that set (e.g. `x86` for very old
emulators), you'll need to build the SDK from source — see
[Build from Source](/sdk/react-native/build-from-source).

## Verify Installation

```typescript theme={null}
import { sdkVersion } from '@sunnyside-io/privacy-boost-react-native';

console.log('SDK Version:', sdkVersion());
```

If you see the version string at runtime, the native module loaded correctly.

## Troubleshooting

**`pod install` fails with "No such module 'PrivacyBoostFFI'"**
Clear the CocoaPods cache: `cd ios && pod deintegrate && pod install`.

**Android build fails with "unable to find library libprivacy\_boost\_rn"**
Your app's ABI filters exclude the ones the SDK ships for. Either add
`arm64-v8a` / `armeabi-v7a` / `x86_64` to `abiFilters` in `android/app/build.gradle`,
or build the SDK from source for your target ABI.

## Next Steps

* [Getting Started](/sdk/react-native/getting-started) — Full setup and authentication guide
* [API Reference](/sdk/react-native/api-reference) — Complete API documentation
* [Build from Source](/sdk/react-native/build-from-source) — Build and link the SDK locally