# React Native New Architecture

Starting in `6.0.0`, the React Native Chat SDK supports the [new architecture](https://reactnative.dev/architecture/landing-page).

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:

| Dependencies                        | Versions   |
| ----------------------------------- | ---------- |
| `@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.

<admonition type="note">

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

</admonition>

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.


---

This page was last updated at 2026-04-17T17:33:45.405Z.

For the most recent version of this documentation, visit [https://getstream.io/chat/docs/sdk/react-native/v8/guides/new-architecture/](https://getstream.io/chat/docs/sdk/react-native/v8/guides/new-architecture/).