Templates do create-expo-app

O create-expo-app envia cinco templates oficiais - cada um fixa o Expo SDK 57 quando você passa @sdk-57. Escolher o iniciador errado custa dias de migração; esta página mapeia cada template para o formato do produto que ele se encaixa.

Receita

Cartão de receita de referência rápida - pronto para copiar e colar.

# Padrão da equipe - app multi-tela com Expo Router + TypeScript
npx create-expo-app@latest ShopApp --template default@sdk-57 --yes
 
# Iniciador de navegação com abas primeiro (escopo similar ao default)
npx create-expo-app@latest ShopApp --template tabs@sdk-57 --yes
 
# Pico mínimo - sem router, TypeScript habilitado
npx create-expo-app@latest Spike --template blank-typescript@sdk-57 --yes
 
# Diretórios nativos no primeiro dia - executa prebuild durante a geração
npx create-expo-app@latest NativeDay1 --template bare-minimum@sdk-57 --yes
 
cd ShopApp && npx expo-doctor

Quando usar isso:

• Escolher um iniciador antes do primeiro commit de produção - trocas de template são dolorosas assim que a navegação e os diretórios nativos criam raízes.
• Padronizar a escolha de template entre equipes para que cada novo repositório inicie com os mesmos scripts e layout de pastas.
• Decidir se você precisa de bare-minimum agora ou pode permanecer gerenciado e executar npx expo prebuild mais tarde.
• Auditar uma geração acidental do SDK 54 - compare package.json com o template que você pretendia.

Exemplo de Trabalho

#!/usr/bin/env bash
# scripts/new-expo-app.sh - seletor de template da organização com verificação do SDK 57
set -euo pipefail
 
APP_NAME="${1:?Uso: ./new-expo-app.sh <NomeDoApp> [default|tabs|blank-typescript|bare-minimum]}"
KIND="${2:-default}"
 
case "$KIND" in
  default|tabs|blank-typescript|bare-minimum) TEMPLATE="${KIND}@sdk-57" ;;
  *) echo "Template desconhecido: $KIND" >&2; exit 1 ;;
esac
 
npx create-expo-app@latest "$APP_NAME" --template "$TEMPLATE" --yes
cd "$APP_NAME"
 
# Falha rápida se a geração divergiu do 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 "Esperado expo ~57.0.4, obtido $EXPO_VER" >&2; exit 1; }
test "$RN_VER" = "0.86.0" || { echo "Esperado react-native 0.86.0, obtido $RN_VER" >&2; exit 1; }
 
npx expo-doctor
npx tsc --noEmit
 
echo "✅ $APP_NAME gerado com $TEMPLATE"

Após default@sdk-57, espere este layout:

ShopApp/
├── app/
│   ├── _layout.tsx          # Layout raiz do Expo Router
│   ├── (tabs)/
│   │   ├── _layout.tsx      # Navegador de abas
│   │   ├── 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

O que isso demonstra:

• Um único script codifica a política da organização - engenheiros passam default, tabs, blank-typescript, ou bare-minimum; o sufixo @sdk-57 nunca é opcional.
• Asserções de versão pós-geração capturam desvios do SDK antes do início do trabalho de funcionalidade.
• expo-doctor e tsc --noEmit como portões obrigatórios após cada escolha de template.
• default@sdk-57 envia roteamento baseado em arquivos sob app/ - o layout que você estende para navegação de produção.

Análise Profunda

Como Funciona

• create-expo-app copia um template versionado do monorepo Expo, escreve package.json, instala dependências e gera o código inicial.
• O sufixo @sdk-57 fixa o grafo de dependências do template - expo resolve para ~57.0.4 com react-native 0.86.0 e react 19.2.3 correspondentes.
• default e tabs ambos habilitam Expo Router e TypeScript; eles diferem na estrutura de navegação inicial, não nas capacidades do SDK.
• blank / blank-typescript enviam uma única entrada App.tsx - sem diretório app/, sem router - você adiciona a navegação manualmente.
• bare-minimum executa npx expo prebuild durante a configuração, gerando android/ e ios/ imediatamente.

Comparação de Templates

# Comparação lado a lado - gera em /tmp, inspeciona, deleta
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 presente
ls /tmp/compare-blank/app 2>/dev/null || echo "blank: sem diretório app/"

Fluxo de Decisão

O que Cada Template Omite

Notas TypeScript

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

// default@sdk-57 - arquivos de rota ficam sob app/, não App.tsx
// app/(tabs)/index.tsx
import { StyleSheet, Text, View } from "react-native";
 
export default function HomeScreen() {
  return (
    <View style={styles.container}>
      <Text>Aba Home - rota de arquivo do Expo Router.</Text>
    </View>
  );
}
 
const styles = StyleSheet.create({
  container: { flex: 1, alignItems: "center", justifyContent: "center" },
});

Prefira default@sdk-57 quando o app tiver mais de uma tela - adaptar o Expo Router ao blank-typescript é factível, mas desperdiça o primeiro sprint.

Armadilhas

• Gerar sem @sdk-57 - Durante a transição do SDK 57, create-expo-app@latest sem template pode criar o SDK 54 para compatibilidade com Expo Go em dispositivos físicos. Correção: Passe --template default@sdk-57 (ou seu template escolhido com o sufixo) para novo trabalho de produção.
• Tratar tabs e default como fundamentalmente diferentes - Ambos enviam Expo Router e TypeScript com contagens de arquivos semelhantes. Equipes perdem tempo debatendo-os. Correção: Escolha um em toda a organização; a diferença é o layout inicial, não a capacidade.
• Escolher bare-minimum "por via das dúvidas" - Prebuild commita android/ e ios/, aumentando a superfície de conflitos de merge e atrasando upgrades gerenciados. Correção: Comece com default@sdk-57; execute npx expo prebuild quando os diretórios nativos forem realmente necessários.
• Permanecer no blank quando o app cresce além de uma tela - Engenheiros adicionam React Navigation ao App.tsx e acabam com uma árvore não padrão. Correção: Migre para Expo Router cedo ou comece com default@sdk-57.
• Assumir que os templates incluem gerenciamento de estado ou camadas de API - Nenhum template envia Redux, TanStack Query ou pastas de funcionalidade. Correção: Adicione a arquitetura após a geração; veja Estrutura de Pastas para Funcionalidades.
• Misturar estilos de entrada de template - default usa app/_layout.tsx; blank-typescript usa App.tsx. Copiar código de rota entre eles sem reestruturação falha. Correção: Combine imports e pontos de entrada com o template que você escolheu.
• Pular expo-doctor após a seleção do template - Metadados do template podem resolver peers incompatíveis de módulos nativos. Correção: Execute npx expo-doctor antes do primeiro PR de funcionalidade.

Alternativas

FAQs

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

Relacionados

• Noções Básicas de Configuração de Projeto - layout padrão do app, scripts e verificação da primeira execução após a geração
• Guia Rápido do create-expo-app - fluxo completo de geração, flags e checklist de fixação de SDK
• Estrutura de Pastas para Funcionalidades - onde o código da funcionalidade vive após você escolher um template
• Monorepo com Turborepo - gere apps/mobile com default@sdk-57 dentro de um workspace
• Expo Go vs Builds de Desenvolvimento - como a escolha do SDK do template afeta os alvos de execução local
• Noções Básicas de Padrões de Componentes - divisões container/apresentador dentro das rotas app/ do template

Versões da Stack: Esta página foi escrita para React 19.2.3, React Native 0.86.0 e Expo SDK 57 (expo ~57.0.4).