Noções Básicas de Bibliotecas Essenciais

Q: Quantas stores globais devo ter?

Uma store Zustand por domínio (carrinho, preferências, onboarding) - não uma mega-store. Veja zustand.

Q: Quando preciso de um novo build EAS após adicionar uma biblioteca?

Sempre que o pacote adicionar código nativo ou um plugin de configuração - MMKV, FlashList, Sentry, Reanimated. Pacotes apenas em JS precisam apenas de reinicialização do Metro.

10 exemplos para entender como selecionamos, fixamos e desativamos dependências em dispositivos móveis - 7 básicos e 3 intermediários. Estes são os padrões da equipe para aplicativos Expo SDK 57; cookbooks mais aprofundados para cada biblioteca seguem nesta seção.

Pré-requisitos

Comece com um projeto SDK 57 fixado. As bibliotecas essenciais são padrões selecionados - não todo pacote npm que resolve um problema pertence a um aplicativo em produção.

npx create-expo-app@latest LibBasics --template default@sdk-57
cd LibBasics
npx expo install @tanstack/react-query @react-native-community/netinfo zustand
npx expo-doctor

Confirme a linha de base fixada antes de adicionar módulos nativos:

{
  "dependencies": {
    "expo": "~57.0.4",
    "react": "19.2.3",
    "react-native": "0.86.0"
  }
}

Ferramentas: Estes exemplos visam o Expo SDK 57 (expo ~57.0.4), React Native 0.86.0 e React 19.2.3. Módulos nativos requerem um build de desenvolvimento ou build EAS - não apenas o Expo Go padrão quando o pacote envia código nativo personalizado.

Exemplos Básicos

1. Selecione por Classe de Problema - Não por Estrelas do GitHub

As decisões de dependência móvel começam com que tipo de estado ou I/O você precisa - não repositórios em tendência.

┌────────────────────┬─────────────────────────┬──────────────────────────┐
│ Problema           │ Biblioteca Padrão       │ Não usar para            │
├────────────────────┼─────────────────────────┼──────────────────────────┤
│ Cache de API/servidor │ @tanstack/react-query   │ Badge do carrinho, toggle de tema │
│ UI global do cliente │ zustand                 │ Linhas do catálogo de produtos │
│ KV local rápido    │ react-native-mmkv       │ Dados offline relacionais │
│ Listas longas      │ @shopify/flash-list     │ Tela de configurações de 8 linhas │
│ Gestos / movimento │ Reanimated 4 + RNGH     │ Fade de 200ms de um único disparo │
│ Relatório de falhas│ @sentry/react-native    │ Console.log em produção  │
└────────────────────┴─────────────────────────┴──────────────────────────┘

Uma biblioteca por classe de problema - duas bibliotecas de lista ou duas stores globais criam dívida de migração
Prefira pacotes Expo-first - npx expo install resolve versões; menos surpresas de compilação nativa
Documente exceções em um ADR - não em um thread do Slack que ninguém encontra durante o onboarding

Relacionado: Noções Básicas de Gerenciamento de Estado - divisão servidor vs cliente

2. Fixe com `npx expo install` - Não npm Bruto

O Expo mantém uma matriz de compatibilidade por SDK. Fixar manualmente react-native-reanimated@latest quebra os builds EAS quando o ABI nativo não corresponde ao RN 0.86.

# Correto - resolve a versão compatível com SDK 57
npx expo install react-native-reanimated react-native-gesture-handler
 
# Arriscado para módulos nativos - pode instalar semver incompatível
npm install react-native-reanimated

# Verifique após qualquer alteração de dependência
npx expo-doctor

npx expo install grava o intervalo fixado com til que o Expo testou contra seu SDK
Pacotes apenas em JS (zod, @tanstack/react-query, zustand) podem usar npm install - sem ponte nativa
Execute expo-doctor em CI de lançamento e noturno - captura descompasso antes do eas build
Confirme alterações no lockfile com o PR de dependência - instalações reproduzíveis no EAS

