Skip to content

Commit e9dc10e

Browse files
Release v5.0.0-beta.1 (#1179)
1 parent c5d608a commit e9dc10e

File tree

2 files changed

+72
-3
lines changed

2 files changed

+72
-3
lines changed

MIGRATION_GUIDE.md

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,71 @@
11
# Migration Guide
22

3+
## Upgrading from v4 -> v5
4+
5+
### Compatibility Requirements
6+
7+
- **React**: v5 requires React 19 or higher
8+
- **React Native**: v5 requires React Native 0.78.0 or higher
9+
- **Expo**: v5 requires Expo 53 or higher
10+
11+
### Breaking Changes
12+
13+
- **Platform Compatibility**: The minimum iOS deployment target is now 14.0. Update your iOS/Podfile with:
14+
15+
```
16+
platform :ios, '14.0'
17+
```
18+
19+
- **Android Requirements**: Android SDK API level 35 or higher is now required
20+
21+
### Migration Steps
22+
23+
#### For Regular React Native Projects
24+
25+
1. First, ensure your project uses React 19 and React Native 0.78.0 or higher:
26+
27+
```bash
28+
npm install react@^19.0.0
29+
npm install react-native@^0.78.0
30+
```
31+
32+
2. Update the react-native-auth0 package:
33+
34+
```bash
35+
npm install react-native-auth0@beta
36+
```
37+
38+
3. Update your iOS minimum deployment target in your Podfile:
39+
40+
```ruby
41+
platform :ios, '14.0'
42+
```
43+
44+
4. Install the updated pods:
45+
```bash
46+
cd ios && pod install && cd ..
47+
```
48+
49+
#### For Expo Projects
50+
51+
1. Update to Expo 53 or higher:
52+
53+
```bash
54+
npx expo upgrade
55+
```
56+
57+
2. Update the react-native-auth0 package:
58+
59+
```bash
60+
npm install react-native-auth0@beta
61+
```
62+
63+
3. Rebuild your app:
64+
```bash
65+
npx expo prebuild --clean
66+
```
67+
Note: This will reset any manual changes to your native code.
68+
369
## Upgrading from v3 -> v4
470

571
- **If your project is built with Expo:**

README.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,10 +9,13 @@
99

1010
📚 [Documentation](#documentation) • 🚀 [Getting Started](#getting-started) • ⏭️ [Next Steps](#next-steps) • ❓ [FAQs](https://github.com/auth0/react-native-auth0/blob/master/FAQ.md) • ❓ [Feedback](#feedback)
1111

12-
### ⚠️ Important Migration Notice: v4.0.0
12+
### ⚠️ Important Migration Notice: v4.0.0 and v5.0.0beta
1313

14-
We're excited to announce the release of react-native-auth0 `v4.0.0`! Please note that this update includes breaking changes that require your attention. To ensure a smooth transition, please review our
15-
👉 [Migration Guide](https://github.com/auth0/react-native-auth0/blob/master/MIGRATION_GUIDE.md) 👈 for detailed instructions on updating your integration.
14+
We're excited to announce the release of react-native-auth0 `v4.0.0` and the beta release of `v5.0.0`!
15+
16+
**For v4.0.0 users:** Please note that this update includes breaking changes that require your attention. To ensure a smooth transition, please review our 👉 [Migration Guide](https://github.com/auth0/react-native-auth0/blob/master/MIGRATION_GUIDE.md) 👈 for detailed instructions on updating your integration.
17+
18+
**For v5.0.0beta users:** This beta version requires React 19 and React Native 0.78.0 or higher. If you're using Expo, this version requires Expo 53 or higher. See the 👉 [Migration Guide](https://github.com/auth0/react-native-auth0/blob/beta/MIGRATION_GUIDE.md) 👈 for compatibility requirements and upgrade instructions.
1619

1720
## Documentation
1821

0 commit comments

Comments
 (0)