Skip to content

Commit 6a02a99

Browse files
docs: document New Architecture requirement for v4
Add a Version Compatibility table so consumers can see at a glance which package line targets which React Native architecture, and include setup steps for enabling the New Architecture on both platforms. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent c8786d2 commit 6a02a99

1 file changed

Lines changed: 16 additions & 1 deletion

File tree

README.md

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,7 @@ which enables developers to delivery best-in-class iOS and Android commerce
2424
experiences.
2525

2626
- [Platform Requirements](#platform-requirements)
27+
- [Version Compatibility](#version-compatibility)
2728
- [Getting Started](#getting-started)
2829
- [1. Installation](#1-installation)
2930
- [2. Minimum Android requirements](#2-minimum-android-requirements)
@@ -64,10 +65,24 @@ experiences.
6465

6566
## Platform Requirements
6667

67-
- **React Native** - Minimum version `0.70`
68+
- **React Native** - Minimum version `0.76` (v4+) / `0.70` (v3 and earlier)
6869
- **iOS** - Minimum version iOS 13
6970
- **Android** - Minimum Java 11 & Android SDK version `23`
7071

72+
## Version Compatibility
73+
74+
Starting with **v4.0.0**, `@shopify/checkout-sheet-kit` requires the React Native
75+
**New Architecture** (TurboModules + Fabric). Apps on the old architecture must
76+
stay on the `v3.x` line until they migrate.
77+
78+
| Package version | React Native | Architecture |
79+
| --------------- | -------------- | ------------------ |
80+
| `4.x` | `>= 0.76` | New Architecture |
81+
| `3.x` | `>= 0.70` | Old Architecture |
82+
83+
See the [React Native upgrade guide](https://reactnative.dev/docs/the-new-architecture/use-the-new-architecture)
84+
for help enabling the New Architecture in your app.
85+
7186
## Getting Started
7287

7388
Shopify Checkout Kit is an open-source NPM package.

0 commit comments

Comments
 (0)