To update the Connect library in your React Native app, change the version in package.json and reinstall your dependencies. The steps vary slightly depending on which version you're upgrading to — see the sections below. For available versions, see Release notes for mobile Connect SDKs.

Updating from 19.0 to 19.1

Version 19.1 supports React Native 0.84–0.87 and Expo SDK 56–57. It drops React Native 0.82 and 0.83 and Expo SDK 55; apps on those versions can stay on 19.0. No JavaScript API changed, so your app code stays as it is.

Move your app to React Native 0.84 or later with React 19.2.3 or later (on Expo, SDK 56 or later), and Node.js 20.19.4 or later. React Native 0.87 needs Node.js 22.13 or later.
Install the SDK and its peer dependency together. 19.1 needs react-native-nitro-modules at exactly 0.37.1; a mismatched version stops the SDK from starting.
```
npm install react-native-acoustic-connect@^19.1.1 [email protected]
```
If you pin native SDK versions in ConnectConfig.json, update the pins: AndroidVersion must be 11.1.16-beta or later, and iOSVersion must be 2.1.51 or later. To use the newest supported versions, leave both empty.
iOS: run bundle exec pod install in ios/. Expo: re-run npx expo prebuild.
Do a clean rebuild.

Upgrading to version 19 (July 2026)

Upgrading to version 19 requires React Native 0.82–0.87 with the new architecture enabled, a new peer dependency on react-native-nitro-modules, and switching to the canonical react-native-acoustic-connect package. No other changes to your existing app code are required.

Remove the old package: npm uninstall react-native-acoustic-connect-beta.
Install the new version and its peer dependency together.
```
npm install react-native-acoustic-connect@^19.1.1 [email protected]
```
```
npm install react-native-acoustic-connect@~19.0.34 [email protected]
```
react-native-nitro-modules must be exactly the version shown. A version mismatch may cause the SDK to fail at startup.
Update SDK references from react-native-acoustic-connect-beta to react-native-acoustic-connect.

Where these references appear

Any import { Connect } from 'react-native-acoustic-connect-beta' (named import).
Any import AcousticConnectRN from 'react-native-acoustic-connect-beta' (default import).
In ios/Podfile, the require.resolve('react-native-acoustic-connect-beta/cli/ios/connect_pods.rb', ...) path.
In android/app/build.gradle, any require.resolve('react-native-acoustic-connect-beta/package.json') call (this resolves the path to config.gradle — leaving it unchanged breaks the Android build once the beta package is removed).
If you've ever run the postinstall script manually, the path in node node_modules/react-native-acoustic-connect-beta/scripts/postinstall.mjs.

Reinstall CocoaPods dependencies for iOS.

cd ios && bundle exec pod install --repo-update

For Android, trigger a Gradle sync in Android Studio.

Do a clean rebuild: delete android/app/build, android/app/.cxx, and android/build, then sync again. Gradle can reuse cached project references and codegen output from the previous package/version, which surfaces as build errors that look unrelated to the SDK upgrade.
Rebuild the app.

To enable push notifications

Version 19 adds push notification support. To enable it, you need an app key from a Mobile app integration in Connect. Integrations created before April 2026 do not support push. If you have one of these, ask your Connect administrator to replace your app key. For instructions, see Connect mobile apps in the user guide.

Updating to version 18 (April 2026)

Install the new version.

npm install [email protected]

Reinstall CocoaPods dependencies for iOS.

cd ios && bundle exec pod install --repo-update

For Android, trigger a Gradle sync in Android Studio.
Rebuild the app.