Relacionado: Noções Básicas do Expo SDK - quando npm install é aceitável

3. Audite Dependências Transitivas Nativas Antes de Adotar

Toda biblioteca com código nativo traz autolinking, plugins de configuração e tamanho binário de armazenamento. Leia os docs de instalação antes de mesclar.

# Após adicionar uma biblioteca candidata
npx expo install react-native-mmkv
npx expo prebuild --dry-run   # expõe alterações de plugin de configuração
npx expo-doctor

Lista de verificação antes de mesclar:

Pergunta	Passou	Falhou → adiar ou encontrar alternativa
Funciona no fluxo gerenciado do Expo?	Sim	Requer fork bare
Precisa de plugin de configuração em `app.config`?	Documentado	Diferença nativa surpresa
Requer reconstrução do cliente de desenvolvimento?	Planejado na sprint	Bloqueado em QA apenas Expo Go
Duplica biblioteca existente?	Sem sobreposição	Consolidar primeiro

MMKV, FlashList, Sentry, Reanimated todos requerem um build de desenvolvimento ou binário EAS - planeje o tempo de reconstrução
expo prebuild --dry-run visualiza alterações de projeto nativo sem escrever ios/ / android/
Conte módulos nativos totais - cada um é um item de reconciliação de atualização do SDK

Relacionado: Análise de Código Morto e Dependências - mantenha o grafo enxuto

4. Fixe a Pilha Padrão da Equipe em package.json

Fixe a pilha essencial em um PR durante a inicialização do projeto para que cada branch de recurso herde as mesmas versões.

{
  "dependencies": {
    "expo": "~57.0.4",
    "react": "19.2.3",
    "react-native": "0.86.0",
    "@tanstack/react-query": "^5.0.0",
    "zustand": "^5.0.0",
    "react-native-reanimated": "~4.0.0",
    "react-native-gesture-handler": "~2.28.0",
    "@sentry/react-native": "^6.0.0"
  }
}

Fixações de lista/armazenamento nativas (@shopify/flash-list, react-native-mmkv, @react-native-community/netinfo) são escritas por npx expo install - não edite manualmente esses intervalos.

npx expo install @tanstack/react-query @react-native-community/netinfo zustand \
  @shopify/flash-list react-native-mmkv react-native-reanimated \
  react-native-gesture-handler @sentry/react-native

Deixe npx expo install definir intervalos compatíveis exatos - não edite manualmente fixações nativas
Um relator de falhas - Sentry ou uma alternativa corporativa, nunca ambos
Uma implementação de lista por aplicativo - FlashList para feeds; FlatList para telas estáticas curtas está bom
Documente a pilha no README ou ADR - o onboarding copia package.json, não conhecimento tribal

5. Separe o Estado do Servidor do Estado do Cliente

O erro de biblioteca mais caro é duplicar dados de API no Zustand ou Context quando o TanStack Query já os possui.

// ❌ Anti-padrão - fetch manual + store global para dados do servidor
const useProductStore = create((set) => ({
  products: [] as Product[],
  load: async () => {
    const res = await fetch("/products");
    set({ products: await res.json() });
  },
}));
 
// ✅ Padrão - Query possui o cache do servidor; Zustand possui apenas flags de UI
const { data: products } = useQuery({ queryKey: ["products"], queryFn: fetchProducts });
const filter = useFilterStore((s) => s.category); // apenas cliente

TanStack Query - carregamento, erro, tempo de stale, deduplicação, refetch em segundo plano, persistência
Zustand - carrinho, flags de onboarding, rascunhos de composer, chips de filtro - UI de cliente síncrona
Nunca armazene JWTs ou tokens de atualização no persist do Zustand - use expo-secure-store
Veja os cookbooks de @tanstack/react-query e zustand

Relacionado: TanStack Query - mergulho profundo completo em estado do servidor

6. Saiba Quando AsyncStorage é Suficiente - Antes do MMKV

