
Next.js vs TanStack Start: arquitetura, SSR e escolha de framework full-stack
A escolha de um framework full-stack para React deixou de ser óbvia. Next.js consolidou-se como padrão de mercado, mas TanStack Start surge com propostas distintas de roteamento, carregamento de dados e server functions. Este artigo compara os dois em arquitetura, SSR, cache e experiência do desenvolvedor, com exemplos de código e cenários reais de uso.
O que é cada framework, resumido
Next.js, mantido pela Vercel, é um meta-framework React que oferece SSR, SSG, ISR, API Routes e, desde a versão 13, o App Router com React Server Components (RSC). Ele abstrai o build, o servidor de desenvolvimento e a entrega de produção em uma única CLI.
TanStack Start, do ecossistema TanStack (criado por Tanner Linsley), é um framework full-stack sobre o TanStack Router. Ele foca em type-safe routing, data loading com TanStack Query e server functions via createServerFn, rodando sobre Vite com SSR opcional.
Comparação arquitetural
| Aspecto | Next.js App Router | TanStack Start |
|---|---|---|
| Bundler | Turbopack / webpack | Vite |
| Roteamento | Convenção de pastas (app/) | Arquivos em src/routes/ (flat, dot-separated) |
| Data loading | Server Components + fetch | TanStack Query + loaders/route |
| Server functions | Server Actions ("use server") | createServerFn do @tanstack/react-start |
| SSR model | Streaming SSR com RSC | SSR tradicional + streaming opcional |
| Cache | Next.js Cache (fetch, revalidate) | TanStack Query cache + headers manuais |
| Deploy | Vercel (otimizado), Node, Docker | Qualquer host com Node / Worker |
Server Components versus server functions
Next.js adota React Server Components como peça central. Componentes marcados como async rodam no servidor, acessam bancos de dados e retornam JSX serializável. A hidratação do cliente é reduzida, mas o modelo exige entender boundaries de servidor e cliente.
// Next.js App Router — Server Component
import { db } from "@/lib/db";
export default async function Page() {
const posts = await db.post.findMany({ take: 10 });
return (
<ul>
{posts.map((p) => (
<li key={p.id}>{p.title}</li>
))}
</ul>
);
}TanStack Start não usa Server Components. Em vez disso, loaders rodam no servidor durante o SSR e o resultado é hidratado no cliente via TanStack Query. As server functions (createServerFn) são chamadas do cliente como RPCs tipadas.
// TanStack Start — loader + server function
import { createFileRoute } from "@tanstack/react-router";
import { createServerFn } from "@tanstack/react-start";
const getPosts = createServerFn({ method: "GET" })
.handler(async () => {
const { data } = await supabase.from("posts").select("*").limit(10);
return data;
});
export const Route = createFileRoute("/posts")({
loader: async () => getPosts(),
component: PostsPage,
});Streaming e experiência do usuário
Next.js App Router implementa streaming de HTML com Suspense. Partes da página são enviadas assim que prontas, melhorando o Time to First Byte (TTFB) percebido. TanStack Start também suporta streaming, mas o modelo é mais explícito: o desenvolvedor controla o que é pré-carregado e o que é buscado no cliente.
Se seu projeto precisa de SEO agressivo e TTFB abaixo de 200 ms em escala, Next.js na Vercel tem vantagem operacional. Para aplicações com muita interatividade pós-load, TanStack Start oferece controle mais fino.
Type safety e DX
TanStack Start é notável pelo type safety de ponta a ponta. Rotas, parâmetros de URL, loaders e server functions são inferidos pelo TypeScript sem configuração adicional. Em Next.js, o type safety existe, mas depende mais de convenções de pastas e pode exigir tipos manuais em API Routes.
- TanStack Router gera tipos automaticamente a partir dos arquivos de rota.
- createServerFn valida input e output com Zod ou validadores customizados.
- Next.js requer cuidado ao tipar search params e segmentos dinâmicos manualmente.
Cenários de adoção
A escolha entre os frameworks depende de restrições de negócio e perfil do time.
- Prefira Next.js se você precisa de deploy rápido na Vercel, otimizações de imagem automáticas e um ecossistema vasto de exemplos e plugins.
- Prefira TanStack Start se você quer controle total sobre o bundler (Vite), já usa TanStack Query em projetos anteriores e valoriza rotas 100% type-safe.
- Times com forte cultura de backend-for-frontend podem achar Server Components mais naturais; times com APIs já consolidadas podem preferir loaders e server functions.
O mesmo recurso nos dois frameworks
Ver uma rota que carrega um post pelo id ajuda a entender a diferença de modelo mental. No Next.js com App Router, o próprio componente da página é um Server Component assíncrono e roda no servidor:
// app/posts/[id]/page.tsx — Next.js (App Router)
export default async function Page({ params }: { params: Promise<{ id: string }> }) {
const { id } = await params;
const post = await getPost(id); // executa apenas no servidor
return (
<article>
<h1>{post.title}</h1>
</article>
);
}No TanStack Start, o componente é um componente React comum. Os dados vêm de um loader, e o acesso ao banco fica atrás de uma server function, que funciona como uma chamada remota tipada entre cliente e servidor:
// src/routes/posts.$id.tsx — TanStack Start
import { createFileRoute } from "@tanstack/react-router";
import { createServerFn } from "@tanstack/react-start";
const getPost = createServerFn({ method: "GET" })
.inputValidator((id: string) => id)
.handler(async ({ data }) => fetchPostFromDb(data));
export const Route = createFileRoute("/posts/$id")({
loader: ({ params }) => getPost({ data: params.id }),
component: Page,
});
function Page() {
const post = Route.useLoaderData();
return (
<article>
<h1>{post.title}</h1>
</article>
);
}No primeiro caso, a fronteira entre servidor e cliente é definida por diretivas ("use client") e pelo tipo de componente. No segundo, ela é explícita na server function, e o loader roda tanto no servidor (na primeira carga) quanto no navegador (nas navegações seguintes). Nenhum dos dois é mais correto; são formas diferentes de organizar a mesma responsabilidade.
Checklist para decidir
- Equipe já experiente em Next.js e hospedagem na Vercel: o ganho de trocar raramente compensa o custo de migração.
- Aplicação muito interativa, com estado de URL complexo (filtros, abas, paginação): o roteamento tipado do TanStack Router reduz uma classe inteira de bugs.
- Site de conteúdo com muitas páginas estáticas: os dois atendem; compare o suporte a geração estática e cache no seu provedor.
- Necessidade de rodar fora da Vercel (Cloudflare, Node próprio, contêiner): verifique o adaptador oficial de cada framework para o seu destino antes de escolher.
- Dependência de bibliotecas que exigem Server Components: hoje o ecossistema é maior no Next.js.
- Maturidade: confira a versão estável atual e o histórico de mudanças incompatíveis de cada projeto antes de adotar em produção.
Conclusão
Next.js e TanStack Start não são substitutos diretos: são respostas a perguntas arquiteturais diferentes. Next.js aposta na visão da Vercel de edge computing e Server Components. TanStack Start aposta em controle, type safety e composição de bibliotecas já maduras. Avalie restrições de deploy, SEO e maturidade do time antes de decidir.
Perguntas frequentes
+TanStack Start é produção-ready em 2026?
Sim. A versão 1.x está estável, com documentação completa e comunidade ativa. Projetos novos podem adotar sem receio, embora o ecossistema de plugins seja menor que o de Next.js.
+Posso migrar de Next.js para TanStack Start?
A migração completa exige reescrever rotas, data loading e server functions. Componentes React puros reutilizam-se, mas a camada de servidor muda de modelo.
+Qual tem melhor performance em Core Web Vitals?
Ambos podem atingir bons scores. Next.js na Vercel tem otimizações de edge automáticas. TanStack Start depende mais da configuração de cache e do host escolhido.
+TanStack Start suporta deploy serverless?
Sim. O build gera um handler compatível com Node e Workers (Cloudflare). A configuração é manual em comparação com a Vercel, mas flexível.
Fontes consultadas
Histórico: publicado em ; atualizado em . Conteúdo educativo, sem patrocínio das ferramentas citadas. Encontrou um erro? Envie uma correção.
Leia também

Expressões regulares na prática: guia com exemplos em JavaScript e Python
O que são expressões regulares, a sintaxe essencial em uma tabela, exemplos testáveis em JavaScript e Python (datas, CEP, logs), diferença entre ganancioso e preguiçoso e como evitar ReDoS.

Cache em aplicações web: HTTP, CDN e Redis — onde guardar cada dado
Como funcionam as camadas de cache de uma aplicação web, quais cabeçalhos Cache-Control usar para cada tipo de recurso, o padrão cache-aside com Redis e como evitar dados velhos e vazamentos.

Serverless: quando funções serverless valem a pena (e quando viram armadilha)
AWS Lambda, Cloudflare Workers e Vercel Functions comparados: modelo de custo, cold starts, limites de execução e os workloads onde serverless brilha ou falha.