# [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 The first stable release of the v4 line — a ground-up rewrite on Bootstrap 5.3 with no jQuery. Highlights: **18 new demo pages** - Apps: Calendar (FullCalendar), Kanban (SortableJS), Chat, File Manager, Projects, Mailbox (Inbox / Read / Compose) - Forms: Wizard (4-step with validation) - Tables: Data Tables (Tabulator — jQuery-free) - Pages: Profile, Settings, Invoice, Pricing, FAQ - Errors: 404, 500, Maintenance **Documentation overhaul** - New pages: Getting Started, Customization & Theming, RTL Support, Migration from v3, Layout Blueprint, Recipes, Deployment & Performance, Recommended Integrations, JavaScript Plugins Overview - Rewritten Introduction with four labelled install paths (CDN / npm / source / Composer) - FAQ rebuilt as a custom page with hero, live search, section chips, and an accordion of 19 questions across six topics - Split sidebar navigation: dashboard demo and docs each have their own nav, no more docs entries cluttering the live preview - Reading-friendly typography across all docs pages, with constrained line length, prose-tuned heading rhythm, styled reference tables, info callouts, and pill inline code **Six issue fixes** - `bi-circle-half` for the Auto color-mode icon (#6028) - `table-head-fixed` respects dark mode (#6026) - Fullscreen icon toggles `.d-none` instead of inline `display` so it works with any icon library (#6021) - Sidebar (including brand) stays pinned when using `fixed-header` (#6020) - Pie chart on `index2.html` no longer flickers on browser zoom (#6019) - Color-mode toggle now visible by default in the topbar with localStorage persistence (#6010) **Major dependency upgrades** - ESLint 9 → 10, TypeScript 5.9 → 6, Stylelint 16 → 17 - Astro 6.0 → 6.3, autoprefixer / postcss / rollup / sass / terser refreshed - Bootstrap 5.3.8, Node 22 LTS in CI - Dropped dead `eslint-plugin-import`, `eslint-config-xo*`, and the legacy `.eslintrc.json` - npm `overrides` for `yaml` + `stylelint-config-twbs-bootstrap` so `npm install` runs without `--legacy-peer-deps` and reports **0 vulnerabilities** **Breaking changes from v3** - Class renames: `.wrapper` → `.app-wrapper`, `.main-header` → `.app-header`, `.main-sidebar` → `.app-sidebar`, `.content-wrapper` → `.app-main` - Data attributes: `data-toggle` → `data-bs-toggle`, `data-widget="pushmenu"` → `data-lte-toggle="sidebar"`, `data-widget="treeview"` → `data-lte-toggle="treeview"` - Dark mode: `.dark-mode` body class → `data-bs-theme="dark"` attribute (Bootstrap 5.3 native) - jQuery no longer required; plugins are vanilla TypeScript See the dedicated [Migration from v3](https://adminlte.io/themes/v4/docs/migration.html) guide and the [CHANGELOG.md](CHANGELOG.md) for the full list. **Install:** ```bash npm install admin-lte@4.0.0 ``` ## 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/)