Blog

Pare de quebrar as tabs do seu Expo Router

2 de fevereiro de 2026 9 min de leitura

Como impedi o Expo Router de montar uma nova subárvore de tabs que só parecia a mesma tela inicial em um app que mistura stack e tabs.

Pare de quebrar as tabs do seu Expo Router
ExpoExpo RouterReact NativeNavegaçãoArquitetura

Como corrigi tabs duplicadas no Expo Router

O Expo Router é bem fácil quando as suas tabs são o app inteiro.

A coisa fica mais interessante quando o app tem tabs, mas também tem rotas de tela cheia fora das tabs, para coisas como telas de detalhe, telas de processamento, telas de resultado, telas de compra ou onboarding.

Esse era o meu caso.

E o bug não era bem "o Expo Router está quebrado".

O bug era que eu estava criando, sem querer, uma segunda subárvore de tabs.

O app parecia voltar para a home, mas não era a mesma instância das tabs.

Esse é um problema bem diferente de simplesmente cair na tela errada.

Eu caía em uma tela que parecia correta, mas a árvore de tabs por baixo era nova.

Então o verdadeiro modo de falha era: tabs duplicadas, UI com a mesma cara, instância errada.

É por isso que o feed podia resetar, o state específico de cada tab podia sumir e o app podia parecer inconsistente, mesmo com o usuário "de volta na home".

Este artigo existe porque eu caí exatamente nesse problema e tive que arrumar a casa.

Meu app não tinha um grafo simples só de tabs

O detalhe importante era este:

o meu tab navigator não era o app inteiro.

Eu tinha uma root stack, e as tabs eram só um ramo dentro dela.

<Stack>
  <Stack.Screen name="(tabs)" />
  <Stack.Screen name="details/[id]" />
  <Stack.Screen name="processing/[id]" />
  <Stack.Screen name="result/[id]" />
  <Stack.Screen name="purchase" />
</Stack>

Essa estrutura era intencional.

Eu queria details, processing e result fora das tabs para que pudessem ocupar a tela inteira e esconder a tab bar.

Essa parte estava certa.

O problema começou quando eu continuei navegando de volta para as tabs como se /(tabs) fosse só mais uma rota comum.

Foi aí que a duplicação aconteceu.

Eu nem sempre voltava para o ramo de tabs que já existia.

Às vezes, na prática, eu criava um novo.

Em outras palavras, o app já tinha um shell de tabs vivo na root stack, e eu montava sem querer outro shell de tabs que por acaso renderizava a mesma UI da home.

O jeito mais fácil de duplicar as suas tabs

Quando você tem um grafo misto, esse tipo de ação fica perigoso:

router.replace("/(tabs)/(home)");
router.dismissTo("/");

Elas parecem inofensivas, mas não são a mesma coisa que "voltar para a instância de tabs que já existe".

O que eu queria era isto:

root stack
├─ (tabs)            // existing tabs instance
├─ details/[id]
├─ processing/[id]
└─ result/[id]

back action -> return to the existing (tabs) branch

O que eu às vezes fazia em vez disso era isto:

root stack
├─ (tabs)            // original tabs instance still exists
├─ details/[id]
├─ processing/[id]
├─ result/[id]
└─ (tabs)            // fresh tabs instance mounted again

Esse segundo caso é o bug de verdade.

Significa que o usuário vê uma home e uma tab bar, mas não está mais dentro do ramo de tabs que ele tinha construído antes.

Na prática, isso aparecia como:

  • montar um segundo ramo de tabs em cima do original
  • reconstruir o ramo de tabs em vez de voltar para o existente
  • perder o state da tab atual
  • perder a posição de scroll ou o state já carregado da tab
  • deixar o histórico de navegação com cara de inconsistente

A parte chata é que esse bug passa fácil despercebido.

Você continua vendo uma home.

Você continua vendo uma tab bar.

Mas agora você está dentro de uma instância nova de tabs, e não daquela que o usuário já tinha construído.

É por isso que o state das tabs parece quebrar do nada.

Seja preciso sobre o que "home" significa de verdade

Depois disso, parei de tratar "ir para a home" como uma ideia vaga.

Deixei isso explícito:

export const TAB_HOME_ROUTE = "/(tabs)/(home)";
export const TAB_CREATE_ROUTE = "/(tabs)/(create)";
export const TAB_PROFILE_ROUTE = "/(tabs)/(profile)";

E quando eu precisava voltar para as tabs, eu apontava para a rota de tab real:

router.dismissTo("/(tabs)/(home)");

E não:

router.dismissTo("/");
router.replace("/(tabs)/(home)");

Acabei me apoiando no dismissTo para isso, mas o importante não era a API em si.

O importante era que o destino deixou de ser vago.

Essa foi a primeira correção de verdade.

Quando o destino é preciso, a navegação deixa de ser "na base da tentativa" e passa a corresponder ao grafo real.

O sintoma não era "tela errada", era "instância errada"

Essa diferença importa.

Muitas vezes o usuário ainda estava olhando para a tab certa.

O problema era que se tratava de uma árvore de tabs nova.

É por isso que a quebra aparecia de forma indireta:

  • a posição de scroll tinha sumido
  • o state da tab carregado antes tinha sumido
  • o app parecia ter esquecido onde o usuário estava
  • fluxos repetidos deixavam a stack cada vez mais estranha

Quando comecei a pensar em termos de "estou voltando para a instância de tabs que já existe, ou criando uma nova?", ficou muito mais fácil raciocinar sobre o problema todo.

Mantenha os destinos de retorno dinâmicos sob controle

Eu também tinha fluxos que carregavam um param returnTo de um lado para o outro.

Essa parte pode virar bagunça rápido.

Se você deixa qualquer valor aleatório decidir para onde o app vai em seguida, acaba com uma navegação difícil de entender e fácil de quebrar.

Então a regra que adotei foi simples:

  • manter os destinos de retorno bem limitados
  • cair para uma rota de tab real quando o destino estiver ausente ou for inválido
  • não deixar que "voltar para de onde você veio" recrie um ramo diferente do app

Essa parte é menos empolgante que o bug das tabs duplicadas, mas serve ao mesmo objetivo:

levar o usuário de volta ao ramo de navegação que já existe, e não a uma cópia nova de algo que só parece certo.

O que resolveu de verdade

Se eu tivesse que resumir isso em poucas regras, seriam estas:

  • não trate /(tabs) como um atalho genérico para a home
  • use a rota de tab exata que você quer, como /(tabs)/(home)
  • pense em termos de "instância de tabs existente" em vez de "alguma rota de home"
  • faça os destinos de retorno dinâmicos passarem por uma whitelist pequena
  • otimize para reentrar no ramo de tabs atual, não para recriar um novo

Considerações finais

O erro principal foi não entender bem o suficiente o grafo.

Quando aceitei que as tabs eram só um ramo dentro de uma root stack maior, as regras de navegação ficaram muito mais simples.

E, para dar algum crédito ao Expo Router, a correção não foi nenhuma gambiarra feia.

A parte difícil foi só ser honesto sobre como o grafo do app realmente era.

As tabs não eram o app.

Elas eram uma subárvore dentro do app.

Quando parei de navegar para a "home" de qualquer jeito e passei a voltar para o ramo de tabs exato que já existia, o problema das tabs duplicadas sumiu.

Se o seu app tem um grafo misto de root stack com tabs, é por aí que eu começaria.