← voltar Janela do navegador com uma forma de átomo acima de um trilho de ferrovia que se bifurca em direção a duas pilhas de servidores

O que é TanStack Start? Um Guia 2026 vs Next.js

Next.js e headless

TanStack Start é um framework React full-stack baseado em TanStack Router, oferecendo SSR de documento completo, streaming e server functions com type-safety. Seu anúncio da versão 1.0 em 13 de outubro de 2026 o declara pronto para produção. Ele constrói com Vite ou Rsbuild. Next.js ainda possui o ecossistema maior e a história mais madura de React Server Components, então a escolha não é automática. Abaixo você encontra do que Start é feito, como routing, loaders e server functions funcionam juntos, o que "estável" resolve e não resolve, onde faz deploy, e o mesmo pequeno app esboçado em ambos os frameworks com uma tabela de escolha por projeto.

O que é TanStack Start

A visão geral oficial o define em uma linha: um framework React full-stack baseado em TanStack Router, com SSR de documento completo, streaming, server functions e builds client/server. (A homepage também o promove para Solid, mas este guia se concentra em React.)

Pense nisso como três camadas. Na base fica sua aplicação: componentes, data clients, comportamento do produto. No meio fica TanStack Router, sustentando a árvore de rotas, URL state, loaders, links e boundaries. No topo, Start adiciona a camada de servidor: SSR, streaming, server functions, server routes e middleware.

Essa camada do meio importa mais do que parece. A documentação diz que Start depende 100% de TanStack Router para routing. Se você já gosta do router, você já conhece a maior parte do framework.

Router, Vite e a questão do Nitro

A visão geral nomeia duas dependências: TanStack Router, e Vite ou Rsbuild como a ferramenta de build. Essa é a linha oficial.

Artigos de terceiros adicionam mais detalhes, e eles não concordam. MakerKit e Kanopy Labs descrevem Nitro como a camada de servidor, e TurboStarter diz que alvos Vercel e Node/Docker passam por Nitro. Build with Matija descreve Vinxi como a abstração de bundler. A página de visão geral não menciona nenhum dos dois. Meu conselho: trate a documentação da versão exata que você instala como a fonte da verdade, e trate posts sobre internals como snapshots desatualizados (vários foram escritos enquanto Start ainda era um release candidate).

Apenas o Router, ou o framework inteiro?

A documentação é refrescantemente direta aqui. Se você sabe com certeza que não precisará de SSR, streaming, server functions, middleware ou builds full-stack, use TanStack Router sozinho. Uma SPA apenas para client não precisa de um framework de servidor. A maioria dos produtos eventualmente quer um servidor, e é aí que Start ganha seu lugar.

O histórico é curto. Por volta de dezembro de 2023 o repo já tinha utilitários de servidor que se tornaram os primeiros prenúncios de Start, e em maio de 2024 um commit renomeou o pacote react-router-server para start, conforme o post da 1.0. Router veio primeiro, e Start cresceu ao seu redor.

Routing e loaders

O relato de Tanner Linsley sobre a origem vale a pena ler: ele queria rotas que soubessem quais paths existiam, quais params elas precisavam, quais search params eram válidos, o que loader data retornava e qual contexto estava disponível pela árvore. Os tipos fluem pela árvore de rotas, então mudar uma coisa faz seu editor te dizer o que mais quebrou.

Esse é o pitch, e é um bom. Qualquer pessoa que tenha digitado manualmente resultados de useSearchParams conhece a dor.

O ciclo de vida da requisição

A homepage do Start mostra o que acontece em um carregamento completo de página. No servidor:

  1. beforeLoad é executado.
  2. loader é executado.
  3. O componente é renderizado.
  4. HTML faz streaming para o navegador.

Depois, no navegador, o HTML hidrata e a navegação do lado do cliente assume o controle. Mesma árvore de rotas em ambos os lados.

