AdminLTE 4.0.2 — a housekeeping patch: building from source is clean again.

📖 Documentation · 🎨 Live preview · 🚀 Migration from v3

🐛 Fixes

• npm run production works from a source checkout again — the dev-only social preview script (scripts/social-preview.mjs, new in 4.0.1) tripped 9 ESLint errors during the lint stage and failed the build. The script is now fully lint-clean. (#6048, reported by @lfiorini)

🔒 Security

• Hardened the social preview script's tiny static file server against path traversal and error detail leakage (CodeQL alerts #87–#92). This script is dev-only and has never been part of the npm package — published builds were never affected.

📦 New here? The AdminLTE family

AdminLTE 4 is also available as official framework integrations: adminlte-vue (Vue 3 & Nuxt), adminlte-react (React & Next.js), adminlte-django, and adminlte-laravel.

Install

npm install admin-lte@4.0.2

Or via CDN:

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

See CHANGELOG.md for the full notes.

Full Changelog: v4.0.1...v4.0.2

Full Changelog: v4.0.1...v4.0.2

AdminLTE 4.0.1 — first patch for the v4 line, and the launch of the AdminLTE family.

📖 Documentation · 🎨 Live preview · 🚀 Migration from v3

🎉 AdminLTE is now a family

The classic HTML/CSS/JS template you know is no longer alone. AdminLTE 4 is now available as four official framework integrations, each a first-class package maintained under ColorlibHQ:

All four build on the same Bootstrap 5.3 + vanilla JS core as this package, so designs and docs carry over. If you build admin panels in any of these ecosystems, give them a ⭐ and tell us what you'd like to see next.

🐛 Fixes

• No more dark-mode flash — the stored color mode is now applied before first paint, so reloading a page in dark mode no longer flashes light first. (#6043, reported by @bsshreesha)
• Mailbox text overflow — long subject and preview text in the inbox list is now truncated instead of breaking the layout. (#6044, reported by @Oscurlo)
• Accessibility landmark fix — accessibility.js no longer assigns role="navigation" to <ul>/<ol> elements, which broke list semantics and failed the Lighthouse accessibility audit. (#6038, reported by @lfiorini)

🧰 Maintenance

• All dependencies updated to latest; axios pinned via npm overrides to clear a transitive advisory — local npm audit reports 0 vulnerabilities.
• New dev-only social preview generator (scripts/social-preview.mjs), excluded from the npm package.

Install

npm install admin-lte@4.0.1

Or via CDN:

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

See CHANGELOG.md for the full notes.

Full Changelog: v4.0.0...v4.0.1

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

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.

AdminLTE v4.0.0-rc7 Release Notes

Highlights

This release delivers significant JavaScript refactors to the layout and push menu plugins, fixes several bugs affecting print, pagination, modals, and animations, and updates all dependencies to their latest semver-compatible versions.

Bug Fixes

• Print layout: Sidebar and main content are now both visible in browser print preview (#5982, PR #5996 by @herley-shaori)
• Pagination border-radius: Synced _bootstrap-variables.scss calc syntax with Bootstrap 5.3, fixing grouped pagination buttons showing rounded corners on all sides (#5951, reported by @Kneemund)
• Escape key & modals: handleEscapeKey() no longer bypasses Bootstrap 5's keyboard: false option on modals (#5993, reported by @braytac)
• slideDown/slideUp animation: Fixed unreliable setTimeout ordering when duration is 0, which caused sidebar treeview instant-open to fail (#5964, PR by @Kneemund)
• CSS lint: Fixed property order in print layout rules (#5997, reported by @lfiorini)

Refactors

• Layout transition handling (#5956 by @dfsmania):

  • Fixed broken holdTransition timer (local variable promoted to instance property)
  • Removed duplicate resize event listeners registered on every call
  • Consolidated layout initialization to layout.ts (removed duplication from adminlte.ts)
  • Moved app-loaded class application to layout Data API section

• Push menu plugin overhaul (#5954 by @dfsmania):

  • Single PushMenu instance instead of creating new instances per event handler
  • Proper separation of setupSidebarBreakPoint() and updateStateByResponsiveLogic()
  • sidebar-open class only added on mobile viewports (aligns with v3 behavior)
  • Configuration now readable from data attributes on sidebar element
  • Removed unused menusClose() method and dead constants

Improvements

• Login/register box width: Increased from 360px to 400px for better form readability (#5963 by @dfsmania)
• TypeScript compilation: Added removeComments: true to tsconfig.json, reducing unminified adminlte.js by ~15% (#5953 by @dfsmania)

Dependencies

Updated all packages to latest semver-compatible versions:

• @astrojs/check 0.9.7, @astrojs/mdx 4.3.13
• @typescript-eslint/* 8.57.0
• astro 5.18.0, autoprefixer 10.4.27
• eslint 9.39.4, eslint-plugin-astro 1.6.0
• fs-extra 11.3.4, nodemon 3.1.14
• postcss 8.5.8, prettier 3.8.1
• rimraf 6.1.3, rollup 4.59.0
• sass 1.97.3, terser 5.46.0

Breaking Changes

• Sidebar persistence is now opt-in: enablePersistence defaults to false (was true). To restore the previous behavior where sidebar state is remembered across page loads, add data-enable-persistence="true" to your sidebar element:

  <aside class="app-sidebar" data-enable-persistence="true"></aside>

Contributors

Thank you to everyone who contributed to this release:

• @dfsmania (Diego Smania) — layout refactor, push menu refactor, login box width, tsconfig cleanup
• @herley-shaori (Herley) — print layout fix
• @Kneemund (Moritz Mechelk) — pagination bug report, slideDown/slideUp fix
• @braytac — escape key modal bug report
• @lfiorini — CSS lint issue report

What's New

• Updated Dependencies: 8 npm packages updated to latest versions for improved security
  and performance
• Refined Mobile Image Fix: Streamlined image path resolution by removing JavaScript
  runtime fix in favor of build-time HTML generation
• Better Performance: Images now load faster with no runtime path corrections needed

Updated Packages

• @rollup/plugin-typescript: 12.1.3 → 12.1.4
• @typescript-eslint/eslint-plugin: 8.35.1 → 8.36.0
• @typescript-eslint/parser: 8.35.1 → 8.36.0
• astro: 5.10.0 → 5.11.0
• eslint: 9.30.0 → 9.30.1
• prettier: 3.5.3 → 3.6.2
• rollup: 4.44.0 → 4.44.2
• stylelint: 16.21.0 → 16.21.1

Installation

npm install admin-lte@4.0.0-rc4

Key Improvements from 4.0.0-rc3

• Zero 404 Errors: All images now use relative paths generated at build time
• Cleaner Code: Removed JavaScript runtime path fixes that caused console errors
• Latest Tools: Updated to newest versions of TypeScript, ESLint, Prettier, and build tools

AdminLTE v4.0.0-rc1 - Major Modernization Release

This release represents a complete modernization of the AdminLTE codebase, bringing it up to current standards with the latest tooling, dependencies, and best practices.

Key Highlights

• Zero Security Vulnerabilities - All dependencies updated and vulnerabilities resolved
• Modern Tooling - ESLint v9, Astro 5.x, latest Stylelint and build tools
• Better Developer Experience - New npm start command, improved scripts, cleaner builds
• Latest Dependencies - Bootstrap 5.3.7, Node.js ES modules, 50+ package updates
• Code Quality - Zero linting errors, removed technical debt, standardized formatting
• Future-Ready - Modern configuration patterns, optimal bundle sizes, enhanced maintainability

Quick Start

# Install dependencies
npm install

# Start development server
npm start

# Build for production  
npm run production

Major Changes

Infrastructure & Tooling

• Upgraded to ES Modules with "type": "module" in package.json
• Complete ESLint v9 migration with modern flat configuration format
• Enhanced Astro configuration with static site generation
• Optimized build scripts and developer experience

Dependencies Updated

• astro: 4.15.12 → 5.10.0
• eslint: 8.57.1 → 9.29.0
• bootstrap: 5.3.3 → 5.3.7
• sass: 1.78.0 → 1.89.2
• typescript: 5.6.2 → 5.8.3
• Plus 50+ other packages updated to latest versions

Security & Quality

• Resolved all npm security vulnerabilities (0 remaining)
• Updated browserslist database for modern browser compatibility
• Fixed all SASS deprecation warnings
• Zero linting errors across all file types

Migration Guide

For Users:

• No breaking changes in compiled CSS/JS output
• All existing HTML templates remain fully compatible
• CDN links and package imports work as before

For Developers:

• New npm start command for development
• ESLint configuration migrated to eslint.config.js
• Build process requires Node.js ES modules support

Compatibility

• Bootstrap: 5.3.7 (latest)
• Node.js: ES modules support required
• Browsers: All modern browsers supported
• RTL: Full right-to-left language support maintained

See CHANGELOG.md for complete technical details.

Download: Use npm: npm install admin-lte@4.0.0-rc1 or download the source code below.

Release Notes

New Features

• Established distribution build folder dist.

Dependency Changes

• Replaced js-beautify with prettier for code formatting.
• Downgraded sass to a compatible version.

Upgrades

• Upgraded astro to version 5.
• Updated bootstrap to version 5.3.3.

Thank you sponsors

@spizzo14
@tomhappyblock
@stefanmorderca
@tito10047
@sitchi
@npreee
@isaacmorais

Full Changelog: v4.0.0-beta2...v4.0.0-beta3

BREAKING CHANGES

• Removed .layout-fixed-complete class and component.

What's Changed

• Update push-menu.ts by @burdittw in #5583
• Added Icons in UI by @Developermayank in #5652

Minor

• Bug Fixes

New Feature

• Added Theme Customizer

Thank you sponsors

@spizzo14
@tomhappyblock
@stefanmorderca
@tito10047
@sitchi
@npreee

New Contributors

• @Developermayank made their first contribution in #5652

Full Changelog: v4.0.0-beta1...v4.0.0-beta2

Highlights

• AdminLTE v4 is now based on Bootstrap 5
• Dark mode
• RTL support
• Improved responsiveness, performance, code quality, customization, plugins, components, layouts, widgets, forms, tables, icons, pages, examples, and starter kit

Thank you sponsors

@spizzo14
@stefanmorderca
@tomhappyblock
@tito10047
@sitchi

Thank you Contributors

• AdminLTE v4 maintainers: @REJack @puikinsh @danny007in
• fix TreeView multi level sample code by @ZhangChengLin in #3698
• fix capitalization for overlayscrollbars by @tacman in #3891
• Fix gulp readme typo by @MGatner in #4133
• Change side menu chevrons pointing side by @ArthurHetem in #4360
• Issue 5011- Add checks for if sidebar exists to stop errors on pages with no sidebar by @burdittw in #5015
• Improved path conversion to allow any number of subpaths by @claudiopatricio in #5095
• Fullscreen button by @glewe in #5307
• Bs5 Components by @glewe in #5312
• Local Google Fonts by @glewe in #5313
• Fix typo in README.md by @luzpaz in #5471
• Fix typo in comment by @CoolCu in #5556

Welcome New Contributors

• @tacman made their first contribution in #3891
• @MGatner made their first contribution in #4133
• @ArthurHetem made their first contribution in #4360
• @burdittw made their first contribution in #5015
• @claudiopatricio made their first contribution in #5095
• @glewe made their first contribution in #5307
• @luzpaz made their first contribution in #5471
• @CoolCu made their first contribution in #5556

Full Changelog: v3.2.0...v4.0.0-beta1

Breaking Change!
We dropped official node v12, it might be still work but we won't give support for any node 12 bugs/errors.

Top-Features:

• Enhanced Dark Mode
• SVG Font Awesome Icon support
• Docker dev-preset
• Reworked Dark/Light colors
• Custom Scrollbar style (Non-Plugin-Scrollbar)

Fixes:

• various fixes in IFrame plugin
• fix link encoding in SidebarSearch plugin
• fix division warning while sass building
• fix disabled state for default & outline-light button
• fix none-visible background colors while printing
• various dark-mode fixes

Changes:

• add load error fallback for CardRefresh plugin
• add collapsed-done event for ControlSidebar plugin & PushMenu plugin
• add animationSpeed to ControlSidebar plugin & PushMenu plugin
• add target selection for ControlSidebar plugin
• add element fallback for ExpandableTable plugin
• add allowReload & autoDarkMode to IFrame plugin
• add iframe-dark example

Thanks for your awesome contribution @liljack, @danny007in, @curiousteam, @equada, @Shidersz, @gurvirlochab, @ZhangChengLin, @mostafahesham-dev, @smtbos, @leonardxfce, @anilloutombam, @13324, @SmileYzn, @hkvstore, @rikuson, @kreic51, @forxer & @mahmoudalsaman.

For the complete changelog look here.