Clase 03 · Módulo 05
Expo Router: rutas por archivos
Expo Router: rutas por archivos
Qué logras en esta clase
Miras la carpeta de pantallas de tu proyecto y sabes qué rutas existen y cómo se llega a cada una.
- Traduces nombres de archivo a rutas.
- Entiendes qué hace un
_layout. - Pasas un dato de una pantalla a otra de forma correcta.
02
Navegar es tener direcciones
Una app con más de una pantalla necesita reglas: cuál se abre primero, cómo se va de una a otra, cómo se vuelve.
Expo Router es la librería de navegación de Expo. Le da a cada pantalla una dirección, igual que una página web tiene una URL. Esa dirección sirve para moverse dentro de la app y también para abrirla desde afuera con un enlace.
03
La regla central
Cada archivo dentro de la carpeta de rutas es una pantalla, y su ubicación en disco es su dirección.
04
De archivo a ruta
| Archivo | Ruta |
|---|---|
app/index.tsx | / |
app/carta.tsx | /carta |
app/pedidos/index.tsx | /pedidos |
app/pedidos/[id].tsx | /pedidos/27, /pedidos/31… |
No hay un archivo aparte donde «registrar» pantallas. Crear el archivo crea la ruta; borrarlo la elimina.
05
Dónde está la carpeta
Según la plantilla, la carpeta de rutas es app en la raíz del proyecto o app dentro de src. La documentación actual de Expo muestra sus ejemplos con src/app.
06
index: la pantalla por defecto
Un archivo llamado index es la pantalla que se muestra al entrar a su carpeta. app/index.tsx es lo primero que ve el usuario al abrir la app.
Dentro de una subcarpeta funciona igual: pedidos/index.tsx responde a /pedidos, sin la palabra «index» en la dirección.
07
_layout: el marco de una carpeta
_layout no es una pantalla. Define cómo se relacionan las pantallas de su carpeta: si se apilan, si van en pestañas, qué encabezado comparten.
Se dibuja antes que las pantallas que contiene. El _layout de la raíz se ejecuta antes que todo lo demás, por eso ahí se cargan las fuentes, el tema y la sesión.
08
Cómo se arma lo que ves
Cada nivel envuelve al siguiente. Si una barra o un encabezado aparece en varias pantallas, no está repetido en cada una: vive en el _layout que las contiene. Ahí se cambia.
09
Rutas dinámicas: corchetes
Un nombre entre corchetes es un hueco que se llena con un valor. pedidos/[id].tsx es una pantalla que sirve para todos los pedidos.
const { id } = useLocalSearchParams();Con esa línea la pantalla lee qué valor vino en la dirección y pide al servidor los datos de ese pedido.
10
Grupos: paréntesis
Una carpeta entre paréntesis ordena archivos sin cambiar la dirección. (inicio)/ajustes.tsx responde a /ajustes, no a /inicio/ajustes.
Se usa para dar un _layout propio a un conjunto de pantallas: por ejemplo, un grupo con las pantallas de ingreso y otro con las de la app ya iniciada.
11
Archivos con el signo más
| Archivo | Función |
|---|---|
+not-found.tsx | Pantalla para direcciones que no existen |
+native-intent.tsx | Reencaminar enlaces entrantes que no calzan con una ruta |
+middleware.ts | Código que corre antes de mostrar una ruta |
+html.tsx | Estructura HTML, solo para la versión web |
En una app solo móvil el que siempre conviene tener es +not-found.
12
Lo que conviene recordar
Si entiendes los nombres de archivo, entiendes la navegación: index, _layout, corchetes y paréntesis cubren casi todo.
13
Moverse con un enlace: Link
Link es un componente que, al tocarlo, lleva a otra ruta.
<Link href="/carta">Ver la carta</Link>Por defecto se comporta como un texto. Para que el enlace sea una tarjeta o un botón tuyo, se le agrega la prop asChild y se pone dentro un Pressable.
14
Moverse desde el código: useRouter
Cuando la navegación ocurre después de una acción (guardar, iniciar sesión), se usa useRouter.
| Método | Qué hace |
|---|---|
navigate | Va a la ruta; si ya está abierta más atrás, vuelve a ella |
push | Siempre abre una pantalla nueva encima |
replace | Cambia la actual por otra, sin poder volver |
back | Regresa a la anterior |
15
Cuál elegir
navigatees la opción habitual.pushcuando quieres abrir otra copia de la misma pantalla (de un producto a otro relacionado).replacetras iniciar sesión o terminar un asistente: el usuario no debe volver atrás a esa pantalla.
16
Pasar un dato a la pantalla siguiente
router.navigate({
pathname: '/pedidos/[id]',
params: { id: '27' },
});Los parámetros que calzan con un corchete van en la dirección; los que sobran se agregan como parámetros de consulta. La pantalla de destino los lee con useLocalSearchParams.
17
Pasa el identificador, no el objeto
Los parámetros viajan como texto dentro de una dirección. Por eso:
- Se pasa el identificador y la pantalla de destino pide sus datos.
- Un número llega como texto: hay que convertirlo.
- Datos sensibles nunca van en la dirección.
18
Qué cambió en el SDK 58
Al 18-11-2026, según las notas de Expo:
- El núcleo de navegación fue reescrito.
- Importaciones desde
expo-router/react-navigationy navegadores personalizados pueden requerir ajustes. withLayoutContextquedó obsoleto.- Hay límites de error por pantalla: una falla ya no tiene por qué botar toda la app.
Código de tutoriales anteriores puede necesitar cambios. Dile a Claude tu versión de SDK antes de pegarle un ejemplo.
19
Del mapa de pantallas a la carpeta
El mapa de pantallas del módulo 2 es casi literalmente el árbol de archivos.
- Entrégale el mapa a Claude Code.
- Pide primero solo la estructura de carpetas y archivos propuesta, sin código.
- Revisa que cada pantalla del mapa tenga su archivo.
- Recién entonces pide las pantallas vacías con su navegación.
20
Errores comunes
- Buscar un archivo de configuración de rutas que no existe.
- Poner componentes reutilizables dentro de la carpeta de rutas: se convierten en pantallas.
- Editar una pantalla para cambiar un encabezado que vive en el
_layout. - Pasar objetos completos como parámetros.
- Olvidar la pantalla
+not-found.
21
Lo que te llevas
- La carpeta de rutas es el mapa de navegación de la app.
indexes la pantalla por defecto;_layoutes el marco compartido.- Corchetes para rutas con valor variable; paréntesis para agrupar sin cambiar la dirección.
Linkpara enlaces visibles;useRoutertras una acción.- Entre pantallas viajan identificadores, no objetos.
22
Hazlo ahora
En 15 minutos:
- Abre la carpeta de rutas de tu proyecto y escribe en una hoja la dirección de cada archivo.
- Pide a Claude Code una pantalla de lista y una de detalle con ruta dinámica.
- Navega de la lista al detalle pasando un identificador.
- Muestra ese identificador en el detalle.
- Prueba el botón «atrás» y cuenta cuántos toques necesitas para volver al inicio.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026