Plantillas de create-expo-app

create-expo-app incluye cinco plantillas de primera parte - cada una fija Expo SDK 57 cuando pasas @sdk-57. Elegir el inicio incorrecto cuesta días de migración; esta página mapea cada plantilla a la forma de producto que se ajusta.

Receta

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

# Estándar del equipo - aplicación multi-pantalla con Expo Router + TypeScript
npx create-expo-app@latest ShopApp --template default@sdk-57 --yes
 
# Iniciador de navegación basada en pestañas (alcance similar a default)
npx create-expo-app@latest ShopApp --template tabs@sdk-57 --yes
 
# Prototipo mínimo - sin router, TypeScript habilitado
npx create-expo-app@latest Spike --template blank-typescript@sdk-57 --yes
 
# Directorios nativos desde el primer día - ejecuta prebuild durante el andamio
npx create-expo-app@latest NativeDay1 --template bare-minimum@sdk-57 --yes
 
cd ShopApp && npx expo-doctor

Cuándo usar esto:

• Elegir un inicio antes del primer commit de producción - los cambios de plantilla son dolorosos una vez que la navegación y los directorios nativos echen raíces.
• Estandarizar la elección de plantilla en todos los equipos para que cada nuevo repositorio inicie los mismos scripts y estructura de carpetas.
• Decidir si necesitas bare-minimum ahora o puedes mantenerte administrado y ejecutar npx expo prebuild después.
• Auditar un andamio accidental de SDK 54 - compara package.json contra la plantilla que tenías la intención.

Ejemplo Práctico

#!/usr/bin/env bash
# scripts/new-expo-app.sh - selector de plantilla de organización con verificación de SDK 57
set -euo pipefail
 
APP_NAME="${1:?Usage: ./new-expo-app.sh <AppName> [default|tabs|blank-typescript|bare-minimum]}"
KIND="${2:-default}"
 
case "$KIND" in
  default|tabs|blank-typescript|bare-minimum) TEMPLATE="${KIND}@sdk-57" ;;
  *) echo "Unknown template: $KIND" >&2; exit 1 ;;
esac
 
npx create-expo-app@latest "$APP_NAME" --template "$TEMPLATE" --yes
cd "$APP_NAME"
 
# Falla rápido si el andamio se desvió de SDK 57
EXPO_VER="$(node -p "require('./package.json').dependencies.expo")"
RN_VER="$(node -p "require('./package.json').dependencies['react-native']")"
test "$EXPO_VER" = "~57.0.4" || { echo "Expected expo ~57.0.4, got $EXPO_VER" >&2; exit 1; }
test "$RN_VER" = "0.86.0" || { echo "Expected react-native 0.86.0, got $RN_VER" >&2; exit 1; }
 
npx expo-doctor
npx tsc --noEmit
 
echo "✅ $APP_NAME scaffolded with $TEMPLATE"

Después de default@sdk-57, espera este diseño:

ShopApp/
├── app/
│   ├── _layout.tsx          # Expo Router root layout
│   ├── (tabs)/
│   │   ├── _layout.tsx      # Tab navigator
│   │   ├── index.tsx
│   │   └── explore.tsx
│   └── +not-found.tsx
├── assets/
├── app.json
├── package.json             # expo ~57.0.4, react-native 0.86.0, react 19.2.3
└── tsconfig.json

Lo que esto demuestra:

• Un único script codifica la política de la organización - los ingenieros pasan default, tabs, blank-typescript, o bare-minimum; el sufijo @sdk-57 nunca es opcional.
• Las aserciones de versión post-andamio detectan la desviación del SDK antes de que comience el trabajo de características.
• expo-doctor y tsc --noEmit como puertas obligatorias después de cada elección de plantilla.
• default@sdk-57 incluye enrutamiento basado en archivos bajo app/ - el diseño que extiendes para la navegación de producción.

Profundizar

Cómo funciona

• create-expo-app copia una plantilla versionada del monorepo de Expo, escribe package.json, instala dependencias, y genera el código fuente del iniciador.
• El sufijo @sdk-57 fija el gráfico de dependencias de la plantilla - expo se resuelve a ~57.0.4 con react-native 0.86.0 y react 19.2.3 coincidentes.
• default y tabs ambos habilitan Expo Router y TypeScript; se diferencian en la estructura de navegación del iniciador, no en las capacidades del SDK.
• blank / blank-typescript incluyen una única entrada App.tsx - sin directorio app/, sin router - añades navegación manualmente.
• bare-minimum ejecuta npx expo prebuild durante la configuración, generando android/ e ios/ inmediatamente.

