Plantilla .gitignore de Next.js explicada

Nextjs.gitignore tiene casi la misma composición que el .gitignore que crea create-next-app. La mayoría de las reglas empiezan por / y quedan fijadas a la raíz del repositorio, así que si en un monorepo la app está en una subcarpeta, ajusta las rutas o usa también la plantilla de Node.

Next.js lee varios archivos de entorno, como .env, .env.local y .env.development.local. Esta plantilla excluye tanto .env como .env*.local.

Explicación regla por regla

Patrón	Qué ignora y por qué
/.next//out//build	Compilación de Next.jsSon los resultados y la caché de next build (.next) y el resultado de la exportación estática (out). Se vuelven a crear durante la implementación.
/node_modules/.pnp.pnp.js	DependenciasSon los resultados de instalar paquetes y los archivos de Yarn Plug'n'Play. Solo están fijados a la raíz, así que no bloquean los node_modules de los subpaquetes.
.env.env*.local	Variables de entornoSon archivos de entorno con valores secretos. Las variables que empiezan por NEXT_PUBLIC_ se incluyen en el resultado de compilación y quedan expuestas en el navegador, así que los secretos se usan sin ese prefijo y solo en el servidor.
.vercelnext-env.d.ts*.tsbuildinfo	Archivos de implementación y de tipos generadosSon la información de vinculación del proyecto creada por vercel link, el archivo de declaración de tipos que Next.js vuelve a generar en desarrollo y compilación, y la información de compilación incremental de TypeScript.
*.pem	CertificadosSon archivos de certificado y clave privada (.pem) usados para el desarrollo local con HTTPS o la integración con servicios externos. Las claves privadas no se confirman.
npm-debug.log*yarn-debug.log*yarn-error.log*/coverage.DS_Store	Registros y otrosSon registros del gestor de paquetes, la cobertura de pruebas y el archivo del Finder de macOS.

Precauciones en la práctica

• En un monorepo (apps/web), las reglas fijadas a la raíz como /node_modules no se aplican a las apps de subcarpetas. Si seleccionas también la plantilla de Node, se capturan los node_modules/ a cualquier profundidad.
• Confirma la configuración y el lockfile, como next.config.js y package-lock.json.
• En lugar de confirmar .env, comparte los nombres de las variables necesarias en el README o en .env.example.

Plantilla 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

Plantillas que suelen usarse juntas

Otras plantillas explicadas