Nem todo aplicativo precisa de react-native-mmkv desde o primeiro dia. Comece com AsyncStorage; atualize quando a análise de desempenho provar que leituras síncronas importam.

Ordem de seleção de armazenamento:
1. Estado do React na memória / Cache do Query     → efêmero
2. @react-native-async-storage/async-storage → JSON pequeno, hidratação de boot
3. react-native-mmkv                       → leituras síncronas de caminho crítico a cada frame
4. expo-sqlite                             → linhas relacionais, migrações, consultas
5. expo-secure-store                       → tokens, segredos

npx expo install @react-native-async-storage/async-storage
# Adicione MMKV apenas após o Profiler do React DevTools mostrar armazenamento await no caminho crítico
npx expo install react-native-mmkv

AsyncStorage é assíncrono - await getItem em cada renderização causa lentidão
MMKV é síncrono - ideal para persist do Zustand e flags de recursos lidos a cada montagem
MMKV não é um banco de dados - sem SQL, sem joins; use SQLite para dados relacionais offline
MMKV requer um build de desenvolvimento - não disponível no Expo Go padrão

Relacionado: react-native-mmkv - cookbook de KV rápido

7. Biblioteca de Listas: FlatList Primeiro, FlashList Quando Analisado

@shopify/flash-list é uma melhoria de desempenho - não um requisito do primeiro dia para cada tela.

// Lista de configurações curta - FlatList está bom
import { FlatList } from "react-native";
 
// Feed pesado em imagens com lentidão de scroll no Android - migre
import { FlashList } from "@shopify/flash-list";

Lista de verificação de gatilho de migração:

O Profiler mostra quedas de frame durante scroll rápido em um dispositivo Android de gama média
A lista tem mais de 50 linhas com imagens ou conteúdo variável
A sintonia de windowSize no FlatList não corrigiu flashes em branco

npx expo install @shopify/flash-list

Não migre todas as FlatList preventivamente - o custo da sintonia estimada é alto
Veja @shopify/flash-list para a lista de verificação completa de migração

Relacionado: FlashList vs FlatList - trade-offs antes de adotar

Exemplos Intermediários

8. Desative uma Biblioteca - Remova Antes da Atualização do SDK

Desativar é uma remoção planejada - não deixar um pacote apodrecer em package.json até que a atualização exploda.

# 1. Confirme zero importações
npx knip
npx depcheck
 
# 2. Remova o pacote e a entrada do lockfile
npm uninstall legacy-state-library
 
# 3. Remova o plugin de configuração nativo de app.config.ts, se presente
# 4. Reconstrua o cliente de desenvolvimento - o autolinking deve remover o módulo nativo
eas build --profile development --platform all
 
# 5. Verifique no dispositivo
npx expo-doctor

// app.config.ts - remova o stanza do plugin ao desativar
export default {
  plugins: [
    // ["legacy-library-expo-plugin"],  ← delete
    "expo-router",
  ],
};

Desative em um PR dedicado - mais fácil de fazer bissecção do que em um pacote com um recurso
Execute knip antes da remoção - arquivos órfãos frequentemente escondem a última importação
Reconstrua o nativo após remover qualquer pacote com código nativo - clientes de desenvolvimento desatualizados travam misteriosamente
Documente por que foi removido na descrição do PR - evita reintrodução no próximo trimestre

Relacionado: Análise de Código Morto e Dependências

9. Template de Revisão de PR de Dependência

Padronize as perguntas de revisão para que cada nova biblioteca receba o mesmo escrutínio.

## PR de Dependência: @shopify/flash-list
 
- [ ] Classe de problema documentada (desempenho da lista - tela de feed)
- [ ] Instalado com `npx expo install`
- [ ] `npx expo-doctor` limpo
- [ ] Reconstrução nativa agendada / concluída
- [ ] Nenhuma biblioteca duplicada (FlatList permanece para configurações)
- [ ] Impacto do bundle anotado (tamanho da fonte + nativo)
- [ ] Plano de teste em dispositivo Android físico
- [ ] ADR atualizado se isso alterar o padrão da equipe