Então, onde você coloca uma verificação de autenticação? beforeLoad roda antes do loader, o que a torna o portão natural (e middleware está lá para contexto e política, mais sobre isso abaixo). Busca de dados pertence ao loader. O componente continua sendo um componente.

O que o router oferece gratuitamente

A visão geral lista roteamento aninhado, parâmetros de pesquisa e carregamento de dados como recursos do Router. Start adiciona a metade do servidor: Server Routes e API Routes para endpoints de backend ao lado do seu frontend, além de middleware e contexto. Se seu app está cheio de filtros, tabelas e estado de URL (dashboards, ferramentas admin, UIs de busca), essa história tipada de search-param é o argumento mais forte para Start. Se for principalmente páginas de marketing, importa muito menos.

Server functions versus Server Actions

Ambas permitem chamar código do servidor a partir do código do cliente sem escrever fetch manualmente. As filosofias diferem.

As server functions do Start são simples, explícitas e tipadas. O exemplo da homepage fica assim: createServerFn({ method: 'GET' }), depois .validator(projectSchema), depois .handler(({ data }) => db.projects.find(data.id)). Requisição validada, handler só no servidor, resultado tipado na saída. Os docs as descrevem como RPCs type-safe entre cliente e servidor.

Uma pequena advertência. Esse trecho é da homepage na época da escrita, e a comparação de outubro de 2026 do MakerKit observa que as APIs do Start mudam com mais frequência que as do Next.js. Consulte o guia Server Functions para a versão que você está usando antes de copiar qualquer coisa.

Três ferramentas para o limite do servidor

A homepage divide o trabalho do servidor em três ferramentas:

  • Server functions para chamadas type-safe do seu próprio app.
  • Server routes para chamadores externos (webhooks, terceiros, clientes mobile).
  • Middleware para autenticação, contexto, logging e política.

Gosto dessa divisão. Força uma decisão sobre quem está chamando, e essa decisão geralmente molda o design correto.

Onde Server Actions se encaixam

Next.js é a opção mais madura para Server Actions e RSC, segundo TurboStarter, que fornece starters de produção em ambos os frameworks. Os docs do Next.js dizem que o App Router suporta novos recursos React como Server Components e usa lançamentos React canary integrados. Você recebe novos recursos React mais cedo, pelo preço de mais comportamento no nível do framework para aprender.

Caching é o contraste mais marcante. TurboStarter lista "server functions explícitas em vez de caching no nível do framework" como razão para escolher Start. Do lado do Next.js, 16.4 (6 outubro de 2026) recomenda Cache Components, segundo o mesmo post. Nenhum está errado. Um oferece mais maquinaria integrada; o outro oferece menos surpresas.

TanStack Start está pronto para produção?

A resposta oficial é sim. A visão geral traz uma nota de que Start é estável e aponta usuários de release candidate para um guia de migração. O post 1.0, datado de 13 outubro de 2026, diz que é finalmente estável e oficialmente pronto para produção.

Dois detalhes desse post valem a pena considerar. Primeiro, o autor diz que equipes colocaram Start em produção por quase todos os estágios do seu desenvolvimento, de pequenos projetos e startups a equipes enterprise e empresas da Fortune 500. Segundo, 1.0 é descrito como um compromisso formal com as APIs e as pessoas construindo sobre elas. Esse segundo ponto é a notícia real. Uso já estava lá; a promessa de não reescrever seu modelo de aplicação é nova.

Por que você pode ter lido "ainda RC"

Se você viu comparações mais antigas dizendo que os docs ainda a chamam de release candidate, é explicável. Um post do TurboStarter datado de 9 outubro de 2026 relatou exatamente isso, quatro dias antes do anúncio 1.0. A visão geral atual diz estável. Datas importam com esse framework, então as verifique em toda comparação que ler (incluindo esta).

As ressalvas que eu realmente me preocuparia

