Clase 03 · Módulo 03
Crear el proyecto con Expo
Crear el proyecto con Expo
Qué logras en esta clase
Creas el proyecto de tu app y entiendes qué hay dentro.
- Ejecutas el comando que crea la app.
- Compruebas qué versión de Expo te tocó.
- Reconoces cada carpeta y archivo de la raíz.
- Lees y ajustas
app.json, el archivo de configuración.
02
Un comando crea la app completa
Un solo comando deja una app que ya funciona. Tu trabajo empieza por entender lo que creó, no por escribir código.
03
Antes de ejecutar nada
node -vmuestra una versión que Expo acepta (clase 1).- Tienes una carpeta de proyectos, corta y sin espacios.
- Elegiste un nombre para la carpeta de la app: minúsculas y guiones, sin tildes.
- Tienes a mano tu especificación del módulo 2.
El nombre de la carpeta no es el nombre que verá el usuario. Ese se define después, en la configuración.
04
Crear el proyecto
- Abre la terminal en tu carpeta de proyectos.
- Ejecuta el comando de creación.
- Escribe el nombre de la app cuando lo pregunte.
- Espera a que descargue las dependencias.
- Abre la carpeta nueva en VS Code.
npx create-expo-app@latestLa plantilla por defecto trae código de ejemplo para que veas una app funcionando desde el primer minuto.
05
El desfase entre SDK 57 y SDK 58
Expo SDK 58 es la versión estable desde el 15-10-2026. Al publicarla, Expo avisó que el comando sin plantilla seguiría creando proyectos SDK 57 por unas semanas.
Para partir directo en SDK 58 se indica la plantilla:
npx create-expo-app --template default@sdk-58Qué crea hoy el comando sin plantilla depende del día en que lo ejecutes. No lo supongas: compruébalo.
06
Comprobar qué SDK te tocó
Abre package.json en la raíz del proyecto y busca la línea de expo dentro de las dependencias.
"dependencies": {
"expo": "~58.0.0"
}El primer número es el SDK. Los números exactos del tuyo pueden diferir del ejemplo.
07
Lee el archivo, no la fecha del tutorial
Ni el tutorial ni el video saben qué versión tienes. Abre package.json y lee la línea de expo.
08
Si te tocó una versión anterior
| Opción | Cuándo conviene |
|---|---|
| Crear de nuevo con la plantilla de SDK 58 | Recién empiezas y no has escrito nada |
| Quedarte en la versión anterior | Solo quieres aprender con Expo Go por ahora |
| Subir de versión el proyecto existente | Ya tienes trabajo hecho (se ve en el módulo 15) |
En este curso se trabaja con SDK 58 y un build propio. Si acabas de crear el proyecto, crearlo de nuevo es lo más simple.
09
Primer arranque
npx expo startEste comando inicia el servidor de desarrollo: el programa que le entrega tu código a la app mientras trabajas. Muestra un código QR y espera órdenes por teclado.
aabre la app en un dispositivo Android.rla recarga.scambia entre Expo Go y development build.?muestra todos los atajos.
10
Qué hay en la raíz del proyecto
| Carpeta o archivo | Qué contiene |
|---|---|
app/ | Las pantallas. Cada archivo es una ruta |
assets/ | Imágenes, íconos y fuentes |
node_modules/ | Las librerías descargadas |
package.json | Lista de dependencias y comandos |
app.json | Configuración de la app |
Esto es lo habitual en la plantilla. La tuya puede traer más archivos según la versión.
11
Que Claude te explique tu plantilla
La plantilla cambia entre versiones. La mejor descripción es la de tu propia carpeta.
Una regla que vale siempre: node_modules/ no se edita ni se sube a Git. Se puede borrar y volver a generar con npm install.
12
package.json: el inventario
Tiene tres partes que conviene saber leer:
- Nombre y versión del proyecto.
- Scripts: atajos para comandos frecuentes.
- Dependencias: cada librería con la versión aceptada.
A su lado está package-lock.json, que fija la versión exacta de todo lo instalado. Ese archivo se sube a Git: ayuda a que la nube compile lo mismo que tú probaste.
13
app.json: la ficha de la app
Aquí se define cómo se presenta la app ante el teléfono y las tiendas.
{
"expo": {
"name": "Cafetería Central",
"slug": "cafeteria-central",
"version": "1.0.0"
}
}Además contiene el ícono, la pantalla de inicio, los identificadores de cada plataforma y la lista de plugins que configuran librerías nativas.
14
Los identificadores se eligen una vez
Cada app tiene un identificador único por plataforma: ios.bundleIdentifier y android.package.
- Formato habitual: dominio al revés, como
com.cafeteriacentral.app. - Para evitar problemas, usa solo minúsculas, números y puntos.
- Usa el mismo en las dos plataformas para no confundirte.
15
Código al instante, configuración con build
Un cambio de código se ve en segundos. Un cambio en app.json exige compilar la app de nuevo.
16
app.json o app.config.js
app.json | app.config.js | |
|---|---|---|
| Formato | Datos fijos | Código JavaScript |
| Lee variables de entorno | No | Sí |
| Cuándo conviene | Casi siempre, al empezar | Cuando un valor depende del entorno |
El caso típico del segundo: una clave de mapas que no quieres escribir dentro del archivo. Mientras no lo necesites, quédate con app.json.
17
Instalar librerías sin romper versiones
| Comando | Qué versión instala |
|---|---|
npx expo install seguido del paquete | La compatible con tu SDK |
npm install seguido del paquete | La más nueva, sea compatible o no |
Usa siempre el primero. Acepta varios paquetes en un mismo comando.
18
Revisar la salud del proyecto
npx expo-doctor@latest
npx expo install --checkEl primero revisa el proyecto completo y lista los problemas que encuentra. El segundo compara las versiones instaladas con las que tu SDK espera y ofrece corregirlas.
Ejecútalos después de crear el proyecto, después de instalar librerías y antes de cada build.
19
Variables de entorno: lo que va en .env
Un archivo .env guarda valores que cambian según el entorno, como la dirección de tu base de datos.
npx expo startcarga el archivo.env.development.- Las variables que empiezan con
EXPO_PUBLIC_quedan dentro de la app.
20
Dejar a Claude con contexto
Los proyectos nuevos de Expo traen AGENTS.md, un archivo con contexto para agentes de IA. Si Claude Code está instalado, también un .claude/settings.json que activa el plugin de Expo.
- Abre
claudeen la carpeta del proyecto. - Ejecuta
/initpara generarCLAUDE.md. - Pide que ese archivo importe
@AGENTS.md. - Agrega tus reglas concretas de la clase anterior.
21
Errores comunes
- Crear un proyecto dentro de otro. Comprueba en qué carpeta está la terminal antes de ejecutar el comando.
- Editar archivos dentro de
node_modules/. El cambio se pierde en la siguiente instalación. - Seguir tutoriales antiguos al pie de la letra. Los comandos y la estructura de carpetas han cambiado; contrasta con la documentación vigente.
- Cambiar los identificadores a mitad de camino. Define los definitivos ahora.
22
Lo que te llevas
npx create-expo-app@latestcrea la app;package.jsondice qué SDK te tocó.app/son las pantallas,assets/los recursos yapp.jsonla configuración.- Los identificadores se eligen pensando en la app publicada.
- Las librerías se instalan con
npx expo install. npx expo-doctor@latestrevisa el proyecto antes de cada paso importante.
23
Hazlo ahora
En 15 minutos:
- Crea el proyecto con la plantilla de SDK 58.
- Abre
package.jsony confirma la versión deexpo. - Ejecuta
npx expo-doctor@latesty lee el resultado. - Pon en
app.jsonel nombre real y los dos identificadores. - Genera
CLAUDE.mdcon/inity agrégale tres reglas tuyas.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026