// stack.lumi
Frontend

Next.js

Framework React para apps, sites e produtos com performance.

// o que é

Next.js adiciona roteamento, renderizacao, APIs e otimizacoes ao React. Para a Lumi Data, e uma escolha forte quando SEO, performance, conteudo e produto web precisam coexistir.

Next.js materializa os tradeoffs entre Client-Side Rendering (CSR), Server-Side Rendering (SSR) e Static Site Generation (SSG) em uma única framework com convenções claras para cada caso de uso. O CSR delega ao browser a montagem do HTML, reduzindo carga no servidor mas penalizando o First Contentful Paint em conexões lentas; o SSR gera HTML completo por requisição no servidor, melhorando LCP à custa de latência de servidor; o SSG pré-gera páginas em build time, eliminando latência de servidor para conteúdo estável. A Incremental Static Regeneration (ISR), introduzida pelo Vercel, combina os benefícios de SSG com revalidação em background, permitindo que páginas estáticas sejam atualizadas sem rebuild completo. O App Router com React Server Components representa a fronteira mais recente: componentes que executam exclusivamente no servidor, eliminam JavaScript no cliente e se compõem com Client Components por meio de uma fronteira explícita — uma resposta arquitetural direta ao problema de hidratação documentado por Osmani (2023).

Como a Lumi enxerga:A Lumi estrutura Next.js com design system, cache, seguranca e integracao backend para gerar produto profissional desde o MVP.
// na prática

Como empresas usam Next.js

01

Portal de conteúdo ou e-commerce com foco em SEO

Pages de produto e categoria são geradas via SSG ou ISR, garantindo que o crawler do Google receba HTML completo e que o LCP fique abaixo de 2,5 s mesmo em redes 3G. O App Router permite que componentes de layout e navegação sejam Server Components (zero JS no cliente) enquanto o carrinho e filtros de busca permanecem Client Components interativos.

02

Aplicação SaaS com área pública e área autenticada

Next.js unifica em um único repositório as páginas de marketing (SSG para SEO) e o dashboard logado (SSR com dados do usuário). Middleware de autenticação roda no Edge antes de qualquer renderização, eliminando flashes de conteúdo não autorizado e reduzindo round-trips de validação de sessão.

03

Data app ou frontend de plataforma interna

Server Actions e Route Handlers substituem uma API REST separada para operações simples de leitura e escrita, reduzindo a superfície de código e os deploys necessários. O time mantém um único repositório Next.js ao invés de frontend + backend Node.js separados, acelerando iterações em funcionalidades que tocam os dois lados.

// decisão técnica

Quando usar — e quando não usar

Use quando
  • O projeto mistura páginas públicas (SEO crítico) com áreas autenticadas (dados do usuário em tempo real) — Next.js gerencia ambas as estratégias de renderização no mesmo codebase
  • Performance percebida é um requisito de negócio: LCP abaixo de 2,5 s e INP abaixo de 200 ms são metas mensuráveis que SSR/SSG ajudam a atingir antes de otimizações de código
  • O time quer convenções fortes de roteamento, layouts e data fetching para evitar decisões de arquitetura repetitivas a cada novo feature
  • O frontend precisa de lógica de servidor leve (autenticação, transformação de dados, proxying de APIs) sem manter um serviço Node.js separado
  • O deployment é na Vercel ou em ambientes Edge (Cloudflare Workers, AWS Lambda@Edge) e o time quer explorar renderização geográfica distribuída
Evite quando
  • A aplicação é um SPA puro e totalmente autenticado (sem páginas públicas, sem requisito de SEO): React com Vite entrega DX superior e bundle menor sem o overhead de SSR
  • O time não tem familiaridade com os tradeoffs de hidratação do Next.js e vai misturar Client e Server Components sem entender a fronteira — o resultado é bugs sutis de estado e re-renders inesperados
  • A infraestrutura de deploy é exclusivamente um servidor de arquivos estáticos (S3 + CloudFront puro) sem suporte a funções serverless — Next.js com SSR exige runtime Node.js ou Edge Functions
  • O projeto é um microfrontend isolado que precisa ser embutido em um shell de outra framework — o modelo de roteamento do Next.js não foi projetado para esse padrão
