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.
As pastas de nível superior são usadas para organizar o código e os ativos estáticos do seu app.

| |
|---|
app | App Router |
pages | Pages Router |
public | Ativos estáticos a serem servidos |
src | Pasta opcional com o código-fonte do app |
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.js | Arquivo de configuração do Next.js |
package.json | Dependências e scripts do projeto |
instrumentation.ts | Arquivo de OpenTelemetry e instrumentação |
proxy.ts | Proxy de requisições do Next.js |
.env | Variáveis de ambiente (não devem ser versionadas) |
.env.local | Variáveis de ambiente locais (não devem ser versionadas) |
.env.production | Variáveis de ambiente de produção (não devem ser versionadas) |
.env.development | Variáveis de ambiente de desenvolvimento (não devem ser versionadas) |
eslint.config.mjs | Arquivo de configuração do ESLint |
.gitignore | Arquivos e pastas do Git a serem ignorados |
next-env.d.ts | Arquivo de declaração TypeScript do Next.js (não deve ser versionado) |
tsconfig.json | Arquivo de configuração do TypeScript |
jsconfig.json | Arquivo de configuração do JavaScript |
| | |
|---|
_app | .js .jsx .tsx | App personalizado |
_document | .js .jsx .tsx | Documento personalizado |
_error | .js .jsx .tsx | Página de erro personalizada |
404 | .js .jsx .tsx | Página de erro 404 |
500 | .js .jsx .tsx | Página de erro 500 |
| | |
|---|
| Convenção de pastas | | |
index | .js .jsx .tsx | Página inicial |
folder/index | .js .jsx .tsx | Página aninhada |
| Convenção de arquivos | | |
index | .js .jsx .tsx | Página inicial |
file | .js .jsx .tsx | Página aninhada |