Nodemon Hilang saat Deploy? Cara Mengatasi DevDependency Tidak Terinstall

Nodemon hilang setelah deploy karena npm sengaja melewatkan devDependencies saat NODE_ENV=production aktif. Perintah seperti npm ci --omit=dev atau npm install --production hanya memasang dependencies. Solusinya pasang ulang tanpa flag omit, lalu pastikan nodemon memang tercatat di devDependencies.

Penyebab DevDependency Tidak Terinstall di Node.js

npm versi baru otomatis memangkas dev saat mode production aktif. Platform deploy seperti VPS, Docker, atau PaaS sering menyetel NODE_ENV=production secara default.

  • NODE_ENV=production membuat npm mengabaikan devDependencies.
  • Flag --omit=dev dan --production punya efek yang sama.
  • npm ci menghapus node_modules lalu install ulang sesuai lockfile, sehingga dev yang sebelumnya ada bisa hilang.
  • package.json salah menaruh paket, atau package-lock.json tidak ikut di-commit, membuat hasil install di server berbeda.

Cek log deploy dahulu. Cari baris berisi omit dev, production mode, atau added X packages, removed Y packages.

Masalah Penyebab Solusi
Nodemon hilang setelah deploy Install jalan dengan --omit=dev Install ulang dengan --include=dev
npm ci hanya pasang dependencies NODE_ENV=production aktif Set NODE_ENV=development saat build
Script dev gagal jalan Nodemon tidak ada di package.json Tambahkan ke devDependencies

Cara Memperbaiki DevDependency Tidak Terinstall

Ikut urutan ini agar diagnosis tidak menebak-nebak:

  1. Periksa package.json. Pastikan nodemon ada di devDependencies, bukan hanya terpasang global di laptop.
  2. Cek environment server. Jalankan perintah cek NODE_ENV sebelum install ulang.
  3. Install ulang tanpa pemangkasan dev. Gunakan npm ci --include=dev bila lockfile tersedia.
  4. Verifikasi paket dengan npm ls nodemon. Perintah harus menampilkan versi, bukan pesan extraneous atau kosong.
echo $NODE_ENV
npm install
npm ci --include=dev
npm ls nodemon

Jangan langsung memakai --legacy-peer-deps, menghapus package-lock.json, atau menghapus node_modules sebagai langkah pertama. Ketiganya menyembunyikan konflik versi dan bisa membuat deploy berikutnya tidak konsisten. Pakai hanya setelah pesan error menunjukkan konflik peer dependency atau file corrupt.

FAQ

Kenapa npm install tidak memasang devDependencies di server?

Karena server berjalan dengan NODE_ENV=production atau perintah install memakai --omit=dev.

Apakah devDependencies dibutuhkan saat production berjalan?

Tidak untuk runtime, nodemon idealnya hanya dipakai development dan production memakai node atau process manager.

Bagaimana install devDependencies tanpa merusak package-lock.json?

Gunakan npm ci --include=dev agar install tetap mengikuti lockfile tanpa mengubah rentang versi.