Guía rápida de create-expo-app

Genera un nuevo proyecto Expo con la plantilla correcta, una fijación explícita de SDK 57 y una verificación de paso para que tu equipo comience con React Native 0.86 - no con un SDK antiguo accidental.

Receta

Tarjeta de referencia rápida - lista para copiar y pegar.

# Fija SDK 57 explícitamente (recomendado para nuevas apps de producción)
npx create-expo-app@latest MyApp --template default@sdk-57
 
cd MyApp
 
# Confirma la fijación del SDK antes de escribir funcionalidades
node -e "const p=require('./package.json'); console.log({expo:p.dependencies.expo, rn:p.dependencies['react-native']})"
 
npx expo-doctor
npx expo start

Cuándo usar esto:

• Al iniciar un proyecto Expo nuevo y quieres SDK 57 / RN 0.86 desde el primer commit.
• Al incorporar a un compañero de equipo que necesita un scaffold reproducible con un comando.
• Al elegir entre default, tabs, blank o bare-minimum antes de que el repo crezca.
• Al auditar un scaffold existente para detectar desvíos de SDK después de que create-expo-app@latest cambió su plantilla por defecto.

Ejemplo Funcional

#!/usr/bin/env bash
# scripts/scaffold-team-app.sh - proyecto SDK 57 reproducible para tu org
 
set -euo pipefail
 
APP_NAME="${1:-TeamMobile}"
TEMPLATE="${2:-default@sdk-57}"   # tabs@sdk-57 | blank-typescript@sdk-57 | bare-minimum@sdk-57
 
npx create-expo-app@latest "$APP_NAME" \
  --template "$TEMPLATE" \
  --yes
 
cd "$APP_NAME"
 
# Lockfile + git desde el primer día
git init
git add .
git commit -m "chore: scaffold $APP_NAME ($TEMPLATE)"
 
# Verificaciones de cordura que todo repo nuevo debe pasar
npx expo-doctor
npx tsc --noEmit
 
echo "✅ $APP_NAME listo - ejecuta: cd $APP_NAME && npx expo start"

Después de que el script termine, abre el proyecto y confirma las dependencias en package.json:

{
  "dependencies": {
    "expo": "~57.0.4",
    "react": "19.2.3",
    "react-native": "0.86.0"
  },
  "scripts": {
    "start": "expo start",
    "android": "expo start --android",
    "ios": "expo start --ios",
    "web": "expo start --web"
  }
}

Lo que esto demuestra:

• --template default@sdk-57 explícito para que el scaffold coincida con tu stack manifest, no con lo que @latest use como predeterminado durante una transición de SDK.
• --yes para creación de proyectos no interactiva compatible con CI.
• expo-doctor como primera puerta después del scaffold - detecta versiones de módulos nativos incompatibles temprano.
• Commit inmediato para que las opciones de SDK y plantilla sean rastreables en el historial de git.

Inmersión Profunda

Cómo Funciona

• create-expo-app descarga una plantilla versionada del monorepo de Expo, escribe package.json, instala dependencias y genera código fuente inicial (layout de Expo Router para default/tabs).
• El sufijo @sdk-57 en un nombre de plantilla fija el SDK principal de Expo en el momento del scaffold - el package.json de la plantilla resuelve expo a ~57.0.4 y los pares react-native / react coincidentes.
• npx expo install <pkg> (usado más tarde) lee la versión de expo fijada e instala versiones de módulos nativos compatibles - pero solo si la fijación base de expo es correcta primero.
• expo-doctor compara tu grafo de dependencias contra la base de datos de compatibilidad de SDK 57 e indica desajustes antes de que surjan como errores oscuros de Metro o compilación nativa.

Selección de Plantilla

# Ejemplos - siempre incluye el sufijo de SDK para nuevo trabajo de SDK 57
npx create-expo-app@latest Shop --template tabs@sdk-57
npx create-expo-app@latest Spike --template blank-typescript@sdk-57
npx create-expo-app@latest NativeDay1 --template bare-minimum@sdk-57

Lista de Verificación de Fijación de SDK

Banderas de create-expo-app Que Importan

Notas de TypeScript

// App.tsx - entrada de plantilla blank-typescript (sin Router)
import { StatusBar } from "expo-status-bar";
import { StyleSheet, Text, View } from "react-native";
 
export default function App() {
  return (
    <View style={styles.container}>
      <Text>App SDK 57 iniciado.</Text>
      <StatusBar style="auto" />
    </View>
  );
}
 
const styles = StyleSheet.create({
  container: { flex: 1, alignItems: "center", justifyContent: "center" },
});

La plantilla default@sdk-57 usa Expo Router (app/_layout.tsx) en su lugar - prefiere eso para apps multi-pantalla.

Errores Comunes

• Generar sin @sdk-57 - Durante la transición de SDK 57, npx create-expo-app@latest sin --template puede crear un proyecto SDK 54. Solución: Siempre pasa --template default@sdk-57 (o tu plantilla elegida con el sufijo de SDK).
• Elegir bare-minimum por defecto - Ejecuta prebuild inmediatamente, haciendo commit de android/ e ios/. Los equipos en managed workflow pierden la simplicidad de CNG. Solución: Comienza con default@sdk-57; ejecuta npx expo prebuild solo cuando se requieran directorios nativos.
• Omitir expo-doctor después del scaffold - Desajuste de versión (p. ej. expo-camera compilado para SDK 56) se compila pero falla en runtime. Solución: Ejecuta npx expo-doctor y npx expo install --fix antes del trabajo de funcionalidades.
• Mezclar gestores de paquetes - Copiar un proyecto generado con npm pero ejecutar yarn install deja archivos de bloqueo duplicados y EAS puede elegir el incorrecto. Solución: Mantente con un gestor; elimina el otro archivo de bloqueo si estás migrando.
• Asumir que Expo Go coincide con tu SDK - Los dispositivos iOS físicos solo pueden instalar el último Expo Go de la App Store. Un proyecto SDK 57 puede no cargarse en una Expo Go más antigua. Solución: Empareja la versión de Expo Go con SDK, o cambia a una compilación de desarrollo temprano.
• Renombrar la carpeta de la app sin actualizar slug - app.json / app.config slug se queda en el valor del scaffold; los deep links y URLs del proyecto de EAS se rompen. Solución: Actualiza slug, name e identificadores de paquete juntos en la config de app.
• Hacer commit de node_modules u omitir el lockfile - Las instalaciones reproducibles fallan entre máquinas y EAS. Solución: Haz commit de package-lock.json / yarn.lock / pnpm-lock.yaml; mantén node_modules en gitignore.

Alternativas

FAQs

node -e "console.log(require('./package.json').dependencies.expo)"
npx expo-doctor

npx create-expo-app@latest MyApp --template default@sdk-57 --yes

cd MyApp
npx expo start

npx expo install expo-camera

Relacionado

• Conceptos Básicos de Plataforma Expo - modelo mental del managed workflow antes de generar
• app.json & app.config.js - configura nombre, slug y plugins después del scaffold
• Expo Go vs Compilaciones de Desarrollo - elige cómo ejecutas el proyecto localmente
• Actualizando Versiones de Expo SDK - cuando una app existente necesita pasar a SDK 57
• Entornos y Variables de Entorno de EAS - configura staging/prod después de que el repo exista
• Conceptos Básicos de React Native - primeros componentes una vez que Metro está corriendo

Versiones de stack: Esta página fue escrita para React 19.2.3, React Native 0.86.0 y Expo SDK 57 (expo ~57.0.4).