# .github/workflows/pr-checks.yml - adicione em PRs com a label 'dependencies'
- name: Expo doctor
  if: contains(github.event.pull_request.labels.*.name, 'dependencies')
  run: npx expo-doctor

Rotule PRs de dependência como dependencies - aciona etapas extras de CI
Bloqueie a mesclagem se expo-doctor falhar - descompasso de versão é mais barato de corrigir no PR do que na fila do EAS
Exija nota de teste em dispositivo para módulos nativos - simuladores perdem falhas de autolinking
Link para o cookbook nesta seção ao adotar uma biblioteca padrão

10. Passagem de Reconciliação de Atualização do SDK

Os incrementos de SDK são quando bibliotecas não fixadas ou duplicadas causam mais problemas. Execute uma passagem de reconciliação antes de mesclar o PR do SDK.

# Fluxo de atualização (simplificado)
npx expo install expo@~57.0.4 --fix
npx expo-doctor
npx knip
npm run typecheck && npm test
 
# Reinstale a pilha nativa essencial contra a nova matriz
npx expo install react-native-reanimated react-native-gesture-handler \
  react-native-mmkv @shopify/flash-list @sentry/react-native
 
eas build --profile preview --platform all

Etapa	Objetivo
`expo install --fix`	Alinhe todos os módulos `expo-*` ao SDK 57
`expo-doctor`	Capture dependências de pares incompatíveis
`knip`	Remova bibliotecas que morreram durante o último ciclo de lançamento
Build EAS de pré-visualização	Valide a compilação nativa antes da tag de produção
Releia a configuração do Babel	O plugin Reanimated deve permanecer por último

Não atualize o SDK e adicione novas bibliotecas em um único PR - faça bissecção de falhas
Verifique os changelogs dos plugins de configuração - plugins Sentry e de notificações mudam entre SDKs
Reexecute Maestro smoke no binário de pré-visualização - gestos e listas quebram silenciosamente em incrementos nativos

Relacionado: Atualizando Versões do Expo SDK

Anti-Padrões

Anti-padrão	Por que falha
`npm install` para cada módulo nativo	Descompasso de versão → erros de compilação nativa do EAS
Redux + Zustand + Context para o mesmo carrinho	Três fontes de verdade; pesadelo de limpeza de logout
FlashList em todos os lugares desde o primeiro dia	Estime o custo de sintonia sem ganho mensurável
Manter módulos nativos não utilizados "por via das dúvidas"	Inchaço de autolinking; dor na atualização do SDK
Pular a reconstrução do cliente de desenvolvimento após adicionar nativo	"Funciona no Metro" mas trava no dispositivo
Dois relatores de falhas	Eventos duplicados; sobrecarga dupla de SDK

FAQs

Quais bibliotecas estão na seção Bibliotecas Essenciais?

TanStack Query, Zustand, MMKV, FlashList, Reanimated + Gesture Handler e Sentry - a pilha de produção padrão para aplicativos Expo SDK 57 neste site de documentação.

Posso usar npm install para @tanstack/react-query?

Sim - é apenas em JS, sem módulo nativo do Expo. Ainda assim, fixe um intervalo semver e confirme o lockfile. Para qualquer pacote que o Expo documente na referência do SDK, prefira npx expo install.

Quantas stores globais devo ter?

Uma store Zustand por domínio (carrinho, preferências, onboarding) - não uma mega-store. Veja zustand.

Quando preciso de um novo build EAS após adicionar uma biblioteca?

Sempre que o pacote adicionar código nativo ou um plugin de configuração - MMKV, FlashList, Sentry, Reanimated. Pacotes apenas em JS precisam apenas de reinicialização do Metro.

Como justifico uma biblioteca não padrão para a equipe?

Escreva um ADR curto: problema, alternativas consideradas, custo nativo, plano de desativação. Link para ele no PR de dependência.

