AdminLTE v4.0.0-rc3

AdminLTE v4.0.0-rc3 - Production Deployment & Cross-Platform Compatibility

This release resolves critical production deployment issues and ensures consistent behavior between development and production environments across different deployment scenarios.

🚀 Production Deployment Fixes

Path Resolution System

• Smart Path Resolution: Implemented intelligent relative path calculation for all assets
  • CSS/JS paths automatically adjust based on page depth (e.g., ./css/ for root, ../css/ for sub-pages)
  • Image paths dynamically corrected at runtime for any deployment structure
  • Works seamlessly for root deployment, sub-folder deployment, and CDN hosting

RTL CSS Processing Fix

• PostCSS Configuration: Fixed rtlcss plugin interference with LTR builds
  • rtlcss now only runs during RTL-specific builds (NODE_ENV=RTL)
  • Prevents automatic left/right property flipping in standard production builds
  • Maintains separate .rtl.css files for right-to-left language support

Image Loading Resolution

• Runtime Image Path Fix: Added intelligent image path correction script
  • Detects deployment context from working CSS/JS paths
  • Automatically converts absolute image paths (/assets/img/...) to relative paths
  • Ensures images load correctly regardless of deployment sub-folder structure

🎨 UI/Navigation Improvements

Sidebar Navigation Fixed

• Badge & Arrow Positioning: Resolved sidebar layout issues
  • Fixed nav badges overlapping text elements
  • Restored chevron arrow indicators for expandable menu items
  • Corrected spacing and visual hierarchy in sidebar navigation
  • Added sidebar-open class to all layouts for consistent styling

Cross-Device Consistency

• Full-Width Navigation Links: Enhanced clickable areas
  • Set .sidebar-menu .nav-link { width: 100%; } for better UX
  • Ensures badges and arrows align properly at the far right edge
  • Maintains proper spacing across all screen sizes and devices

📦 CDN & Dependencies

Updated to Latest Stable Versions

• Bootstrap: v5.3.3 → v5.3.7 (latest stable)
• Bootstrap Icons: v1.11.3 → v1.13.1 (latest with new icons)
• OverlayScrollbars: v2.10.1 → v2.11.0 (performance improvements)
• PopperJS: v2.11.8 (confirmed latest - no change needed)

Integrity Attribute Removal

• SRI-Free CDN Loading: Removed integrity attributes from all CDN resources
  • Prevents "Failed to find a valid digest" console errors
  • Allows CDN providers to update files without breaking existing links
  • Maintains crossorigin="anonymous" for security while removing brittle SRI checks

🛠️ Build System Enhancements

Development vs Production Parity

• Unified Asset Pipeline: Both dev and production now use identical asset resolution
  • Development copies fresh CSS/JS to src/html/public/ for hot-reloading
  • Production builds CSS/JS to dist/css/ and dist/js/ then flattens structure
  • Smart path resolution ensures consistent behavior in both environments

Git Repository Cleanup

• Production Build Distribution: Added complete dist/ folder to repository
  • Provides ready-to-use production files for immediate deployment
  • Simplifies distribution and CDN access via jsDelivr
  • Enables direct download without requiring Node.js build environment

Deployment Guide

Quick Start

# Build for production
npm run production

# Deploy via FTP (upload entire dist/ folder contents)
# Or serve locally for testing
cd dist && python3 -m http.server 8080

Deployment Scenarios

1. Root Deployment: Upload dist/ contents to public_html/ or equivalent
2. Sub-folder Deployment: Upload dist/ contents to public_html/admin/ or similar
3. Static Host Deployment: Point build directory to dist/ in your hosting platform
4. CDN Integration: Upload assets to CDN and update paths as needed

📋 Migration Notes

From 4.0.0-rc2 to 4.0.0-rc3

Automatic Updates (No Action Required):

• Path resolution works automatically in all deployment scenarios
• Image loading is fixed without any HTML changes needed
• Sidebar navigation displays correctly with proper spacing and indicators
• All CDN resources load without console errors

Recommended Actions:

• Remove any manual path fixes you may have implemented
• Update your deployment process to use the new dist/ structure
• Verify image loading in your specific deployment environment
• Test both development (npm run dev) and production builds

Breaking Changes:

• None - this release is fully backward compatible with existing HTML and CSS

---

Download: Use npm: npm install [email protected] or download the source code below.

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.

AdminLTE 3.0.5

Release Notes

• fixed whitespace with fixed navbar & footer
• fixed anchor color on .btn
• added !important to text-(color)
• fixed inline input-group in sidebar on macOS
• added margin-bottom to form-inline in sidebar
• added ribbon over image demo & docs
• and some other small fixes/changes

Thanks to @medardm, @danny007in, @erdkse & @ddiskandar for your PR's.

For the complete changelog look here.