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.

Upgrading to version 19 (July 2026)

Upgrading to version 19 requires React Native 0.82.0 or later 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.

npm install react-native-acoustic-connect@latest

npm install [email protected]

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.

Install react-native-nitro-modules at exactly the version pinned in the SDK's peerDependencies (version 19.0.11 requires 0.35.9):

npm install [email protected]

A version mismatch may cause the SDK to fail at startup — even a patch release can contain breaking changes to the native registration contract.

Reinstall CocoaPods dependencies for iOS.

cd ios && 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 && pod install --repo-update

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