Relacionado

@tanstack/react-query - cookbook de padrões de estado do servidor
zustand - cookbook de store global mínima
react-native-mmkv - KV rápido quando AsyncStorage é muito lento
@shopify/flash-list - lista de verificação de migração
react-native-reanimated & gesture-handler - matriz de instalação SDK 57
sentry-expo / @sentry/react-native - relatório de falhas no EAS
Melhores Práticas de Bibliotecas Essenciais - resumo de 25 itens

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

Pré-requisitos

Comece com um projeto SDK 57 fixado. As bibliotecas essenciais são padrões selecionados - não todo pacote npm que resolve um problema pertence a um aplicativo em produção.

npx create-expo-app@latest LibBasics --template default@sdk-57
cd LibBasics
npx expo install @tanstack/react-query @react-native-community/netinfo zustand
npx expo-doctor

Confirme a linha de base fixada antes de adicionar módulos nativos:

{
  "dependencies": {
    "expo": "~57.0.4",
    "react": "19.2.3",
    "react-native": "0.86.0"
  }
}

Ferramentas: Estes exemplos visam o Expo SDK 57 (expo ~57.0.4), React Native 0.86.0 e React 19.2.3. Módulos nativos requerem um build de desenvolvimento ou build EAS - não apenas o Expo Go padrão quando o pacote envia código nativo personalizado.

Exemplos Básicos

1. Selecione por Classe de Problema - Não por Estrelas do GitHub

As decisões de dependência móvel começam com que tipo de estado ou I/O você precisa - não repositórios em tendência.

┌────────────────────┬─────────────────────────┬──────────────────────────┐
│ Problema           │ Biblioteca Padrão       │ Não usar para            │
├────────────────────┼─────────────────────────┼──────────────────────────┤
│ Cache de API/servidor │ @tanstack/react-query   │ Badge do carrinho, toggle de tema │
│ UI global do cliente │ zustand                 │ Linhas do catálogo de produtos │
│ KV local rápido    │ react-native-mmkv       │ Dados offline relacionais │
│ Listas longas      │ @shopify/flash-list     │ Tela de configurações de 8 linhas │
│ Gestos / movimento │ Reanimated 4 + RNGH     │ Fade de 200ms de um único disparo │
│ Relatório de falhas│ @sentry/react-native    │ Console.log em produção  │
└────────────────────┴─────────────────────────┴──────────────────────────┘

Uma biblioteca por classe de problema - duas bibliotecas de lista ou duas stores globais criam dívida de migração
Prefira pacotes Expo-first - npx expo install resolve versões; menos surpresas de compilação nativa
Documente exceções em um ADR - não em um thread do Slack que ninguém encontra durante o onboarding

Relacionado: Noções Básicas de Gerenciamento de Estado - divisão servidor vs cliente

2. Fixe com `npx expo install` - Não npm Bruto

O Expo mantém uma matriz de compatibilidade por SDK. Fixar manualmente react-native-reanimated@latest quebra os builds EAS quando o ABI nativo não corresponde ao RN 0.86.

# Correto - resolve a versão compatível com SDK 57
npx expo install react-native-reanimated react-native-gesture-handler
 
# Arriscado para módulos nativos - pode instalar semver incompatível
npm install react-native-reanimated

# Verifique após qualquer alteração de dependência
npx expo-doctor

npx expo install grava o intervalo fixado com til que o Expo testou contra seu SDK
Pacotes apenas em JS (zod, @tanstack/react-query, zustand) podem usar npm install - sem ponte nativa
Execute expo-doctor em CI de lançamento e noturno - captura descompasso antes do eas build
Confirme alterações no lockfile com o PR de dependência - instalações reproduzíveis no EAS

Relacionado: Noções Básicas do Expo SDK - quando npm install é aceitável

3. Audite Dependências Transitivas Nativas Antes de Adotar

