React Native New Architecture

Starting in 6.0.0, the React Native Chat SDK supports the new architecture.

For compatibility, use React Native >=0.75.4 (CLI) and Expo SDK >=52.

Best Practices

  • Align all peer dependency versions to avoid build-time surprises.
  • Prefer the newest supported React Native/Expo versions for smoother interop.
  • Test audio features early; they have the most interop caveats.
  • Validate both iOS and Android builds after upgrading architecture settings.
  • Track dependency release notes to catch compatibility changes.

Dependencies

On Native CLI, use these peer dependency versions or higher:

DependenciesVersions
@op-engineering/op-sqlite>=9.3.0
@react-native-clipboard/clipboard>=1.14.1
react-native-blob-util>=0.17.0
@react-native-documents/picker>=10.1.1
react-native-gesture-handler>=2.15.0
react-native-haptic-feedback>=2.2.0
react-native-image-picker>=7.1.1
react-native-reanimated>=3.9.0
react-native-share>=10.0.2
react-native-svg>=15.2.0

Some dependencies are not fully compatible yet:

  • react-native-audio-recorder-player and react-native-video work on interop mode.

Even though these dependencies are not fully compatible, you can still build for iOS and Android.

For Expo, use the latest compatible dependency versions for your Expo SDK.

Known issues and limitations

  • The audio recorder is not fully compatible; you may see issues with react-native-audio-recorder-player.

Please report any issues you encounter.