Saltar al contenido

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)
  1. Qué cambió en Expo Router con el SDK 56
  2. Qué no cambia
  3. Los imports nuevos
  4. El codemod
  5. Librerías de terceros
  6. Probar en iOS y Android
  7. Después del SDK 56: qué cambió en SDK 57 y SDK 58
  8. Errores comunes
  9. Preguntas frecuentes
  10. Checklist

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.
  1. La primera línea dice qué pasó: el import viene de tu código y apunta a @react-navigation/*.
  2. La segunda te manda a la guía oficial; la seguimos en este artículo.
  3. 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.

Expo Router ya no se apoya en React NavigationSDK 55 · antesSDK 56 · despuéstu appexpo-router 55@react-navigation/*la app importaba de los dostu appexpo-router 56/react-navigation/js-stack · /js-tabs · /js-top-tabsel fork vive aquí dentro@react-navigation/*: ya no se importamisma API, otra ruta de importlibrerías: @react-navigation/core se reescribía solo en SDK 56 y 57

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/nativeexpo-router/react-navigation
@react-navigation/coreexpo-router/react-navigation
@react-navigation/elementsexpo-router/react-navigation
@react-navigation/routersexpo-router/react-navigation
@react-navigation/stackexpo-router/js-stack
@react-navigation/bottom-tabsexpo-router/js-tabs
@react-navigation/material-top-tabsexpo-router/js-top-tabs
@react-navigation/native-stackSin equivalente directo: usa el layout Stack
@react-navigation/drawerSin equivalente directo: usa el layout Drawer
de @react-navigation/* a Expo Router 56@react-navigation/ahoracodemodnativeexpo-router/react-navigationsícoreexpo-router/react-navigationsíelementsexpo-router/react-navigationsíroutersexpo-router/react-navigationsístackexpo-router/js-stacksíbottom-tabsexpo-router/js-tabssímaterial-top-tabsexpo-router/js-top-tabssínative-stacklayout Stackno: a manodrawerlayout Drawerno: a manosiete se reescriben; dos piden cambiar códigofuente: docs.expo.dev, migrar Expo Router de SDK 55 a 56

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';
  1. El tema (ThemeProvider y DarkTheme) venía de @react-navigation/native; ahora sale de expo-router/react-navigation, que agrupa lo que antes venía de native, core, elements y routers.
  2. Las pestañas superiores se creaban con el paquete de material-top-tabs; ahora la función sale de expo-router/js-top-tabs.
  3. 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). Con import * as o un import por defecto deja el archivo igual y te pide cambiarlo a mano. Lo cambiamos a import { 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";
  1. Los tres imports apuntaban a paquetes que ahora tienen el mismo destino, así que el codemod los juntó en uno.
  2. El import de solo tipos (import type { Theme }) se conservó como type Theme dentro de la línea.
  3. 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.
los imports antes y después del SDK 56app/_layout.tsx-import { ThemeProvider, DarkTheme } from '@react-navigation/native';-import { createMaterialTopTabNavigator } from '@react-navigation/material-top-tabs';+import { ThemeProvider, DarkTheme } from 'expo-router/react-navigation';+import { createMaterialTopTabNavigator } from 'expo-router/js-top-tabs';codemodnpx expo-codemod sdk-56-expo-router-react-navigation-replace srcla API no cambia: solo se mueve la ruta del importejemplo de la guía oficial de migraciónsolo imports con nombre; import * as y default se cambian a mano

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
  1. npm install expo@^56.0.0 sube el SDK.
  2. npx expo install --fix pone el resto de paquetes de Expo, incluido expo-router, en las versiones de ese SDK.
  3. npx expo-doctor revisa problemas comunes; en el SDK 56 también avisa si react-navigation sigue instalado junto a expo-router.
  4. npx expo start --clear arranca Metro con la caché vacía, para que no sirva imports viejos.
  5. npx expo run:ios compila la app de iOS en local (necesita una Mac con Xcode).
  6. npx expo run:android hace 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á en app y components. 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-stack o drawer. No tienen equivalente: hay que pasar a los layouts Stack y Drawer.
  • Importar createStackNavigator de expo-router/js-stack en el SDK 56. Ahí solo existe Stack.
  • 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.
  • expo en ^56.0.0, npx expo install --fix y npx expo-doctor sin 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-stack y drawer pasaron a los layouts Stack y Drawer.
  • El grep de 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_CHECK no 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

Luis Morales

Luis Morales

Desarrollador frontend y Shopify, EcomLabs

@luismoralesdev en Instagram

Publicado el 19 de noviembre de 2026

← Blog