How to upgrade an Expo app one SDK version at a time

Upgrade an Expo app one SDK version at a time: on a branch, with one native build, then merge. Expo's own guidance is to move one version at a time, and the steps below follow its upgrade walkthrough.

Fitness Kit ships on Expo SDK 58 ( expo ~58.0.21 , React Native 0.88.1), so the steps below use SDK 58 as the target. Check your own package.json before you start.

The steps

Create a branch. Keep main shippable while you work.

Install the target SDK: npm install expo@^58.0.0 .

Align the rest of the dependencies with it: npx expo install --fix .

Check the project: npx expo-doctor .

Refresh the native projects:

With Continuous Native Generation, delete android/ and ios/ , then regenerate them with npx expo prebuild or npx expo run:ios .

Without it, run npx pod-install and follow the native project upgrade helper.

Read the target SDK changelog, especially "Upgrading your app" at the bottom.

Run the native build once on a device or emulator, then…