← Kembali

Tailwind CSS Dihapus Total — Operasi Bersih-Bersih Dependensi

cleanup css dependency tailwind

errors

  • Dual CSS system menyebabkan styling bentrok — Tailwind utility classes di-override CSS manual dan sebaliknya, hasil render tidak konsisten antar halaman
  • npm run build-css sering gagal karena konflik versi PostCSS plugin — Tailwind dependencies bermasalah setelah upgrade Node: Error: PostCSS plugin tailwindcss requires PostCSS 8
  • Service PM2 web-tailwind berjalan terus-menerus padahal build CSS jarang berubah — CPU usage kecil tapi memory terpakai percuma
  • Whitenoise middleware terdeteksi di settings.py tapi static files sebenarnya di-handle oleh Nginx — middleware hanya menambah overhead request: ValueError: The file '...' could not be found

context

Tailwind CSS diperkenalkan di awal project untuk mempercepat styling. Seiring waktu, developer mulai beralih ke CSS manual karena lebih fleksibel untuk komponen dashboard yang kompleks. Akhirnya terjadi campur aduk: sebagian elemen pakai Tailwind classes, sebagian pakai custom CSS, dan sebagian lagi pakai keduanya. Build pipeline npm tetap berjalan meski tidak lagi dibutuhkan.

problem

Dua sistem styling berjalan paralel — Tailwind untuk utility classes dan CSS manual untuk custom styling. Ini membuat debugging styling jadi sulit karena harus cek dua tempat. Build step npm (npm run build-css) adalah dependensi yang tidak perlu untuk project Django yang template-rendered — menambah kompleksitas deployment tanpa manfaat. Whitenoise juga tidak berguna karena static files sudah di-serve oleh reverse proxy (Nginx).

investigation

Dicek package.json untuk daftar dependensi npm — ditemukan tailwindcss, postcss, autoprefixer. Dicek settings.py — Whitenoise ada di MIDDLEWARE dan INSTALLED_APPS. Dicek ecosystem.config.js — ada service web-tailwind dengan npm run build-css. Dicek semua template untuk penggunaan class Tailwind — hanya security.html yang masih menggunakan Tailwind classes secara signifikan. Sisanya sudah menggunakan CSS manual atau inline.

root-cause

Tailwind dipilih di awal karena cepat untuk prototyping, tapi tidak pernah dire-evaluasi ketika project beralih ke custom CSS. Build pipeline tetap dipertahankan karena "tidak rusak, tidak perlu diperbaiki" — sampai dependencies mulai bermasalah. Whitenoise adalah sisa dari tutorial Django awal yang tidak pernah dibersihkan.

solution

  • npm uninstall tailwindcss — hapus package dan semua dependensi PostCSS
  • Hapus tailwind.config.js dan web/static/css/tailwind.css (output build)
  • Konversi semua Tailwind classes di security.html ke inline CSS + CSS classes murni — mapping utility ke property CSS langsung
  • Hapus whitenoise.middleware.WhiteNoiseMiddleware dari settings.py — hapus juga whitenoise dari INSTALLED_APPS
  • Hapus service web-tailwind dari ecosystem.config.js
  • Hapus package.json dan package-lock.json — tidak lagi diperlukan
  • pm2 delete web-tailwind dan pm2 save

insight

Tailwind cocok untuk prototyping cepat tapi untuk project dengan custom UI components yang kompleks, CSS manual memberi kontrol lebih besar. Jangan biarkan dual CSS system bertahan — pilih satu dan migrasi total. Evaluasi dependensi secara berkala: kalau ada package yang sudah tidak dipakai di kode, hapus. Build steps yang tidak benar-benar dibutuhkan hanya menambah failure point di deployment.

# Cara cek dependensi yang tidak terpakai:
# npm ls --depth=0  -> lihat package terinstall
# grepuard: tailwind.config.js tidak pernah disentuh setelah initial setup

gotchas

  • Tailwind purge/JIT bisa hapus class yang dipakai di Django template karena class name muncul dari concatenation — harus hati-hati waktu migrasi
  • Inline CSS tidak support pseudo-classes (:hover, :focus) — perlu CSS classes terpisah untuk interactive states
  • Konversi Tailwind space-y-4 butuh pemahaman: itu > * + * { margin-top: 1rem } — gampang missed kalau cuma mapping 1:1
  • pm2 delete berbeda dengan pm2 stop — delete hapus dari daftar, stop cuma matikan. Pastikan pm2 save setelah delete
  • Whitenoise di settings mungkin direferensi di tempat lain (test, deployment script) — cek semua file sebelum hapus middleware
  • Zero visual regression harus diverifikasi di semua halaman — bukan cuma halaman yang di-edit

Terakhir diperbarui 31 Jul 2026 00:15

Comments