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-csssering gagal karena konflik versi PostCSS plugin — Tailwind dependencies bermasalah setelah upgrade Node:Error: PostCSS plugin tailwindcss requires PostCSS 8- Service PM2
web-tailwindberjalan 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.jsdanweb/static/css/tailwind.css(output build) - Konversi semua Tailwind classes di
security.htmlke inline CSS + CSS classes murni — mapping utility ke property CSS langsung - Hapus
whitenoise.middleware.WhiteNoiseMiddlewaredarisettings.py— hapus jugawhitenoisedariINSTALLED_APPS - Hapus service
web-tailwinddariecosystem.config.js - Hapus
package.jsondanpackage-lock.json— tidak lagi diperlukan pm2 delete web-tailwinddanpm2 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-4butuh pemahaman: itu> * + * { margin-top: 1rem }— gampang missed kalau cuma mapping 1:1 pm2 deleteberbeda denganpm2 stop— delete hapus dari daftar, stop cuma matikan. Pastikanpm2 savesetelah 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
Comments