Toda biblioteca com código nativo traz autolinking, plugins de configuração e tamanho binário de armazenamento. Leia os docs de instalação antes de mesclar.

# Após adicionar uma biblioteca candidata
npx expo install react-native-mmkv
npx expo prebuild --dry-run   # expõe alterações de plugin de configuração
npx expo-doctor

Lista de verificação antes de mesclar:

Pergunta	Passou	Falhou → adiar ou encontrar alternativa
Funciona no fluxo gerenciado do Expo?	Sim	Requer fork bare
Precisa de plugin de configuração em `app.config`?	Documentado	Diferença nativa surpresa
Requer reconstrução do cliente de desenvolvimento?	Planejado na sprint	Bloqueado em QA apenas Expo Go
Duplica biblioteca existente?	Sem sobreposição	Consolidar primeiro

MMKV, FlashList, Sentry, Reanimated todos requerem um build de desenvolvimento ou binário EAS - planeje o tempo de reconstrução
expo prebuild --dry-run visualiza alterações de projeto nativo sem escrever ios/ / android/
Conte módulos nativos totais - cada um é um item de reconciliação de atualização do SDK

Relacionado: Análise de Código Morto e Dependências - mantenha o grafo enxuto

4. Fixe a Pilha Padrão da Equipe em package.json

Fixe a pilha essencial em um PR durante a inicialização do projeto para que cada branch de recurso herde as mesmas versões.

{
  "dependencies": {
    "expo": "~57.0.4",
    "react": "19.2.3",
    "react-native": "0.86.0",
    "@tanstack/react-query": "^5.0.0",
    "zustand": "^5.0.0",
    "react-native-reanimated": "~4.0.0",
    "react-native-gesture-handler": "~2.28.0",
    "@sentry/react-native": "^6.0.0"
  }
}

npx expo install @tanstack/react-query @react-native-community/netinfo zustand \
  @shopify/flash-list react-native-mmkv react-native-reanimated \
  react-native-gesture-handler @sentry/react-native

Deixe npx expo install definir intervalos compatíveis exatos - não edite manualmente fixações nativas
Um relator de falhas - Sentry ou uma alternativa corporativa, nunca ambos
Uma implementação de lista por aplicativo - FlashList para feeds; FlatList para telas estáticas curtas está bom
Documente a pilha no README ou ADR - o onboarding copia package.json, não conhecimento tribal

5. Separe o Estado do Servidor do Estado do Cliente

O erro de biblioteca mais caro é duplicar dados de API no Zustand ou Context quando o TanStack Query já os possui.

// ❌ Anti-padrão - fetch manual + store global para dados do servidor
const useProductStore = create((set) => ({
  products: [] as Product[],
  load: async () => {
    const res = await fetch("/products");
    set({ products: await res.json() });
  },
}));
 
// ✅ Padrão - Query possui o cache do servidor; Zustand possui apenas flags de UI
const { data: products } = useQuery({ queryKey: ["products"], queryFn: fetchProducts });
const filter = useFilterStore((s) => s.category); // apenas cliente

TanStack Query - carregamento, erro, tempo de stale, deduplicação, refetch em segundo plano, persistência
Zustand - carrinho, flags de onboarding, rascunhos de composer, chips de filtro - UI de cliente síncrona
Nunca armazene JWTs ou tokens de atualização no persist do Zustand - use expo-secure-store
Veja os cookbooks de @tanstack/react-query e zustand

Relacionado: TanStack Query - mergulho profundo completo em estado do servidor

6. Saiba Quando AsyncStorage é Suficiente - Antes do MMKV

Nem todo aplicativo precisa de react-native-mmkv desde o primeiro dia. Comece com AsyncStorage; atualize quando a análise de desempenho provar que leituras síncronas importam.

Ordem de seleção de armazenamento:
1. Estado do React na memória / Cache do Query     → efêmero
2. @react-native-async-storage/async-storage → JSON pequeno, hidratação de boot
3. react-native-mmkv                       → leituras síncronas de caminho crítico a cada frame
4. expo-sqlite                             → linhas relacionais, migrações, consultas
5. expo-secure-store                       → tokens, segredos

