Разбор шаблона .gitignore для Next.js

Nextjs.gitignore почти совпадает с .gitignore, который создаёт create-next-app. Большинство правил начинаются с / и привязаны к корню репозитория, поэтому если в монорепозитории приложение лежит во вложенной папке, исправьте пути или используйте вместе с ним шаблон Node.

Next.js читает несколько файлов окружения: .env, .env.local, .env.development.local и другие. Этот шаблон исключает и .env, и .env*.local.

Разбор правил

Шаблон	Что и почему игнорируется
/.next//out//build	Сборка Next.jsРезультаты и кэш next build (.next) и результат статического экспорта (out). Они создаются заново при развёртывании.
/node_modules/.pnp.pnp.js	ЗависимостиРезультаты установки пакетов и файлы Yarn Plug'n'Play. Правила привязаны только к корню, поэтому node_modules во вложенных пакетах они не блокируют.
.env.env*.local	Переменные окруженияФайлы окружения с секретными значениями. Переменные с префиксом NEXT_PUBLIC_ попадают в результат сборки и видны в браузере, поэтому секреты используйте без этого префикса и только на сервере.
.vercelnext-env.d.ts*.tsbuildinfo	Файлы развёртывания и сгенерированные типыСведения о привязке проекта, созданные vercel link, файл объявлений типов, который Next.js пересоздаёт при разработке и сборке, и данные инкрементальной сборки TypeScript.
*.pem	СертификатыФайлы сертификатов и закрытых ключей (.pem) для локальной разработки по HTTPS или интеграции с внешними сервисами. Закрытые ключи не коммитят.
npm-debug.log*yarn-debug.log*yarn-error.log*/coverage.DS_Store	Логи и прочееЛоги менеджера пакетов, покрытие тестами и файлы Finder из macOS.

На что обратить внимание на практике

• В монорепозитории (apps/web) правила, привязанные к корню, вроде /node_modules, не применяются к вложенным приложениям. Если выбрать вместе с ним шаблон Node, node_modules/ будет игнорироваться на любой глубине.
• Настройки и lockfile, например next.config.js и package-lock.json, коммитьте.
• Вместо коммита .env делитесь именами нужных переменных в README или в .env.example.

Исходный шаблон

# 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

Шаблоны, используемые вместе

Разборы других шаблонов