Braze React Native SDK 

- Braze User Guide
- Braze Developer Guide

Quickstart

`` shell
npm install @braze/react-native-sdk
// yarn add @braze/react-native-sdk
`

$3

` groovy
// build.gradle
// ...
dependencies {
...
classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:1.8.10")
}
// ...
`

` xml



YOU_APP_IDENTIFIER_API_KEY
YOUR_CUSTOM_ENDPOINT_OR_CLUSTER

`

` xml



`

$3

` shell
cd ios && pod install
`

` swift
// AppDelegate.swift
import BrazeKit
import braze_react_native_sdk

class AppDelegate: UIResponder, UIApplicationDelegate {
static var braze: Braze? = nil

func application(
_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil
) -> Bool {
// Setup Braze
let configuration = Braze.Configuration(
apiKey: "",
endpoint: ""
)
// - Enable logging or customize configuration here
configuration.logger.level = .info
let braze = BrazeReactBridge.perform(
#selector(BrazeReactBridge.initBraze(_:)),
with: configuration
).takeUnretainedValue() as! Braze

AppDelegate.braze = braze

return true
}
}
`

$3

` typescript
import Braze from "@braze/react-native-sdk";

Braze.changeUser("Jane Doe")
`

See the Braze Developer Guide for advanced integration options.

Version Support

> [!NOTE]
> This SDK has been tested with React Native version 0.83.0.

| Braze Plugin | React Native | Supports New Architecture? |
| ------------ | ------------ | -------------------------- |
| 9.0.0+ | >= 0.71 | ✅ |
| 6.0.0+ | >= 0.68 | ✅ (>= 0.70.0) |
| 2.0.0+ | >= 0.68 | ✅ |
| <= 1.41.0 | <= 0.71 | ❌ |

This SDK additionally inherits the requirements of its underlying Braze native SDKs. Be sure to also adhere to the lists below:
* Android SDK requirements
* Swift SDK requirements

Braze Expo Plugin

If you're using Expo, you can install our plugin to integrate the React Native SDK without any native code. See the Braze Expo Plugin Github for more details.

Running the Sample App

- BrazeProject - Contains the BrazeProject sample app with integration examples for the React Native bridge. This sample app integrates the iOS bridge via manual linking, and the iOS SDK via Cocoapods. It can
also optionally integrate the iOS bridge using CocoaPods via a local Podspec.

The following commands apply to both sample projects and use the BrazeProject directory as an example.

`zsh
cd BrazeProject/
yarn install

In a separate tab:


cd BrazeProject/
npx react-native start
`

$3

Our sample app integrates the native Braze iOS SDK through CocoaPods.

From the BrazeProject directory:
`zsh
sudo gem install cocoapods
cd ios/
pod install # If you are using the legacy bridge architecture, you need to run RCT_NEW_ARCH_ENABLED=0 pod install instead.
cd ../
npx react-native run-ios
`

$3


From the BrazeProject directory:
`zsh
npx react-native run-android
`

Style

- Generally we try to mimic the Braze Web SDK's Javascript interface where appropriate.
- We use ESLint as our linter. From the root directory, run npm run lint to list errors or npm run lint-fix to automatically fix errors. To override the rules in the standard-react config, add "rules" in .eslintrc.json.

Testing

- We use Jest for testing the React Native SDK.
- Run the tests and code coverage report using npm test`

Contact

If you have questions, please contact support@braze.com.