Source code aplikasi, template web, dan ebook. Unduh dari akun setelah bayar. Lihat produk

Blog / Umum / Laravel dengan Vite: Panduan S...
Umum

Laravel dengan Vite: Panduan Setup Tailwind CSS, Bootstrap, dan Asset Frontend

AD

Admin HijrahKreativa

Penulis

19 Oct 2026
4 min read
23 views

Overview

Laravel menggunakan Vite untuk mengelola asset frontend pada banyak skeleton aplikasi modern. Konfigurasi yang keliru dapat menyebabkan CSS tidak tampil, JavaScript gagal dimuat, atau halaman production mencari manifest yang belum dibuat. Artikel ini menjelaskan cara memeriksa konfigurasi Vite dan memilih Tailwind CSS atau Bootstrap untuk antarmuka aplikasi.

Tailwind dan Bootstrap sama-sama dapat digunakan, tetapi memiliki pendekatan styling yang berbeda. Untuk kebanyakan proyek, pilih satu framework utama agar ukuran asset dan pola UI lebih konsisten. Memasang keduanya sekaligus sebaiknya dilakukan hanya jika ada alasan teknis yang jelas.

Prerequisites

  • Proyek Laravel yang menggunakan Vite.
  • Node.js versi LTS yang kompatibel dengan dependency proyek.
  • NPM.
  • PHP dan Composer sesuai requirement Laravel.
  • Pemahaman dasar HTML, CSS, dan JavaScript.

Periksa versi tool:

node -v
npm -v

Step-by-step tutorial

1. Periksa konfigurasi Vite dan package

Lihat package.json dan file vite.config.js atau vite.config.ts yang tersedia. Skeleton Laravel umumnya menyediakan script dev dan build, tetapi dependency dapat berubah menurut versi dan starter kit.

npm install
npm run dev

Biarkan Vite tetap berjalan selama development. Periksa output terminal untuk mengetahui alamat development server dan pesan error.

2. Periksa entry point asset

Entry point pada banyak proyek adalah resources/css/app.css dan resources/js/app.js. Pastikan file tersebut benar-benar ada dan terdaftar pada konfigurasi Vite.

Contoh layout Blade:

<!doctype html>
<html lang="id">
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    @vite(['resources/css/app.css', 'resources/js/app.js'])
</head>
<body>
    <main class="container">
        <h1>Dashboard</h1>
    </main>
</body>
</html>

3. Pilih Tailwind CSS

Cara setup Tailwind bergantung pada major version. Tailwind CSS 4 memiliki pendekatan konfigurasi yang berbeda dari Tailwind 3. Periksa versi package terlebih dahulu:

npm ls tailwindcss

Jika proyek menggunakan Tailwind 4, ikuti panduan resmi Tailwind 4 untuk integrasi Vite. Jangan mencampur instruksi Tailwind 3—misalnya konfigurasi content dan directive lama—dengan setup Tailwind 4 tanpa memahami perbedaannya.

4. Pilih Bootstrap

Untuk menambahkan Bootstrap melalui NPM:

npm install bootstrap

Import stylesheet dan JavaScript yang dibutuhkan pada entry point, misalnya resources/js/app.js:

import 'bootstrap/dist/css/bootstrap.min.css';
import 'bootstrap';

Jika proyek menggunakan file CSS terpisah, atur import mengikuti struktur proyek dan hindari memuat asset yang sama berulang kali.

5. Bangun asset production

npm run build

Vite menghasilkan file build dan manifest yang digunakan Laravel untuk merujuk asset. Dalam deployment, asset dapat dibangun di CI atau lingkungan build, kemudian artefaknya dikirim ke server. Pastikan manifest dan file hasil build tersedia di lokasi yang dikonfigurasi.

6. Verifikasi hasil di browser

Pastikan CSS dan JavaScript tampil ketika npm run dev berjalan. Periksa console browser, tab Network, dan terminal Vite. Setelah npm run build, uji halaman menggunakan mode production atau staging agar masalah manifest dan path asset diketahui sebelum deployment.

Troubleshooting

  • Vite manifest not found: jalankan npm run build atau pastikan Vite dev server aktif untuk development.
  • npm install gagal: periksa versi Node.js, lockfile, dan pesan dependency conflict.
  • CSS tidak berubah: periksa entry point, import, class, dan proses Vite.
  • Tailwind class tidak menghasilkan style: cocokkan konfigurasi dengan major version Tailwind dan pastikan file template terdeteksi.
  • Bootstrap JavaScript tidak bekerja: periksa import JavaScript dan dependency komponen yang digunakan.
  • Asset 404 di production: periksa manifest, base path, URL, dan konfigurasi reverse proxy.

Best practices

Gunakan lockfile dan versi Node.js yang konsisten. Pilih satu framework CSS utama kecuali ada alasan kuat memakai keduanya. Jalankan build production sebelum deploy, minimalkan dependency yang tidak digunakan, dan hindari menjalankan Vite development server sebagai pengganti asset production. Pastikan layout Blade memuat asset melalui mekanisme resmi Laravel/Vite.

Related articles

Last tested

Tanggal penyusunan: 19 Oktober 2026. Workflow NPM merupakan pola umum; instruksi Tailwind spesifik bergantung pada versi package dan belum dieksekusi dalam sesi ini. Periksa package.json, konfigurasi Vite, dan dokumentasi resmi sebelum publikasi.

Bagikan artikel:

Artikel lainnya

Cari Artikel