Maturidade não é apenas um número de versão. Aqui está o que eu pesaria:

  • Ecossistema mais jovem. Menos tutoriais, menos starter kits, menos respostas quando você fica preso. A comparação da Netlify (11 agosto de 2026) é direta que a lacuna de maturidade é real.
  • RSC é experimental. O guia de Server Components diz que a API pode sofrer refinamentos, não está habilitada por padrão e precisa de React 19+ mais Vite 8+ ou Rsbuild 2+. Não construa sua arquitetura sobre ela ainda.
  • Um incidente na cadeia de suprimentos. Em 2026-05-11, entre 19:20 e 19:26 UTC, um atacante publicou 84 versões maliciosas em 42 pacotes @tanstack/*. O postmortem do TanStack diz que apenas o repositório Router/Start foi afetado e emitiu um comunicado de tudo bem em 2026-05-15. É um bom postmortem, e ainda é um motivo para fixar versões e usar um lockfile com qualquer dependência em rápida evolução.

Nada disso a desqualifica. Significa que uma equipe sem confiança em TypeScript ou tempo para ler código-fonte sentirá mais atrito do que no Next.js.

Onde você pode implantá-lo

A afirmação de portabilidade do Start é específica: mudanças na configuração de deployment; a autoria de rotas e limites de servidor não. O guia de hospedagem diz que Start suporta Vite e Rsbuild, oferecendo saídas de build flexíveis para diferentes provedores e runtimes.

Duas janelas de navegador correspondentes lado a lado com um caminho bifurcado entre elas e uma bússola apontando para a da esquerda

Segundo o resumo de 9 de outubro de 2026 do TurboStarter do guia de hospedagem, os parceiros oficiais são Cloudflare, Netlify e Railway. Os alvos documentados também incluem Vercel e Node/Docker (ambos via Nitro), Bun e Appwrite Sites. Essa é uma lista ampla para um framework tão jovem, e cada host nela tem um caminho viável.

Modos de renderização

Os docs listam vários: Selective SSR, SPA Mode, Static Prerendering e Incremental Static Regeneration. Uma revisão de terceiros (Kanopy Labs) chama Start de SSR-first e diz que geração estática não é um caso de uso primário. Os docs mostram que é suportado, então eu leria isso como uma ênfase, não um limite. Se seu site é principalmente conteúdo estático, teste o guia de prerendering contra suas páginas reais antes de se comprometer.

Escolhendo um alvo

  • Cloudflare Workers: TurboStarter relata a implantação do Start lá e gosta do pequeno runtime.
  • Netlify: suporta Start e Next.js como frameworks de primeira classe, conforme sua própria comparação.
  • Vercel: funciona via Nitro, e ainda é a casa da hospedagem Next.js de primeira classe.
  • Seu próprio servidor: Node ou Docker, mesmo código de rota.

Nenhuma opção ruim nessa lista. A verdadeira questão é qual sua equipe já executa.

TanStack Start vs Next.js: quando escolher cada um

A comparação completa de três frameworks vive em Next.js vs Remix vs Astro, e o conjunto mais amplo fica no hub de web frameworks. Esta seção fica em Start versus Next.js.

O mesmo app pequeno, lado a lado

Pegue um app minúsculo: uma página atrás de um login, dados para essa página e uma chamada do lado do servidor. Aqui está como cada peça se mapeia. Este é um esboço ilustrativo da forma, não código tirado dos docs de nenhum projeto.

Peça do appTanStack StartNext.js (App Router)
Página com gate de autenticaçãoUma rota cuja beforeLoad roda no servidor primeiro; middleware pode anexar o usuário ao contextoUma verificação na página renderizada no servidor ou layout, ou proxy.ts (que substituiu middleware.ts no Next.js 16) para gating grosseiro
Dados para a páginaUm carregador de rota tipado através da árvore de rotasUm Server Component buscando dados no próprio componente
Chamada somente servidorcreateServerFn com um validador e um manipulador, chamado do carregador ou de um componenteUma Server Action ou uma chamada de Server Component
Tipos através da fronteiraFluxo do validador e manipulador através da árvore de rotasTypeScript padrão; o quanto funciona depende de como você estrutura o código
CacheDecidido explicitamente por vocêNível de framework, com Cache Components recomendados desde 16.4

A coluna Next.js se apoia no App Router, que a documentação do Next.js descreve como o roteador mais novo (o Pages Router ainda é suportado e está sendo melhorado). Mesmo aplicativo, centro de gravidade diferente: Start coloca a árvore de rotas no controle, Next.js coloca o server component no controle.

Escolha por projeto

ProjetoIncline-se paraPor quê
Dashboard SaaS com filtros e tabelas na URLStartRoteamento e parâmetros de busca com segurança de tipo
Site público com muito conteúdo onde RSC é centralNext.jsRSC maduro hoje
Aplicativo web compartilhando um backend com React NativeNext.jsEscolha do TurboStarter para essa configuração
Projeto Payload CMSNext.jsPayload funciona nativamente dentro do Next.js; com Start é um aplicativo separado consumindo Payload como uma API
Alvo Cloudflare WorkersStartTempo de execução pequeno que faz deploy de forma limpa lá
Fluxo de trabalho focado em VercelNext.jsHospedagem em Vercel como primeira classe
Time já usa TanStack Router e QueryStartO mesmo modelo mental, conforme o guia da Netlify
Precisa contratar rápido, ou genuinamente tem dúvidaNext.jsMaior base de candidatos e mais documentação

Essa última linha não é timidez da minha parte. O conselho do MakerKit é usar Next.js como padrão quando tem dúvida, por causa de mais documentação, mais candidatos disponíveis para contratar e uma implementação RSC estável. Concordo com isso.

Como eu decidiria

Comece pelos dados. Se seu app é uma ferramenta tipada e dirigida por URL e seu time escreve TypeScript rigoroso, Start se encaixa naturalmente. Se suas páginas são principalmente conteúdo e você quer RSC, Next.js se encaixa. Depois veja onde faz deploy e quem você consegue contratar, porque geralmente essas decisões são as que decidem. O guia da Netlify enquadra o ponto de governança com justiça: Start é adequado para times que preferem um framework governado independentemente de qualquer host único.

Se você optar por Next.js e precisar de pessoas para construir, você pode contratar um desenvolvedor Next.js. E se você já está usando e avaliando um salto de versão, o guia de atualização Next.js 16 cobre esse caminho (Turbopack como bundler padrão e a mudança proxy.ts são os destaques).

FAQ

TanStack Start é gratuito?

Sim. A visão geral diz que TanStack é 100% de código aberto, gratuito para usar e sempre será. TanStack.com é de propriedade de TanStack LLC, uma empresa privada, bootstrapped, sem investimento de venture capital. Parceiros ativos fornecem apoio financeiro e recursos.

Posso mover um app Next.js existente para Start?

A documentação do Start inclui um guia dedicado Migrate from Next.js na seção de primeiros passos, então esse é o lugar para começar. Reserve tempo para reescrever data fetching e caching, já que os dois frameworks lidam com eles de forma diferente.

Start funciona apenas com React?

A página inicial o descreve como um framework full-stack para React e Solid. Este guia cobre o lado React, e a documentação de React é o que linkei.

Devo usá-lo para um site de brochura principalmente estático?

Provavelmente não como sua primeira escolha. Start oferece suporte a Static Prerendering e ISR, mas revisores terceirizados o descrevem como SSR-first, e Next.js tem os modos de renderização mais profundos além de RSC maduro. Um site de conteúdo simples raramente precisa dos pontos fortes de roteamento tipado do Start.

Start é estável desde o post 1.0 de 13 de outubro de 2026, mas é mais jovem que Next.js, seu suporte RSC é experimental, e fixar versões é sensato. Escolha quando rotas tipadas e search params importam mais para seu app, e escolha Next.js quando ecossistema, contratação ou RSC lidera sua lista.

← voltar