Pursem LogoPursem
Kembali ke Blog

Cara Mengatasi Error npx tailwindcss init pada Tailwind CSS

7 Juli 2026
Bagikan:

Dalam tutorial kali ini, kita akan membahas cara mengatasi salah satu masalah yang sering ditemui oleh para developer saat baru melakukan instalasi Tailwind CSS di lingkungan Windows menggunakan Node Package Manager (npm).

Masalah ini biasanya muncul di awal proyek. Saat mencoba membuat file konfigurasi Tailwind CSS menggunakan perintah:

npx tailwindcss init

Penyebab Utama

Error ini biasanya terjadi jika Anda menggunakan Tailwind CSS v4 atau versi di atasnya yang diinstal melalui perintah npm install -D tailwindcss.

Mulai versi 4+, tim Tailwind tidak lagi menyertakan binary CLI (tailwindcss) di dalam folder node_modules/.bin. Mereka menyarankan untuk menggunakan standalone binary secara terpisah. Akibatnya:

  • Perintah npx tailwindcss init gagal karena npx tidak menemukan file executable yang bisa dijalankan.
  • Menjalankan perintah lokal .\node_modules\.bin\tailwindcss juga akan gagal karena filenya memang tidak ada.

Solusi: Menggunakan Tailwind CSS v3

Cara termudah agar perintah npx tailwindcss init bisa berjalan normal seperti sedia kala adalah dengan menggunakan Tailwind versi 3, yang di dalamnya masih menyertakan CLI bawaan.

Berikut adalah langkah-langkah penyelesaiannya:

Langkah 1: Bersihkan Folder Project

Hapus folder node_modules dan file package-lock.json yang lama untuk menghindari konflik versi. Jalankan perintah ini di terminal Windows Anda:

rd /s /q node_modules
del package-lock.json

Langkah 2: Install Tailwind CSS v3 beserta CLI

Instal kembali Tailwind versi 3 dengan menentukan versinya (@3), lengkap dengan postcss dan autoprefixer:

npm install -D tailwindcss@3 postcss autoprefixer

Langkah 3: Jalankan Inisialisasi

Sekarang, Anda sudah bisa membuat file konfigurasi Tailwind dengan lancar:

npx tailwindcss init

Setelah langkah ini selesai, file tailwind.config.js akan otomatis muncul di direktori utama project Anda dan Tailwind CLI siap digunakan.

Catatan Tambahan:
Menggunakan Tailwind v3 adalah pilihan terbaik jika Anda ingin pengelolaan package tetap ditangani sepenuhnya oleh npm tanpa repot mengunduh CLI binary eksternal secara manual.

Jika di kemudian hari Anda ingin beralih ke Tailwind v4+, Anda harus menginstal standalone CLI secara manual atau mengonfigurasinya lewat build tool seperti Vite, PostCSS, atau Webpack.