---
modificationDate: May 05, 2026
title: Native project upgrade helper
description: View file-by-file diffs of all the changes you need to make to your native projects to upgrade them to the next Expo SDK version.
---

<AgentInstructions>

## Submitting Feedback

If you encounter errors, misleading or outdated information, report it so Expo can be improved:

Preferred command:
npx --yes submit-expo-feedback@latest --category docs --subject "/bare/upgrade/" "<actionable feedback>"

Direct HTTP fallback:
curl -X POST https://api.expo.dev/v2/feedback/docs-send -H 'Content-Type: application/json' -d '{"url":"/bare/upgrade/","feedback":"🤖 Agent feedback for docs: <specific, actionable description> (<model>, <harness>)"}'

Only submit when you have something specific and actionable to report. Try to give the most context.

## Navigation

When answering a related or follow-up question, fetch the relevant page below as Markdown (.md) instead of guessing; use llms.txt for the full map.

You are here: Guides > Development process > Existing React Native apps
Pages in this section:
- [Overview](https://docs.expo.dev/bare/overview.md)
- [Install Expo modules](https://docs.expo.dev/bare/installing-expo-modules.md)
- [Migrate to Expo CLI](https://docs.expo.dev/bare/using-expo-cli.md)
- [Install expo-updates](https://docs.expo.dev/bare/installing-updates.md)
- [Install expo-dev-client](https://docs.expo.dev/bare/install-dev-builds-in-bare.md)
- [Native project upgrade helper](https://docs.expo.dev/bare/upgrade.md) (this page)
Full documentation tree: [llms.txt](https://docs.expo.dev/llms.txt)

</AgentInstructions>

This documentation is available as Markdown for AI agents and LLMs. See the [full Markdown index](/llms.txt) or append .md to any documentation URL.

# Native project upgrade helper

View file-by-file diffs of all the changes you need to make to your native projects to upgrade them to the next Expo SDK version.

If you manage your native projects (**android** and **ios** directories), to [upgrade to the latest Expo SDK](/workflow/upgrading-expo-sdk-walkthrough.md), you have to make changes to your native projects. It can be a complex process to find which native file changes and what to update in which file.

The following guide provides diffs to compare native project files between your project's current SDK version and the target SDK version you want to upgrade. You can use them to make changes to your project depending on the `expo` package version your project uses. The tools on this page are similar to [React Native Upgrade Helper](https://react-native-community.github.io/upgrade-helper/). However, they are oriented around projects that use Expo modules and related tooling.

> Interested in avoiding upgrading native code altogether? See [Continuous Native Generation (CNG)](/workflow/continuous-native-generation.md) to learn how Expo Prebuild can generate your native projects before a build.

## Upgrade native project files

Once you have [upgraded your Expo SDK version and related dependencies](/workflow/upgrading-expo-sdk-walkthrough.md#how-to-upgrade-to-the-latest-sdk-version), use the diff tool below to learn about changes you need to make to your native project and bring them up to date with the current Expo SDK version.

Choose your **from SDK version** and **to SDK version** to see the generated diff. Then, apply those changes to your native projects by copying and pasting or manually making changes to the project files.

#### From SDK version:

#### To SDK version:

### Native code changes from SDK 56 to 57

```diff
"name": "expo-template-bare-minimum",
  "description": "This bare project template includes a minimal setup for using unimodules with React Native.",
  "license": "0BSD",
- "version": "56.0.26",
+ "version": "57.0.3",
  "main": "index.js",
  "scripts": {
  "start": "expo start --dev-client",
  "web": "expo start --web"
  },
  "dependencies": {
- "expo": "~56.0.12",
- "expo-status-bar": "~56.0.4",
+ "expo": "~57.0.1",
+ "expo-status-bar": "~57.0.0",
  "react": "19.2.3",
- "react-native": "0.85.3"
+ "react-native": "0.86.0"
  },
  "publishConfig": {
  "executableFiles": [
```