AdminLTE v4.0.0-rc7

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

AdminLTE v4.0.0-rc4

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 [email protected]

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

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 [email protected] or download the source code below.

v4.0.0-beta3

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

v4.0.0-beta2

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

v4.0.0-beta1

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

AdminLTE v3.2.0

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.

v3.2.0-rc

update docs

AdminLTE 3.1.0

Breaking Change!
Changed SCSS filename case

• build/scss/AdminLTE-raw.scss → build/scss/_adminlte.raw.scss
• build/scss/AdminLTE.scss → build/scss/adminlte.scss
• build/scss/AdminLTE-components.scss → build/scss/parts/adminlte.components.scss
• build/scss/AdminLTE-core.scss → build/scss/parts/adminlte.core.scss
• build/scss/AdminLTE-extra-components.scss → build/scss/parts/adminlte.extra-components.scss
• build/scss/AdminLTE-pages.scss → build/scss/parts/adminlte.pages.scss
• build/scss/AdminLTE-plugins.scss → build/scss/parts/adminlte.plugins.scss

New in v3.1:

• Dark Mode
• New Components
  • Month Pagination
  • Login/Register v2
  • IFrame mode
  • uPlot Charts
  • Kanban Board
  • Pages
    • FAQ
    • Contact Us
  • Search
    • Simple
    • Enhanced
  • Simple Kanban Board
  • Simple Preloader
• New Demo Examples
  • Stepper/Wizard
  • Multi File Upload
  • Codemirror
  • Datatables with Buttons
  • Form Input Styles
• New Sidebar features
  • Sidebar Search
  • Custom Area
• New JS Plugins & JS Plugin features
  • Fullscreen mode
  • SidebarSearch plugin
  • ExpandableTables plugin
  • IFrame plugin
  • NavbarSearch plugin
• Additionally
  • added FontAwesome light, duotone & svg support
  • added Datatables Scrollpane Plugin
  • added btn-app Color Variations
  • enhance brand-link with pushmenu inside brand
  • added new Border Bottom only input style
  • added custom-control-input Color Variations
  • added custom-control-input-outline for checkbox & radio
  • enhanced ControlSidebar plugin for multiple control-sidebars

Changes:

• replaced small-box font-size transition with transform
• fixed layout-boxed sidebar with sidebar-mini
• added ASP.NET Boilerplate & CakePHP 4.x implementation in docs
• compressed images (jpg & png)
• added StyleLint, ESLint & BundleWatch
• enhanced various npm script commands
• updated bootstrap to 4.6.0
• removed glyphicon leftovers
• updated various HTML markups
  • specified lang attribute
  • bumped year to 2021
  • changed http:// to https://
  • moved rel attribute for consistency
  • added rel=noopener for external links
  • specified diplay=fallback for Google Fonts
• added sidebar search plugin
• added pagination month component
• added expandable tables plugin
• added sidebar custom area component
• enhanced brand-link with pushmenu inside brand
• added font awesome light, duotone & svg icons support
• fixed maximized-card card-body overflow
• added bs-stepper plugin & demo
• added codemirror plugin & demo
• added dropzonejs plugin & demo
• added sparkline demo
• remove flot-old
• remove unnecessary jquery-ui
• added new login, register & recover-password v2 page
• added datatables button example
• added contact-us and faq demo
• added iframe plugin
• added three new styles examples in forms/general
• added custom-control-input color variations
• added custom-control-input-outline for checkbox & radio
• added dark-mode
• added simple kanban board
• added card image overlay example
• added datatables searchpanes plugin
• added uplot chart plugin & demo
• removed devDependencies
  • @babel/cli
  • @babel/plugin-external-helpers
  • css-loader
  • path
  • set-value
  • style-loader
• removed dependencies
  • @fullcalendar/bootstrap (replaced with new dependency fullcalendar)
  • @fullcalendar/core (replaced with new dependency fullcalendar)
  • @fullcalendar/daygrid (replaced with new dependency fullcalendar)
  • @fullcalendar/interaction (replaced with new dependency fullcalendar)
  • @fullcalendar/timegrid (replaced with new dependency fullcalendar)
• and some other small fixes/changes

Thanks to @XhmikosR for the 55+ incredible PR's also Thanks for the PR's to @shawnheide, @mineminemine, @shailesh-ladumor, @SmileYzn, @yangfuhai, @nisarhassan12, @danny007in

For the complete changelog look here.

AdminLTE 3.1.0 Release Candidate

This is only short description, the complete will come in the full release.

Breaking Change!
Changed SCSS filename case

• build/scss/AdminLTE-raw.scss → build/scss/_adminlte.raw.scss
• build/scss/AdminLTE.scss → build/scss/adminlte.scss
• build/scss/AdminLTE-components.scss → build/scss/parts/adminlte.components.scss
• build/scss/AdminLTE-core.scss → build/scss/parts/adminlte.core.scss
• build/scss/AdminLTE-extra-components.scss → build/scss/parts/adminlte.extra-components.scss
• build/scss/AdminLTE-pages.scss → build/scss/parts/adminlte.pages.scss
• build/scss/AdminLTE-plugins.scss → build/scss/parts/adminlte.plugins.scss

New in v3.1:

• Dark Mode
• New Components
  • Month Pagination
  • Login/Register v2
  • IFrame mode
  • uPlot Charts
  • Kanban Board
  • Pages
    • FAQ
    • Contact Us
  • Search
    • Simple
    • Enhanced
  • Simple Kanban Board
• New Demo Examples
  • Stepper/Wizard
  • Multi File Upload
  • Codemirror
  • Datatables with Buttons
  • Form Input Styles
• New Sidebar features
  • Sidebar Search
  • Custom Area
• New JS Plugins & JS Plugin features
  • Fullscreen mode
  • SidebarSearch plugin
  • ExpandableTables plugin
  • IFrame plugin
• Additionally
  • added FontAwesome light, duotone & svg support
  • added Datatables Scrollpane Plugin
  • added btn-app Color Variations
  • enhance brand-link with pushmenu inside brand
  • added new Border Bottom only input style
  • added custom-control-input Color Variations
  • added custom-control-input-outline for checkbox & radio

For the complete changelog look here.