npx expo install @react-native-async-storage/async-storage
# Adicione MMKV apenas após o Profiler do React DevTools mostrar armazenamento await no caminho crítico
npx expo install react-native-mmkv

AsyncStorage é assíncrono - await getItem em cada renderização causa lentidão
MMKV é síncrono - ideal para persist do Zustand e flags de recursos lidos a cada montagem
MMKV não é um banco de dados - sem SQL, sem joins; use SQLite para dados relacionais offline
MMKV requer um build de desenvolvimento - não disponível no Expo Go padrão

Relacionado: react-native-mmkv - cookbook de KV rápido

7. Biblioteca de Listas: FlatList Primeiro, FlashList Quando Analisado

@shopify/flash-list é uma melhoria de desempenho - não um requisito do primeiro dia para cada tela.

// Lista de configurações curta - FlatList está bom
import { FlatList } from "react-native";
 
// Feed pesado em imagens com lentidão de scroll no Android - migre
import { FlashList } from "@shopify/flash-list";

Lista de verificação de gatilho de migração:

O Profiler mostra quedas de frame durante scroll rápido em um dispositivo Android de gama média
A lista tem mais de 50 linhas com imagens ou conteúdo variável
A sintonia de windowSize no FlatList não corrigiu flashes em branco

npx expo install @shopify/flash-list

Não migre todas as FlatList preventivamente - o custo da sintonia estimada é alto
Veja @shopify/flash-list para a lista de verificação completa de migração

Relacionado: FlashList vs FlatList - trade-offs antes de adotar

Exemplos Intermediários

8. Desative uma Biblioteca - Remova Antes da Atualização do SDK

Desativar é uma remoção planejada - não deixar um pacote apodrecer em package.json até que a atualização exploda.

# 1. Confirme zero importações
npx knip
npx depcheck
 
# 2. Remova o pacote e a entrada do lockfile
npm uninstall legacy-state-library
 
# 3. Remova o plugin de configuração nativo de app.config.ts, se presente
# 4. Reconstrua o cliente de desenvolvimento - o autolinking deve remover o módulo nativo
eas build --profile development --platform all
 
# 5. Verifique no dispositivo
npx expo-doctor

// app.config.ts - remova o stanza do plugin ao desativar
export default {
  plugins: [
    // ["legacy-library-expo-plugin"],  ← delete
    "expo-router",
  ],
};

Desative em um PR dedicado - mais fácil de fazer bissecção do que em um pacote com um recurso
Execute knip antes da remoção - arquivos órfãos frequentemente escondem a última importação
Reconstrua o nativo após remover qualquer pacote com código nativo - clientes de desenvolvimento desatualizados travam misteriosamente
Documente por que foi removido na descrição do PR - evita reintrodução no próximo trimestre

Relacionado: Análise de Código Morto e Dependências

9. Template de Revisão de PR de Dependência

Padronize as perguntas de revisão para que cada nova biblioteca receba o mesmo escrutínio.

## PR de Dependência: @shopify/flash-list
 
- [ ] Classe de problema documentada (desempenho da lista - tela de feed)
- [ ] Instalado com `npx expo install`
- [ ] `npx expo-doctor` limpo
- [ ] Reconstrução nativa agendada / concluída
- [ ] Nenhuma biblioteca duplicada (FlatList permanece para configurações)
- [ ] Impacto do bundle anotado (tamanho da fonte + nativo)
- [ ] Plano de teste em dispositivo Android físico
- [ ] ADR atualizado se isso alterar o padrão da equipe

# .github/workflows/pr-checks.yml - adicione em PRs com a label 'dependencies'
- name: Expo doctor
  if: contains(github.event.pull_request.labels.*.name, 'dependencies')
  run: npx expo-doctor

