Expo Router en el SDK 56: cómo migrar los imports de React Navigation
En la práctica/ 12 min de lectura
Expo Router ya no depende de React Navigation desde el SDK 56: los imports nuevos, el codemod que probamos, librerías de terceros y qué cambió en SDK 57 y 58.
- React
- Migración
En este artículo (10)
En el SDK 56, Expo Router dejó de depender de React Navigation: Expo hizo un fork de las partes que usaba y ahora viven dentro del paquete. Tu app ya no puede importar de @react-navigation/*; esos imports pasan a expo-router/react-navigation y a tres rutas nuevas. La API es la misma y un codemod hace casi todo.
Aquí tienes qué cambió y qué no, la tabla de imports, el comando exacto del codemod y lo que hace con los casos que no sabe resolver, qué pasa con las librerías de terceros y cómo probar en iOS y Android. Lo comparamos con el anuncio de Expo del 28 de mayo de 2026 y con la guía oficial, y corrimos el codemod sobre archivos de prueba.
Qué cambió en Expo Router con el SDK 56
El SDK 56 salió el 21 de mayo de 2026 con React Native 0.85 y React 19.2. Una semana después, Expo explicó el cambio más grande de esa versión: Expo Router hizo un fork de las partes de React Navigation sobre las que está construido. Según el anuncio, lo hablaron con Satya, quien mantiene React Navigation, y acordaron que era lo mejor para los dos proyectos. Las razones que da Expo son técnicas: más control sobre los internos para cosas propias del enrutamiento por archivos, la web y el render en servidor; menos código de parche; y evitar un problema de versiones, porque había proyectos que terminaban con varias copias de React Navigation instaladas.
La consecuencia está en una frase de la guía de migración: en el SDK 56 y posteriores, Expo Router ya no admite imports de los paquetes externos @react-navigation/* en el código de tu app. Si dejas uno, el bundler se detiene. Este es el mensaje, tal como está en el resolver de Metro de @expo/cli 56.1.27:
As of SDK 56, expo-router is no longer compatible with react-navigation.
For more information, see https://docs.expo.dev/router/migrate/sdk-55-to-56/.
You can disable this check by setting the environment variable
EXPO_ROUTER_DISABLE_RN_NAVIGATION_CHECK=1.
- La primera línea dice qué pasó: el import viene de tu código y apunta a
@react-navigation/*. - La segunda te manda a la guía oficial; la seguimos en este artículo.
- Las dos últimas dan la variable para apagar la comprobación. Sirve para salir del paso, no para quedarte así (más abajo explicamos qué más apaga).
Si el import es de @react-navigation/native-stack o @react-navigation/drawer, el mensaje añade el reemplazo: Stack de expo-router y Drawer de expo-router/drawer. Un detalle de nombres: la versión anterior se llamaba Router v6 y Expo cambió la convención, así que ahora la versión de Expo Router sigue al SDK. En npm, el SDK 56 instala expo-router 56.x.
La versión trae más cosas que no exigen cambios para migrar: render en servidor con streaming (opción unstable_useServerRendering), generateMetadata, los helpers createStaticLoader y createServerLoader, un SuspenseFallback que puedes exportar desde un _layout, la barra de herramientas en Android y la propiedad disabled en Native Tabs. El mismo SDK dejó estable a Expo UI, que da SwiftUI y Jetpack Compose desde React Native.
Desliza la figura para verla completa
Qué no cambia
La guía lo resume así: la API en tiempo de ejecución no cambia, solo se mueven las rutas de los módulos. ThemeProvider, DarkTheme, useIsFocused, useNavigation o HeaderBackButton siguen teniendo el mismo nombre y se usan igual; cambia de dónde los importas. Tus rutas en app/, los _layout, Stack, Tabs, Link y useRouter ya se importaban de expo-router y siguen igual.
Tampoco desaparece React Navigation. Sigue mantenido por su equipo y puedes usarlo en un proyecto de Expo sin Expo Router; las notas del SDK 56 incluyen la plantilla (npx create-expo-app@latest --template react-navigation/template) y recuerdan que las dos librerías se apoyan en react-native-screens. Lo que ya no funciona es mezclarlas: si tienes expo-router y react-navigation instalados a la vez, expo-doctor del SDK 56 te avisa, porque probablemente no es lo que quieres.
Los imports nuevos
Esta es la tabla de la guía de migración de SDK 55 a 56. Revisamos el código del codemod y usa exactamente el mismo mapa:
| Antes (React Navigation) | Después (Expo Router 56) |
|---|---|
@react-navigation/native | expo-router/react-navigation |
@react-navigation/core | expo-router/react-navigation |
@react-navigation/elements | expo-router/react-navigation |
@react-navigation/routers | expo-router/react-navigation |
@react-navigation/stack | expo-router/js-stack |
@react-navigation/bottom-tabs | expo-router/js-tabs |
@react-navigation/material-top-tabs | expo-router/js-top-tabs |
@react-navigation/native-stack | Sin equivalente directo: usa el layout Stack |
@react-navigation/drawer | Sin equivalente directo: usa el layout Drawer |
Desliza la figura para verla completa
El ejemplo de la guía, con dos imports típicos de una app con Expo Router:
// Antes (SDK 55)
import { ThemeProvider, DarkTheme } from '@react-navigation/native';
import { createMaterialTopTabNavigator } from '@react-navigation/material-top-tabs';
// Después (SDK 56)
import { ThemeProvider, DarkTheme } from 'expo-router/react-navigation';
import { createMaterialTopTabNavigator } from 'expo-router/js-top-tabs';
- El tema (
ThemeProvideryDarkTheme) venía de@react-navigation/native; ahora sale deexpo-router/react-navigation, que agrupa lo que antes venía denative,core,elementsyrouters. - Las pestañas superiores se creaban con el paquete de material-top-tabs; ahora la función sale de
expo-router/js-top-tabs. - Los nombres importados no cambian, y el resto del archivo tampoco.
Un caso que la tabla no cuenta. Comprobamos los tipos de expo-router 56.0.0 y 56.2.22: expo-router/js-stack solo exporta Stack, el layout de stack en JavaScript. Si tu código importaba createStackNavigator o TransitionPresets de @react-navigation/stack, la ruta nueva no los tiene en el SDK 56 y TypeScript falla. Usa el Stack de expo-router/js-stack como layout. En expo-router 57 sí se reexportan, y el SDK 58 vuelve a quitar createStackNavigator.
El codemod
El comando sale tal cual del anuncio y de la guía. Córrelo desde la raíz del proyecto y cambia src por la carpeta o el glob donde está tu código (en muchos proyectos con Expo Router es app, y quizá también components):
npx expo-codemod sdk-56-expo-router-react-navigation-replace src
# o con otro gestor de paquetes
yarn dlx expo-codemod sdk-56-expo-router-react-navigation-replace src
pnpm dlx expo-codemod sdk-56-expo-router-react-navigation-replace src
bunx expo-codemod sdk-56-expo-router-react-navigation-replace src
Lo probamos con expo-codemod 58.0.1 (la versión actual en npm, que sigue incluyendo esta transformación) sobre cinco archivos de prueba. Tres tenían imports normales, uno usaba import * as Nav y otro importaba de native-stack. Esta es la salida, resumida:
Transforming 5 TSX files...
src/components/Legacy.tsx:1 - namespace import (import * as ...) from "@react-navigation/native" is not supported.
src/components/OldStack.tsx:1 - import from "@react-navigation/native-stack" cannot be migrated. Use the `Stack` layout (https://docs.expo.dev/router/advanced/stack/) instead
Results:
0 errors
2 skipped
3 ok
- 3 ok: los tres archivos con imports con nombre quedaron reescritos.
- Import de espacio de nombres: el codemod solo reescribe imports con nombre (
import { A } from). Conimport * aso un import por defecto deja el archivo igual y te pide cambiarlo a mano. Lo cambiamos aimport { useNavigation }, lo corrimos otra vez y pasó. - native-stack: el archivo se salta completo. También quedó sin tocar su otro import, de
@react-navigation/native, que sí tenía equivalente. Hasta que reemplaces el stack, ese archivo sigue con dos imports viejos.
Así quedó el _layout.tsx de prueba, que tenía tres imports de React Navigation:
// Antes
import { ThemeProvider, DarkTheme, DefaultTheme } from '@react-navigation/native';
import type { Theme } from '@react-navigation/native';
import { HeaderBackButton } from '@react-navigation/elements';
// Después del codemod
import { ThemeProvider, DarkTheme, DefaultTheme, type Theme, HeaderBackButton } from "expo-router/react-navigation";
- Los tres imports apuntaban a paquetes que ahora tienen el mismo destino, así que el codemod los juntó en uno.
- El import de solo tipos (
import type { Theme }) se conservó comotype Themedentro de la línea. - La línea nueva lleva comillas dobles, y en Windows el archivo quedó con saltos de línea CRLF. Pasa tu formateador y revisa el diff antes de hacer commit.
Desliza la figura para verla completa
El resultado pasa tsc --strict contra los tipos de expo-router 56.2.22. Después, busca lo que quedó. Este comando lista cada import que siga apuntando a React Navigation; si no imprime nada, terminaste:
grep -rnE "from ['\"]@react-navigation/" app src components
Con nuestros archivos de prueba, antes de arreglar el import de espacio de nombres, imprimió las tres líneas que esperábamos: la de Legacy.tsx y las dos de OldStack.tsx. Ajusta las carpetas a tu proyecto.
Librerías de terceros
Muchas librerías siguen importando de @react-navigation/core. Para que no se rompan, Expo CLI reescribe esos imports a expo-router/react-navigation cuando vienen de node_modules. Tu código no se toca con esto. La guía lo llama un arreglo temporal y promete una guía para autores de librerías antes de quitarlo, y el anuncio habla de una API compartida que Expo y el equipo de React Navigation están preparando para librerías que quieran soportar las dos.
Ojo con el alcance. En el código de @expo/cli 56 y 57, la reescritura solo cubre @react-navigation/core. Si una librería importa @react-navigation/native u otro paquete, se resuelve como cualquier dependencia y puede terminar usando un React Navigation distinto del que usa tu app. Para saber qué dependencias los traen:
npm ls @react-navigation/core @react-navigation/native
Cada rama del árbol es un paquete que depende de React Navigation. Revisa en su repositorio si ya tiene versión para el SDK 56 y prueba la pantalla donde la usas. Con yarn o pnpm, yarn why o pnpm why hacen lo mismo. Cuando tu código ya no importe React Navigation, quita de tu package.json los paquetes @react-navigation/* que instalaste tú y vuelve a correr npx expo-doctor.
La variable EXPO_ROUTER_DISABLE_RN_NAVIGATION_CHECK=1 apaga las dos cosas a la vez: la reescritura de las librerías y el error del bundler para tu código. Úsala solo para aislar un problema.
Probar en iOS y Android
El orden que sigue la guía de actualización de Expo: instalar la versión nueva de expo, alinear dependencias y revisar el proyecto. Después, compila en los dos sistemas:
npm install expo@^56.0.0
npx expo install --fix
npx expo-doctor
npx expo start --clear
npx expo run:ios
npx expo run:android
npm install expo@^56.0.0sube el SDK.npx expo install --fixpone el resto de paquetes de Expo, incluidoexpo-router, en las versiones de ese SDK.npx expo-doctorrevisa problemas comunes; en el SDK 56 también avisa sireact-navigationsigue instalado junto aexpo-router.npx expo start --cleararranca Metro con la caché vacía, para que no sirva imports viejos.npx expo run:ioscompila la app de iOS en local (necesita una Mac con Xcode).npx expo run:androidhace lo mismo para Android.
Qué revisar a mano, en los dos sistemas: el tema claro y oscuro, los encabezados y el botón de volver, las pestañas, los enlaces profundos, las pantallas que usan useIsFocused o useFocusEffect, y cada pantalla que use una librería de navegación de terceros. Si tu app también corre en web, ábrela; ahí está lo nuevo de render en servidor. Y si en la misma actualización estás moviendo módulos nativos, lee primero cómo migrar a la arquitectura nueva de React Native.
Después del SDK 56: qué cambió en SDK 57 y SDK 58
Esto no se quedó quieto. El SDK 57 (30 de junio de 2026) es una versión pequeña: sube React Native a 0.86 sin cambios incompatibles en Expo Router. El SDK 58 (15 de octubre de 2026) sí cambia mucho: rehízo el núcleo de navegación de Expo Router y quitó la mayor parte de la API copiada de React Navigation. Según la guía de SDK 57 a 58, ya no existen en expo-router/react-navigation, entre otras, NavigationContainer, el Link de React Navigation y beforeRemove, y createStackNavigator salió de expo-router/js-stack.
También desapareció el arreglo temporal. El changelog de Expo CLI registra en la versión 58.0.2 (15 de septiembre de 2026) que se quitaron las comprobaciones de compatibilidad con los paquetes @react-navigation. Lo confirmamos en @expo/cli 58.1.21: ni el error ni la reescritura están. En el SDK 58 ese mensaje ya no aparece: si el paquete viejo sigue instalado, el import se resuelve a él sin aviso, así que la búsqueda con grep importa más. Si vienes del 55, haz la migración del 56 completa antes de seguir: Expo recomienda subir un SDK a la vez.
Errores comunes
- Correr el codemod solo en
src. En muchos proyectos el código está enappycomponents. Pásale todas las carpetas o un glob. - Creer que "2 skipped" está resuelto. Los archivos saltados no cambiaron. Arréglalos a mano y vuelve a correrlo.
- Esperar que el codemod migre
native-stackodrawer. No tienen equivalente: hay que pasar a los layoutsStackyDrawer. - Importar
createStackNavigatordeexpo-router/js-stacken el SDK 56. Ahí solo existeStack. - Dejar la variable de entorno puesta. Apaga también el error que te avisa de imports viejos en tu código.
- Probar solo en Expo Go o solo en un sistema. Compila iOS y Android y prueba las pantallas con librerías de navegación.
- Saltar del 55 al 58 de golpe. Juntas dos migraciones de navegación en un solo diff.
Preguntas frecuentes
¿Tengo que reescribir mi navegación?
No. La API es la misma; cambian las rutas de los imports. La excepción son native-stack y drawer usados directamente, que pasan a los layouts de Expo Router.
¿Puedo seguir usando React Navigation?
Sí, en un proyecto de Expo sin Expo Router. Lo que ya no se admite es importar @react-navigation/* en una app que usa Expo Router.
¿Qué hago si una librería se rompe?
Busca con npm ls de qué paquete de React Navigation depende. Si es core, Expo CLI 56 y 57 lo reescriben; si es otro, revisa si hay versión nueva o abre un issue en la librería.
¿Esto aplica si ya estoy en el SDK 58?
Sí, la migración de imports es la base. Encima, revisa la guía de SDK 57 a 58, porque quitó varias APIs de expo-router/react-navigation y ya no está el error del bundler que avisaba de los imports viejos.
Checklist
- El proyecto está en el SDK 55 y en una rama limpia antes de empezar.
expoen^56.0.0,npx expo install --fixynpx expo-doctorsin avisos.- El codemod corrió sobre todas las carpetas con código.
- Los archivos saltados se arreglaron a mano y el codemod volvió a correr.
native-stackydrawerpasaron a los layoutsStackyDrawer.- El
grepde imports viejos no imprime nada. - Las librerías que dependen de React Navigation están identificadas y probadas.
- La app compila y funciona en iOS y en Android.
- La variable
EXPO_ROUTER_DISABLE_RN_NAVIGATION_CHECKno quedó puesta.
Con los imports en su lugar, el siguiente paso es decidir si subes al SDK 57 y luego al 58, de uno en uno.
¿Viste esto en Instagram? Comenta ROUTER en el Reel y te mando la guía.
Escrito por

Publicado el 19 de noviembre de 2026