# [AdminLTE - Bootstrap 5 Admin Dashboard](https://adminlte.io) [![npm version](https://img.shields.io/npm/v/admin-lte/latest.svg)](https://www.npmjs.com/package/admin-lte) [![Packagist](https://img.shields.io/packagist/v/almasaeed2010/adminlte.svg)](https://packagist.org/packages/almasaeed2010/adminlte) [![cdn version](https://data.jsdelivr.com/v1/package/npm/admin-lte/badge)](https://www.jsdelivr.com/package/npm/admin-lte) [![Discord Invite](https://img.shields.io/badge/discord-join%20now-green)](https://discord.gg/jfdvjwFqfz) [![Netlify Status](https://api.netlify.com/api/v1/badges/1277b36b-08f3-43fa-826a-4b4d24614b3c/deploy-status)](https://app.netlify.com/sites/adminlte-v4/deploys) **AdminLTE** is a fully responsive administration template. Based on **[Bootstrap 5](https://getbootstrap.com/)** framework and also the JavaScript plugins. Highly customizable and easy to use. Fits many screen resolutions from small mobile devices to large desktops. ## What's New in v4.0.0-rc7 **Bug Fixes, Refactors & Documentation** - Major plugin refactors, complete JS documentation, and new features: - **Layout & PushMenu Refactors** - Single-instance architecture, proper responsive logic, configurable via data attributes - **Sidebar Without Hover** - New `sidebar-without-hover` class to keep collapsed sidebar from expanding on hover - **Complete JS Documentation** - All 7 JavaScript components now fully documented - **Astro 6.0.0** - Upgraded to latest Astro with Vite 7 and Shiki 4 - **Bug Fixes** - Fixed footer with layout-fixed, mobile scroll chaining, print layout, modal escape key, pagination borders **Key Improvements:** - Fixed footer now works correctly with `layout-fixed` (#5805) - Sidebar no longer causes page scroll chaining on mobile (#5864) - Print layout shows both sidebar and content (#5996) - Sidebar persistence is now opt-in via `data-enable-persistence="true"` (**breaking change**) - All dependencies updated to latest versions **Install the latest:** ```bash npm install admin-lte@4.0.0-rc7 ``` See the [CHANGELOG.md](CHANGELOG.md) for complete details. ## Looking for Premium Templates? AdminLTE.io just opened a new premium templates page. Hand picked to ensure the best quality and the most affordable prices. Visit for more information. !["AdminLTE Presentation"](https://adminlte.io/AdminLTE3.png "AdminLTE Presentation") **AdminLTE** has been carefully coded with clear comments in all of its JS, SCSS and HTML files. SCSS has been used to increase code customizability. ## Quick start ### Development To start developing with AdminLTE: 1. **Install dependencies:** `npm install` 2. **Start development server:** `npm start` *(opens browser at http://localhost:3000)* 3. **Start coding!** Files auto-compile and refresh on changes ### Production Build To build for production: 1. **Full production build:** `npm run production` *(includes linting and optimization)* 2. **Quick build:** `npm run build` *(faster for development/testing)* ### Available Scripts - `npm start` - Start development server with file watching - `npm run build` - Build all assets for development - `npm run production` - Full production build with linting and bundlewatch - `npm run lint` - Run all linters (JS, CSS, docs, lockfile) - `npm run css` - Build CSS only - `npm run js` - Build JavaScript only ## Browser Support AdminLTE supports all modern browsers with the latest Bootstrap 5.3.8: - Chrome (latest) - Firefox (latest) - Safari (latest) - Edge (latest) ## Platform Support AdminLTE v4 build scripts work cross-platform: - **Windows** - Command Prompt, PowerShell, Git Bash - **macOS** - Terminal, iTerm2 - **Linux** - Bash, Zsh, and other Unix shells All npm scripts use cross-platform utilities to ensure consistent behavior across different operating systems. ## Security & Production Deployment ### Important Security Notice AdminLTE is a **UI template** - when deploying to production, follow these critical guidelines: **What to Deploy:** - Only compiled production assets: `dist/js/adminlte.min.js` and `dist/css/adminlte.min.css` - Your application-specific files **What NOT to Deploy:** - `node_modules/` directory - Demo/example HTML files (index.html, index2.html, index3.html, etc.) - Source files (`src/` directory) - Development configuration files **CVE-2021-36471 Notice:** This CVE is **disputed** and does not represent a vulnerability in AdminLTE. It refers to demo pages being accessible when developers incorrectly deploy example files to production. AdminLTE v4 has a clear separation between development demos and production assets. See [SECURITY.md](SECURITY.md) for complete details. **Production Build:** ```bash npm run production # Builds optimized assets in dist/ ``` For detailed security guidelines, authentication requirements, and best practices, see [SECURITY.md](SECURITY.md). ## Sponsorship Support AdminLTE development by becoming a sponsor or donor.

Sponsor on GitHub    Donate via PayPal

## Our Sponsors

User avatar: spizzo14   User avatar: tomhappyblock   User avatar: stefanmorderca   User avatar: tito10047   User avatar: sitchi   User avatar: npreee   User avatar: isaacmorais  

Your avatar here? Become a sponsor

## Contributing - Highly welcome. - For your extra reference check [AdminLTE v4 Contribution Guide](https://github.com/ColorlibHQ/AdminLTE#contributing) - First thing first, you should have bit knowledge about NodeJS. - Github Knowledge. - Install NodeJS LTS version. - Clone this Repository to your machine and change to `master` branch. - Go to Cloned Folder. - In cli/bash run `npm install` it will install dependency from `package.json`. - After installation completes, run `npm start` - Cool, Send your changes in PR to `master` branch. ## License AdminLTE is an open source project by [AdminLTE.io](https://adminlte.io) that is licensed under [MIT](https://opensource.org/licenses/MIT). AdminLTE.io reserves the right to change the license of future releases. ## Image Credits - [Pixeden](http://www.pixeden.com/psd-web-elements/flat-responsive-showcase-psd) - [Graphicsfuel](https://www.graphicsfuel.com/2013/02/13-high-resolution-blur-backgrounds/) - [Pickaface](https://pickaface.net/) - [Unsplash](https://unsplash.com/) - [Uifaces](http://uifaces.com/) - [Unavatar](https://unavatar.io/)