Rotule PRs de dependência como dependencies - aciona etapas extras de CI
Bloqueie a mesclagem se expo-doctor falhar - descompasso de versão é mais barato de corrigir no PR do que na fila do EAS
Exija nota de teste em dispositivo para módulos nativos - simuladores perdem falhas de autolinking
Link para o cookbook nesta seção ao adotar uma biblioteca padrão

10. Passagem de Reconciliação de Atualização do SDK

Os incrementos de SDK são quando bibliotecas não fixadas ou duplicadas causam mais problemas. Execute uma passagem de reconciliação antes de mesclar o PR do SDK.

# Fluxo de atualização (simplificado)
npx expo install expo@~57.0.4 --fix
npx expo-doctor
npx knip
npm run typecheck && npm test
 
# Reinstale a pilha nativa essencial contra a nova matriz
npx expo install react-native-reanimated react-native-gesture-handler \
  react-native-mmkv @shopify/flash-list @sentry/react-native
 
eas build --profile preview --platform all

Etapa	Objetivo
`expo install --fix`	Alinhe todos os módulos `expo-*` ao SDK 57
`expo-doctor`	Capture dependências de pares incompatíveis
`knip`	Remova bibliotecas que morreram durante o último ciclo de lançamento
Build EAS de pré-visualização	Valide a compilação nativa antes da tag de produção
Releia a configuração do Babel	O plugin Reanimated deve permanecer por último

Não atualize o SDK e adicione novas bibliotecas em um único PR - faça bissecção de falhas
Verifique os changelogs dos plugins de configuração - plugins Sentry e de notificações mudam entre SDKs
Reexecute Maestro smoke no binário de pré-visualização - gestos e listas quebram silenciosamente em incrementos nativos

Relacionado: Atualizando Versões do Expo SDK

Anti-Padrões

Anti-padrão	Por que falha
`npm install` para cada módulo nativo	Descompasso de versão → erros de compilação nativa do EAS
Redux + Zustand + Context para o mesmo carrinho	Três fontes de verdade; pesadelo de limpeza de logout
FlashList em todos os lugares desde o primeiro dia	Estime o custo de sintonia sem ganho mensurável
Manter módulos nativos não utilizados "por via das dúvidas"	Inchaço de autolinking; dor na atualização do SDK
Pular a reconstrução do cliente de desenvolvimento após adicionar nativo	"Funciona no Metro" mas trava no dispositivo
Dois relatores de falhas	Eventos duplicados; sobrecarga dupla de SDK

FAQs

Quais bibliotecas estão na seção Bibliotecas Essenciais?

TanStack Query, Zustand, MMKV, FlashList, Reanimated + Gesture Handler e Sentry - a pilha de produção padrão para aplicativos Expo SDK 57 neste site de documentação.

Posso usar npm install para @tanstack/react-query?

Quantas stores globais devo ter?

Uma store Zustand por domínio (carrinho, preferências, onboarding) - não uma mega-store. Veja zustand.

Quando preciso de um novo build EAS após adicionar uma biblioteca?

Sempre que o pacote adicionar código nativo ou um plugin de configuração - MMKV, FlashList, Sentry, Reanimated. Pacotes apenas em JS precisam apenas de reinicialização do Metro.

Como justifico uma biblioteca não padrão para a equipe?

Escreva um ADR curto: problema, alternativas consideradas, custo nativo, plano de desativação. Link para ele no PR de dependência.

Relacionado

@tanstack/react-query - cookbook de padrões de estado do servidor
zustand - cookbook de store global mínima
react-native-mmkv - KV rápido quando AsyncStorage é muito lento
@shopify/flash-list - lista de verificação de migração
react-native-reanimated & gesture-handler - matriz de instalação SDK 57
sentry-expo / @sentry/react-native - relatório de falhas no EAS
Melhores Práticas de Bibliotecas Essenciais - resumo de 25 itens

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

Noções Básicas de Bibliotecas Essenciais

Buscar na documentação

Noções Básicas de Bibliotecas Essenciais