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

Estrutura e organização do projeto

Esta página apresenta uma visão geral de todas as convenções de pastas e arquivos do Next.js, e recomendações para organizar seu projeto.

Convenções de pastas e arquivos

Pastas de nível superior

As pastas de nível superior são usadas para organizar o código e os ativos estáticos do seu app.

Segmentos de rota para segmentos de caminhoSegmentos de rota para segmentos de caminho
appApp Router
pagesPages Router
publicAtivos estáticos a serem servidos
srcPasta opcional com o código-fonte do app

Arquivos de nível superior

Os arquivos de nível superior são usados para configurar seu app, gerenciar dependências, executar o proxy, integrar ferramentas de monitoramento e definir variáveis de ambiente.

Next.js
next.config.jsArquivo de configuração do Next.js
package.jsonDependências e scripts do projeto
instrumentation.tsArquivo de OpenTelemetry e instrumentação
proxy.tsProxy de requisições do Next.js
.envVariáveis de ambiente (não devem ser versionadas)
.env.localVariáveis de ambiente locais (não devem ser versionadas)
.env.productionVariáveis de ambiente de produção (não devem ser versionadas)
.env.developmentVariáveis de ambiente de desenvolvimento (não devem ser versionadas)
eslint.config.mjsArquivo de configuração do ESLint
.gitignoreArquivos e pastas do Git a serem ignorados
next-env.d.tsArquivo de declaração TypeScript do Next.js (não deve ser versionado)
tsconfig.jsonArquivo de configuração do TypeScript
jsconfig.jsonArquivo de configuração do JavaScript

Convenções de arquivos

_app.js .jsx .tsxApp personalizado
_document.js .jsx .tsxDocumento personalizado
_error.js .jsx .tsxPágina de erro personalizada
404.js .jsx .tsxPágina de erro 404
500.js .jsx .tsxPágina de erro 500

Rotas

Convenção de pastas
index.js .jsx .tsxPágina inicial
folder/index.js .jsx .tsxPágina aninhada
Convenção de arquivos
index.js .jsx .tsxPágina inicial
file.js .jsx .tsxPágina aninhada

Rotas dinâmicas

Convenção de pastas
[folder]/index.js .jsx .tsxSegmento de rota dinâmico
[...folder]/index.js .jsx .tsxSegmento de rota catch-all
[[...folder]]/index.js .jsx .tsxSegmento de rota catch-all opcional
Convenção de arquivos
[file].js .jsx .tsxSegmento de rota dinâmico
[...file].js .jsx .tsxSegmento de rota catch-all
[[...file]].js .jsx .tsxSegmento de rota catch-all opcional