Pular para o conteúdo
Documentação do Next.js PT-BR

Documentação do Next.js

Bem-vindo à documentação do Next.js!

O que é o Next.js?

O Next.js é um framework React para criar apps web full-stack. Você usa componentes React para construir interfaces, e o Next.js para recursos adicionais e otimizações.

Ele também configura automaticamente ferramentas de baixo nível, como bundlers e compiladores. Assim, você pode focar em construir seu produto e entregá-lo rapidamente.

Seja você um desenvolvedor individual ou parte de um time maior, o Next.js pode ajudar a criar apps React interativos, dinâmicos e rápidos.

Como usar a documentação

A documentação está organizada em 3 seções:

  • Primeiros passos: Tutoriais passo a passo para criar um novo app e conhecer os principais recursos do Next.js.
  • Guias: Tutoriais sobre casos de uso específicos. Escolha o que for relevante para você.
  • Referência da API: Referência técnica detalhada de cada recurso.

Use a barra lateral para navegar pelas seções, ou pesquise (Ctrl+K ou Cmd+K) para encontrar uma página rapidamente.

App Router e Pages Router

O Next.js tem dois roteadores diferentes:

  • App Router: O roteador mais novo, que aceita recursos recentes do React, como Server Components.
  • Pages Router: O roteador original, ainda com suporte e em constante melhoria.

No topo da barra lateral, você vai encontrar um menu suspenso que permite alternar entre a documentação do App Router e do Pages Router.

Como cada roteador lida com a versão do React

O App Router e o Pages Router tratam as versões do React de formas diferentes:

  • App Router: Usa de forma integrada as versões canary do React, que incluem todas as mudanças estáveis do React 19, além de recursos mais novos que estão sendo validados nos frameworks antes de um novo lançamento do React.

  • Pages Router: Usa a versão do React instalada no package.json do seu projeto.

Essa abordagem garante que os novos recursos do React funcionem de forma confiável no App Router, mantendo a retrocompatibilidade com os apps existentes que usam o Pages Router.

Conhecimentos prévios

A documentação pressupõe alguma familiaridade com desenvolvimento web. Antes de começar, convém que você se sinta à vontade com:

  • HTML
  • CSS
  • JavaScript
  • React

Se você é novo no React ou precisa de uma revisão, recomendamos começar pelo nosso curso React Foundations e pelo curso Next.js Foundations, em que você constrói um app enquanto aprende.

Acessibilidade

Para a melhor experiência com leitor de tela, recomendamos usar Firefox com NVDA, ou Safari com VoiceOver.

Participe da nossa comunidade

Se você tiver dúvidas sobre qualquer coisa relacionada ao Next.js, você pode perguntar à nossa comunidade quando quiser, no GitHub Discussions, no Discord, no X (Twitter) e no Reddit.

Próximos passos

Crie seu primeiro app e conheça os principais recursos do Next.js.