Skip to content

Commit f89f117

Browse files
committed
docs: add new architecture guide
1 parent 13683b2 commit f89f117

File tree

2 files changed

+43
-0
lines changed

2 files changed

+43
-0
lines changed
Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
---
2+
id: new-architecture
3+
title: React Native New Architecture
4+
---
5+
6+
Starting v6 we support the [new architecture](https://reactnative.dev/architecture/landing-page) for the React Native Chat SDK.
7+
8+
To be compatible with the new architecture, it is recommended that you use React Native version `0.75.4` and above.
9+
10+
### Dependencies
11+
12+
We recommend you to be on the following versions or higher of the peer dependencies to be able to run the new architecture:
13+
14+
| Dependencies | Versions |
15+
| ----------------------------------- | ---------- |
16+
| `@op-engineering/op-sqlite` | `>=9.3.0` |
17+
| `@react-native-clipboard/clipboard` | `>=1.4.1` |
18+
| `react-native-blob-util` | `>=0.17.0` |
19+
| `react-native-document-picker` | `>=9.1.1` |
20+
| `react-native-gesture-handler` | `>=2.15.0` |
21+
| `react-native-haptic-feedback` | `>=2.2.0` |
22+
| `react-native-image-picker` | `>=7.1.1` |
23+
| `react-native-reanimated` | `>=3.9.0` |
24+
| `react-native-share` | `>=10.0.2` |
25+
| `react-native-svg` | `>=15.2.0` |
26+
27+
Few of the dependencies we rely on are not fully new architecture compatible yet.
28+
29+
1. `react-native-audio-recorder-player` and `react-native-video` work on interop mode.
30+
2. `react-native-document-picker` doesn't support the bridgeless mode. Please use [`@react-native-documents/picker`](https://react-native-documents.github.io/docs/sponsor-only/intro) if you want the bridgeless mode. You can register your own native handler with us using our [Native Handler](../customization/native-handlers.mdx) guide.
31+
32+
:::note
33+
Although the above dependencies are not fully compatible with the new architecture, you can still use them in your project. They doesn't stop you from building the app on both iOS and Android.
34+
:::
35+
36+
### Known issues and limitations
37+
38+
- The cameraroll is not compatible with the image resizer on new architecture, so we suggest using native image picker for now. You can read [the guide](./native-image-picker.mdx) here.
39+
- The audio recorder is not compatible with the new architecture, so you might face some issues while recording the audio and playing it using `react-native-audio-recorder-player`. We are working on it to fix the issues.
40+
- The image gallery animations behaves differently and seem to be a bit laggy on the new architecture specially when you use the pan gesture to drag down the image. We are working on it to fix the issues.
41+
42+
Please feel free to report any issues you face while using the new architecture.

docusaurus/sidebars-react-native.json

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -157,6 +157,7 @@
157157
"guides/audio-messages-support",
158158
"guides/date-time-formatting",
159159
"guides/native-image-picker",
160+
"guides/new-architecture",
160161
"customization/typescript",
161162
"basics/troubleshooting",
162163
"basics/stream_chat_with_navigation",

0 commit comments

Comments
 (0)