github/gitignore · Nextjs.gitignore
Penjelasan template .gitignore Next.js
Menjelaskan mengapa Nextjs.gitignore mengabaikan .next, out, node_modules, file .env, .vercel, next-env.d.ts, dan *.pem, serta perbedaannya dengan template Node.
Nextjs.gitignore hampir sama susunannya dengan .gitignore yang dibuat create-next-app. Sebagian besar aturannya diawali / sehingga terpaku pada root repositori, jadi jika aplikasi berada di subfolder monorepo, sesuaikan path-nya atau gunakan juga template Node.
Next.js membaca beberapa file lingkungan seperti .env, .env.local, dan .env.development.local. Template ini mengecualikan .env dan .env*.local sekaligus.
Penjelasan per aturan
| Pola | Apa yang diabaikan dan mengapa |
|---|---|
/.next//out//build | Build Next.jsHasil dan cache next build (.next) serta hasil ekspor statis (out). Dibuat ulang dalam proses deployment. |
/node_modules/.pnp.pnp.js | DependensiHasil instalasi paket dan file Yarn Plug'n'Play. Karena hanya terpaku pada root, node_modules di paket turunan tidak terblokir. |
.env.env*.local | Variabel lingkunganFile lingkungan yang berisi nilai rahasia. Variabel yang diawali NEXT_PUBLIC_ ikut masuk ke hasil build dan terekspos ke browser, jadi gunakan rahasia tanpa awalan tersebut dan hanya di server. |
.vercelnext-env.d.ts*.tsbuildinfo | File deployment dan hasil generate tipeInformasi tautan proyek yang dibuat vercel link, file deklarasi tipe yang dibuat ulang Next.js saat pengembangan dan build, serta informasi build inkremental TypeScript. |
*.pem | SertifikatFile sertifikat dan kunci privat (.pem) untuk pengembangan HTTPS lokal atau integrasi layanan eksternal. Kunci privat tidak di-commit. |
npm-debug.log*yarn-debug.log*yarn-error.log*/coverage.DS_Store | Log dan lainnyaLog package manager, coverage pengujian, dan file Finder macOS. |
Hal yang perlu diperhatikan dalam praktik
- Di monorepo (
apps/web), aturan yang terpaku pada root seperti/node_modulestidak berlaku untuk aplikasi di subfolder. Jika template Node dipilih bersama,node_modules/di kedalaman berapa pun akan tertangkap. - Commit pengaturan dan lockfile seperti
next.config.jsdanpackage-lock.json. - Alih-alih meng-commit
.env, bagikan nama variabel yang diperlukan lewat README atau.env.example.
Template asli
Nextjs.gitignore
# 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
Sumber template: github/gitignore/Nextjs.gitignore @356fd7b (2026-09-11) · CC0-1.0