github ColorlibHQ/AdminLTE v4.0.0

8 hours ago

AdminLTE 4.0.0 — first stable release of the v4 line. A ground-up rewrite on Bootstrap 5.3 with no jQuery.

📖 Documentation · 🚀 Migration from v3 · 🎨 Live preview


Highlights

  • 18 new demo pages — Calendar (FullCalendar), Kanban (SortableJS), Chat, File Manager, Projects, Mailbox (Inbox/Read/Compose), Form Wizard, Data Tables (Tabulator), Profile, Settings, Invoice, Pricing, FAQ, plus 404 / 500 / Maintenance error pages.
  • Documentation overhaul — Getting Started, Customization, RTL, Migration from v3, Layout Blueprint, Recipes, Deployment, Recommended Integrations, JavaScript Plugins Overview. Split sidebar navigation so the live preview no longer feels like a docs site. Reading-friendly typography with consistent card wrappers across every page.
  • FAQ rebuilt as a custom page with a hero, live search, section chips, and an accordion of 19 questions across six topics.
  • Six issue fixes: #6010, #6019, #6020, #6021, #6026, #6028.
  • Visible color-mode toggle in the default topbar, with localStorage persistence and prefers-color-scheme integration.
  • Major dependency upgrades: ESLint 9 → 10, TypeScript 5.9 → 6, Stylelint 16 → 17, Astro 6.0 → 6.3, and refreshed minor versions across autoprefixer / postcss / rollup / sass / terser.
  • Dependency tree cleanup: dropped eslint-plugin-import, eslint-config-xo*, and the legacy .eslintrc.json. Flat config only.
  • Security: npm overrides for yaml and stylelint-config-twbs-bootstrap mean npm install runs without --legacy-peer-deps and reports 0 vulnerabilities.

Breaking changes from v3

v3 v4
.wrapper .app-wrapper
.main-header .app-header
.main-sidebar .app-sidebar
.content-wrapper .app-main
data-toggle data-bs-toggle (Bootstrap 5)
data-widget="pushmenu" data-lte-toggle="sidebar"
data-widget="treeview" data-lte-toggle="treeview"
.dark-mode body class data-bs-theme="dark" attribute
jQuery required Vanilla TypeScript — no jQuery
enablePersistence defaulted on Defaults off; opt in via data-enable-persistence="true"

See the dedicated Migration from v3 guide for the complete list and step-by-step upgrade order.

Install

npm install admin-lte@4.0.0

Or via CDN:

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/admin-lte@4.0.0/dist/css/adminlte.min.css" />
<script src="https://cdn.jsdelivr.net/npm/admin-lte@4.0.0/dist/js/adminlte.min.js"></script>

See CHANGELOG.md for the full notes.

Don't miss a new AdminLTE release

NewReleases is sending notifications on new releases.