Comparación de plantillas

# Comparación lado a lado - andamio en /tmp, inspecciona, elimina
npx create-expo-app@latest /tmp/compare-default --template default@sdk-57 --yes
npx create-expo-app@latest /tmp/compare-blank --template blank-typescript@sdk-57 --yes
ls /tmp/compare-default/app        # Router present
ls /tmp/compare-blank/app 2>/dev/null || echo "blank: no app/ directory"

Flujo de decisión

Lo que cada plantilla omite

Notas de TypeScript

// entrada blank-typescript@sdk-57 - sin Router, componente raíz único
import { StatusBar } from "expo-status-bar";
import { StyleSheet, Text, View } from "react-native";
 
export default function App() {
  return (
    <View style={styles.container}>
      <Text>Blank TypeScript starter on SDK 57.</Text>
      <StatusBar style="auto" />
    </View>
  );
}
 
const styles = StyleSheet.create({
  container: { flex: 1, alignItems: "center", justifyContent: "center" },
});

// default@sdk-57 - los archivos de ruta viven bajo app/, no App.tsx
// app/(tabs)/index.tsx
import { StyleSheet, Text, View } from "react-native";
 
export default function HomeScreen() {
  return (
    <View style={styles.container}>
      <Text>Home tab - Expo Router file route.</Text>
    </View>
  );
}
 
const styles = StyleSheet.create({
  container: { flex: 1, alignItems: "center", justifyContent: "center" },
});

Prefiere default@sdk-57 cuando la aplicación tendrá más de una pantalla - retroceder Expo Router a blank-typescript es factible pero desperdicia el primer sprint.

Errores comunes

• Andamiaje sin @sdk-57 - Durante la transición de SDK 57, create-expo-app@latest bare puede crear SDK 54 para Expo Go en dispositivos físicos. Solución: Pasa --template default@sdk-57 (o tu plantilla elegida con el sufijo) para nuevo trabajo de producción.
• Tratar tabs y default como fundamentalmente diferentes - Ambos incluyen Expo Router y TypeScript con recuentos de archivos similares. Los equipos desperdician tiempo debatiéndolos. Solución: Elige uno a nivel de organización; la diferencia es diseño del iniciador, no capacidad.
• Elegir bare-minimum por "por si acaso" - Prebuild compromete android/ e ios/, aumentando la superficie de conflicto de fusión y ralentizando las actualizaciones administradas. Solución: Comienza con default@sdk-57; ejecuta npx expo prebuild cuando los directorios nativos sean realmente necesarios.
• Permanecer en blank cuando la aplicación crece más allá de una pantalla - Los ingenieros cosen React Navigation en App.tsx y terminan con un árbol no estándar. Solución: Migra a Expo Router temprano o comienza con default@sdk-57.
• Asumir que las plantillas incluyen gestión de estado o capas API - Ninguna plantilla incluye Redux, TanStack Query, o carpetas de características. Solución: Añade arquitectura después del andamio; ver Estructura de carpetas para características.
• Mezclar estilos de entrada de plantilla - default usa app/_layout.tsx; blank-typescript usa App.tsx. Copiar código de ruta entre ellos sin reestructurar falla. Solución: Coincide con las importaciones y puntos de entrada con la plantilla que elegiste.
• Omitir expo-doctor después de la selección de plantilla - Los metadatos de plantilla pueden resolver pares de módulos nativos incompatibles. Solución: Ejecuta npx expo-doctor antes del primer PR de características.

Alternativas

Preguntas frecuentes

node -p "require('./package.json').dependencies.expo"
node -p "require('./package.json').dependencies['react-native']"
npx expo-doctor

npx create-expo-app@latest apps/mobile --template default@sdk-57 --yes

Relacionado

• Conceptos básicos de configuración de proyectos - diseño de aplicación estándar, scripts, y verificación de primera ejecución después del andamio
• Guía rápida de create-expo-app - flujo completo de andamio, banderas, y lista de verificación de fijación de SDK
• Estructura de carpetas para características - dónde vive el código de características después de elegir una plantilla
• Monorepo con Turborepo - andamio apps/mobile con default@sdk-57 dentro de un espacio de trabajo
• Expo Go vs Compilaciones de desarrollo - cómo la elección del SDK de plantilla afecta objetivos locales de ejecución
• Conceptos básicos de patrones de componentes - divisiones contenedor/presentador dentro de las rutas app/ de la plantilla

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).