-
Fixe a pilha na introdução: Declare React 19.2.3, React Native 0.86.0 e Expo SDK 57 (expo ~57.0.4) - não "último Expo".
-
Declare produto composto vs. produto enviado: Estas referências misturam padrões reais; a honestidade evita confusão do tipo "Acme Bank enviou isso".
-
Use diagramas de arquitetura em texto: Caixas e setas ASCII sobrevivem a mudanças de tema de documentação; capturas de tela apodrecem.
-
Siga a espinha dorsal do estudo de caso: Contexto → Arquitetura → Receita → Decisões → Resultados → Lições → Relacionado - corresponde à profundidade do cookbook sem ocultar a narrativa.
-
Registre alternativas rejeitadas: "Consideramos CRDT" ensina mais do que listar apenas SQLite - veja Referência: Aplicativo de Campo Offline-First.
-
Separe referência de antes/depois: Arquiteturas de referência mostram estado estável; histórias de migração mostram linha do tempo e regressões - não misture gêneros em um único arquivo.
-
Quantifique resultados com ressalvas: Tamanho da frota piloto, intervalo de datas e limites de atribuição pertencem a cada tabela de métricas.
-
Documente caminhos de atualização honestos: SDK 54→57 significa checkpoints 55 e 56 - Antes/Depois: Atualização Principal do Expo SDK.
-
Migrações Strangler precisam de invariantes: Uma única pilha de navegação raiz, URLs de marketing congeladas, sem NavigationContainer duplo - Antes/Depois: React Navigation → Expo Router.
-
Benchmarks exigem um protocolo: Lançamento vs. desenvolvimento, modelo do dispositivo, cache aquecido/frio, duração - Estudo de Caso de Desempenho: Feed em Escala.
-
Decisões OTA vs. loja são arquitetura: SaaS B2C com forte uso de OTA e fintech apenas via loja são ambos válidos - documente o gatilho de conformidade - compare Referência: Aplicativo SaaS Expo B2C e Referência: Cliente Mobile Fintech.
-
Estudos de caso offline-first precisam de um contrato de UX: Ao vivo, obsoleto, sincronizando, indisponível - quatro estados, não um único banner offline - Noções Básicas de Offline-First.
-
Interligue páginas do cookbook: Estudos de caso apontam para receitas; eles não duplicam Noções Básicas de EAS Build ou TanStack Query na íntegra.
-
Vincule ADRs para decisões contestadas: Navegação, fixação, política OTA - Registros de Decisão de Arquitetura.
-
Termine cada página com o rodapé de versões da pilha: Última linha, formato de citação em bloco - permite auditorias de obsolescência baseadas em grep em todo o site.
-
Marque os destaques no frontmatter: Cartões de pesquisa e índice exibem decisões sem abrir o artigo completo.
-
Nomeie dispositivos em histórias de campo e desempenho: "Android de gama média" é vago; Pixel 6a API 34 e Zebra TC57 são acionáveis.
-
Inclua classes de incidentes evitadas: "Nenhuma falha de incompatibilidade de runtimeVersion" é tão valioso quanto milissegundos de latência.
-
Fixe o SDK em cargas úteis de auditoria e suporte: TI de campo e operações de fraude correlacionam o comportamento meses depois - Referência: Cliente Mobile Fintech.
-
Revise estudos de caso após atualizações de SDK: As APIs expo-image, Reanimated e Router mudam - adicione uma nota de changelog no topo quando atualizado.
-
Não trate estudos de caso como mandatos: React Navigation em brownfield no SDK 57 continua válido de acordo com ADR: Escolha da Biblioteca de Navegação.
-
Combine estudos de caso com checklists: Regras de Lançamento e OTA e Regras de Segurança para Mobile operacionalizam arquiteturas de referência.
-
Seção de Lições: foco máximo de seis itens: Listas longas de lições diluem; priorize o que surpreendeu a equipe.
-
Blocos de Receita permanecem copiáveis: Mesmo estudos de caso narrativos precisam de um cartão de referência rápida - requisito da espinha dorsal do cookbook.
-
O mobile evolui rápido - date a narrativa: "Doze semanas no SDK 57" e "Congelamento de recursos do Q3" ancoram o julgamento do leitor melhor do que afirmações atemporais.
Versões da pilha: Esta página foi escrita para React 19.2.3, React Native 0.86.0 e Expo SDK 57 (expo ~57.0.4).