Template .gitignore do Next.js explicado

O Nextjs.gitignore tem quase a mesma composição do .gitignore criado pelo create-next-app. A maioria das regras começa com / e fica fixa na raiz do repositório, então, se em um monorepo o app estiver em uma subpasta, ajuste os caminhos ou use também o template do Node.

O Next.js lê vários arquivos de ambiente, como .env, .env.local e .env.development.local. Este template exclui tanto .env quanto .env*.local.

Explicação regra por regra

Padrão	O que ignora e por quê
/.next//out//build	Build do Next.jsSão os resultados e o cache do next build (.next) e o resultado da exportação estática (out). São criados de novo durante a implantação.
/node_modules/.pnp.pnp.js	DependênciasSão os resultados da instalação de pacotes e os arquivos do Yarn Plug'n'Play. Estão fixos só na raiz, então não bloqueiam os node_modules dos subpacotes.
.env.env*.local	Variáveis de ambienteSão arquivos de ambiente com valores secretos. Variáveis que começam com NEXT_PUBLIC_ entram no resultado do build e ficam expostas no navegador, então os segredos são usados sem esse prefixo e apenas no servidor.
.vercelnext-env.d.ts*.tsbuildinfo	Arquivos de implantação e de tipos geradosSão as informações de vínculo do projeto criadas pelo vercel link, o arquivo de declaração de tipos que o Next.js gera de novo no desenvolvimento e no build, e as informações de build incremental do TypeScript.
*.pem	CertificadosSão arquivos de certificado e chave privada (.pem) usados no desenvolvimento local com HTTPS ou na integração com serviços externos. Chaves privadas não são commitadas.
npm-debug.log*yarn-debug.log*yarn-error.log*/coverage.DS_Store	Logs e outrosSão logs do gerenciador de pacotes, a cobertura de testes e o arquivo do Finder do macOS.

Cuidados na prática

• Em um monorepo (apps/web), regras fixadas na raiz como /node_modules não se aplicam aos apps em subpastas. Se você selecionar também o template do Node, os node_modules/ são pegos em qualquer profundidade.
• Commite as configurações e o lockfile, como next.config.js e package-lock.json.
• Em vez de commitar o .env, compartilhe os nomes das variáveis necessárias no README ou no .env.example.

Template original

# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.# dependencies/node_modules/.pnp.pnp.js# testing/coverage# next.js/.next//out/# production/build# misc.DS_Store*.pem# debugnpm-debug.log*yarn-debug.log*yarn-error.log*# local env files.env*.local.env# vercel.vercel# typescript*.tsbuildinfonext-env.d.ts

Templates usados em conjunto

Outros templates explicados