Installation

AdminLTE 4 for Laravel installs as a Composer package and uses a Vite-first asset pipeline (no precompiled CSS/JS shipped in your app).

Requirements

1. Require the package

composer require colorlibhq/adminlte-laravel

2. Run the installer

php artisan adminlte:install

This will:

• Publish config/adminlte.php.
• Drop the Vite entry stubs into resources/css/adminlte.css and resources/js/adminlte.js.
• Offer to npm install the frontend dependencies, pinned to the major versions the package is tested against: admin-lte@^4.8, bootstrap@^5.3, @popperjs/core@^2.11, overlayscrollbars@^2.16, bootstrap-icons@^1.13, apexcharts@^6.8, jsvectormap@^1.7, fullcalendar@^6.1, sortablejs@^1.15, sass@^1.102.
• Copy the plugin vendor files (ApexCharts, jsVectorMap, FullCalendar, SortableJS, plus the AdminLTE RTL stylesheet) into public/vendor/.

The optional plugins (Flatpickr, Tom Select, Tabulator, Quill) are disabled by default and not installed. Adding one takes two commands — install it, then re-run the asset step so its files are copied into public/vendor/:

npm install -D flatpickr@^4.6 tom-select@^2.6 tabulator-tables@^6.5 quill@^2.0
php artisan adminlte:install --only=assets

Without the second command the plugin's <script> tag 404s and the component that uses it silently does nothing. php artisan adminlte:status shows which optional plugins are in place. See plugins.md for details.

See commands.md for all installer options (--only=config|views|assets|lang, --force, --no-interaction-deps).

3. Wire Vite

Add the two entry files to your vite.config.js:

import { defineConfig } from 'vite'
import laravel from 'laravel-vite-plugin'

export default defineConfig({
    plugins: [
        laravel({
            input: [
                'resources/css/adminlte.css',
                'resources/js/adminlte.js',
            ],
            refresh: true,
        }),
    ],
})

4. Build assets

npm run dev      # development (HMR)
# or
npm run build    # production

5. Create your first page

{{-- resources/views/dashboard.blade.php --}}
@extends('adminlte::page')

@section('title', 'Dashboard')

@section('content_header')
    <h3 class="mb-0">Dashboard</h3>
@stop

@section('content')
    <x-adminlte-info-box title="Orders" text="150" icon="bi bi-bag" theme="primary" />
@stop

// routes/web.php
Route::view('/', 'dashboard')->middleware('auth');

6. Verify

php artisan adminlte:status

Reports which resources are installed (config, stubs, published views, npm packages, plugin vendor files, scaffolded sections).

Next steps

• Configuration reference
• Sidebar menu
• Blade components
• Scaffolding application sections
• Authentication