// visão lumi

Next.js é nossa escolha default para frontends de produto que têm páginas públicas, SEO ou requisitos de performance de carregamento — não porque "todo mundo usa", mas porque o App Router resolve de forma elegante o problema de hidratar apenas o necessário. Monitoramos LCP, INP e CLS em produção com Real User Monitoring desde o primeiro deploy; métricas de Core Web Vitals são parte do Definition of Done para qualquer feature nova. Usamos Server Components para tudo que não precisa de interatividade no cliente, e resistimos à tentação de marcar componentes como "use client" por comodidade — cada adição de JavaScript no bundle precisa de justificativa de UX. Não usamos Next.js para projetos puramente internos sem páginas públicas: nesses casos, Vite + React é mais simples e mais rápido de operar.

Lumi escolhe quando

  • Frontend de produto com mix de conteúdo público (SEO/performance) e área logada (dados dinâmicos), onde uma única framework gerencia os dois mundos
  • Projetos onde o time quer Typescript, rotas baseadas em arquivo, layouts aninhados e data fetching com cache sem configurar tudo do zero
  • Aplicações que vão escalar em tráfego e precisam de ISR ou SSR no Edge para latência baixa sem infra de servidor dedicado
  • Data apps e portais de BI embarcados onde Server Components buscam dados diretamente do banco/API sem expor credenciais no cliente

Lumi não recomenda quando

  • SPAs internos e ferramentas de backoffice sem requisito de SEO — Vite + React tem DX mais simples, build mais rápido e zero overhead de SSR
  • Times sem experiência na distinção entre Server e Client Components no App Router — a curva de aprendizado gera bugs de hidratação que custam mais do que a escolha de uma framework mais simples
// aplicações

Onde essa tecnologia gera valor

01

Aplicacoes web modernas

A Lumi conecta essa aplicação ao objetivo de negócio, definindo arquitetura, dados, segurança e indicadores de sucesso antes da implementação.

02

Portais com SEO

A Lumi conecta essa aplicação ao objetivo de negócio, definindo arquitetura, dados, segurança e indicadores de sucesso antes da implementação.

03

Dashboards autenticados

A Lumi conecta essa aplicação ao objetivo de negócio, definindo arquitetura, dados, segurança e indicadores de sucesso antes da implementação.

04

Frontends integrados a APIs

A Lumi conecta essa aplicação ao objetivo de negócio, definindo arquitetura, dados, segurança e indicadores de sucesso antes da implementação.

// fundamentos

Referências acadêmicas e técnicas

Vercel. (2023). Next.js Documentation: App Router. nextjs.org/docs.

Documentação oficial do App Router com Server Components, Server Actions e estratégias de cache — referência primária para entender o modelo de renderização híbrida do Next.js moderno.

Google. (2020). Web Vitals: Essential metrics for a healthy site. web.dev/vitals.

Define LCP, INP e CLS como métricas de experiência do usuário que SSR e SSG do Next.js impactam diretamente, conectando decisões de renderização a resultados mensuráveis de performance.

Osmani, A. (2023). JavaScript Design Patterns (2nd ed.). O'Reilly Media.

Aborda o problema de hidratação em frameworks JavaScript e padrões de carregamento progressivo que fundamentam as decisões arquiteturais do Next.js App Router.

Berners-Lee, T., Fielding, R., & Masinter, L. (1998). Uniform Resource Identifiers (URI): Generic Syntax. RFC 2396. IETF.

Princípios de arquitetura web que fundamentam o sistema de roteamento baseado em arquivos do Next.js, conectando estrutura de diretórios a URLs semânticas e navegáveis.

Grigorik, I. (2013). High Performance Browser Networking. O'Reilly Media.

Explica como latência de rede, round-trips e tamanho de payload afetam a experiência percebida, fundamentando as decisões de SSG e SSR como estratégias de redução de TTFB e LCP.

// tecnologias relacionadas

Frontend

// próximo passo

Quer saber se esse stack faz sentido para você?

A Lumi avalia contexto, dados, equipe, custo e maturidade para recomendar a tecnologia certa e entregar com responsabilidade.