Por que migramos do Next.js para TanStack Start no T3Chat?
Mudamos a stack do T3Chat, uma virada cheia de lições, reescrita e decisões técnicas que mudam tudo no mundo React. Sincronia frontend/backend, escalabilidade, experiência dev, deploy — entenda o que ninguém revela na prática.
Por que isso é importante
Migrar de Next.js para TanStack Start é mais que trocar de framework: é um choque de cultura para qualquer time React moderno. Aqui, você vai descobrir as dores, ganhos, acertos e armadilhas de quem leva escalabilidade, sincronia e experiência dev a sério. Se sua stack te limita ou não entrega aquilo que você sonha para seu produto — este artigo vai mudar seu modo de pensar upgrade e arquitetura web.
Do Next.js para TanStack Start: a decisão que ninguém esperava
Trocar de framework costuma ser doloroso, mas mais doloroso ainda é ficar estagnado. O T3Chat tinha explosão de usuários, código crescendo e necessidades mudando a cada semana. E não: não foi bug, hype nem clickbait — mudamos de Next.js para TanStack Start para aguentar a escala e dar autonomia real para evoluir sem sofrer com lock-in.
O que muda na prática? PanStack, PRs gigantes — e coragem
Foram milhares de linhas mexidas, centenas de comentários e muita engenharia para adaptar o TanStack Start ao tamanho do T3Chat. Quando frameworks não têm tudo pronto, você é obrigado a entender cada linha, a patchar na unha, a rever toda a arquitetura e investir num time que aprende junto — é assim que evoluímos.
⚠️Atenção
Migrar nunca é só técnica. Você vai lidar com acoplamento, regressão, deploy, bugs de sincronia e versões. Não subestime a energia que isso exige de um time — nem a tentação de ficar em águas seguras.
Por que migrar? O que o Next.js ainda entrega (ou limita)
O Next.js continua ótimo para milhares de apps — mas queríamos algo realmente sincrônico, client-first, sem server slugs e colapso de versões. Na etapa de evolução do T3Chat, performance instantânea e deploy controlado ficaram acima da popularidade de features novas.
A importância extrema de sincronizar cliente e servidor
Se o backend muda, o frontend precisa saber. Se regressa, volta tudo. Sincronia perfeita reduz bugs, sustenta deploy rápido e evita dor de cabeça em rollback. Frameworks que embutem esse conceito viram padrão por um motivo: ninguém aguenta mais APIs fora de sincronia.
ℹ️Atenção
Para projetos de escala, separar backend e frontend pode ser uma armadilha. Muitas vezes, mantê-los juntos facilita rollback, deploy e futura integração. Pense nisso antes de dividir recursos além do necessário.
Arquitetura escalável: mais que servidores, é código que cresce fácil
Não basta atender mais usuários: você precisa manutenir, estender e adaptar sem colapsar. Abraçar soluções como TanStack permitiu reescrever partes cruciais, evitar dívida técnica e facilitar a vida do time todo, inclusive de novos devs.
Por dentro do deploy: deployar, reverter, testar — tudo simples ou é morte lenta
Deploy travado por dependências entre partes diferentes, rollback manual complexo e sync de versões são sinais claros de stack mal pensada. Quem já sofreu rollback de migration de banco entende. No T3Chat, decisões que simplificam deploy ou rollback valem ouro.
⚠️Atenção
Não existe stack perfeita, mas existe stack que facilita seu caminho. Deployers automáticos e integração total do código reduzem riscos e aceleram time-to-fix em produção.
O meme é real: DNS não é seu problema (interface velha sim)
Quantas vezes você já culpou o DNS e no fundo era processo, interface ruim, ou deploy mal feito? Adotar soluções programáveis para domínio, como DNSimple, tira o peso da mão e entrega produtividade real — e mostra como APIs modernas mudam seu ritmo de desenvolvimento.
Stack client-side, sem server components, e apostando no aborrecido (sim, no melhor sentido)
O segredo para escalar não é usar só novidade: apostar em tecnologia madura, “aborrecida”, é tática de quem valoriza previsibilidade. O T3Chat priorizou React, IndexedDB e rotas estáticas bem hackeadas para desempenho puro. E funcionou.
Dexie, IndexedDB e o poder do “velho confiável”
Nem tudo que é antigo fica obsoleto. Dexie, por cima do IndexedDB, garantiu persistência e performance. Nem tudo funcionou sempre liso, mas a estabilidade das bases maduras compensa a curva de aprendizado. “Framework velho, mas confiável” virou mantra.
✅Atenção
Ignorar tecnologias “sem hype” pode atrasar sua entrega. Sempre avalie contexto, não o brilho temporário dos frameworks moderninhos.
Escolhas que simplificam a vida: TypeScript fullstack e stack unificada
Unificar código com TypeScript ponta a ponta garantiu produtividade e manutenção facilitadas. O alinhamento total, do pacote ao deploy, é o maior aliado de times pequenos e velozes. Não subestime poder de uma stack uniforme quando a escala real chega.
Quando separar backend e frontend piora tudo
Para muita gente é tentador separar tudo logo cedo. Mas em apps que exigem rollback, rollback rápido, manutenção e sincronia exata, unificar deploy salva horas de debugging e milhões em suporte técnico — e reduz efeitos colaterais de bugs críticos.
❌Atenção
Separar antes da hora pode custar caro: pense no deploy, rollback, e migrações antes de ficar refém da arquitetura “moderna” mas imprática.
React ainda é rei: não troque o essencial pelo modismo
Para o T3Chat, React continua sendo base essencial. Conhecimento compartilhado, ecossistema gigante e performance estável vencem modismos. O problema quase nunca está no framework, mas em como a stack evolui.
Router, rotas e as gambiarras que libertam sua UI
Ao invés de aceitar limitações do Next.js router, o time reescreveu, hackeou o router do React de forma criativa. Regras e rewrites para URLs garantiram navegação instantânea e UX consistente, mesmo sem o tradicional server router — mostrar que “gambiarra criativa” às vezes é seu melhor caminho ao sucesso.
Lições do caos: migrar framework é estratégia, não moda
Migrar é sempre exaustivo: ajuste de rotina, bugs novos, documentação faltando. Mas sair da zona de conforto ajuda times a evoluir mais rápido e a criar produtos mais sólidos. Saber porque migrar, quando migrar e como migrar é a verdadeira habilidade dos times resilientes.
Resumo para devs inquietos: reinvente seu stack, mas pense nas consequências
Migrar só faz sentido quando a entrega acelera, a manutenção fica mais segura e a evolução técnica vira resultado de verdade. No T3Chat, TanStack Start vem trazendo isso — mas exigiu coragem, paciência e muito debate sobre cada detalhe técnico. E por aí? Pronto para arquitetar sua próxima virada sem medo?
ℹ️Atenção
Quer mais conteúdo sem filtro sobre stacks, conversas técnicas e decisões importantes? Se inscreva no canal Dev Doido e faça parte dessa comunidade que acelera você para outro nível — Assista agora.