AdminLTE README

The project's README from github.com/ColorlibHQ/AdminLTE. As one markdown file: README.md.

AdminLTE — Bootstrap 5 Admin Dashboard

npm version Packagist cdn version License: MIT Discord Invite Netlify Status

AdminLTE is the most popular open-source admin dashboard template — fully responsive, built on Bootstrap 5.3 with vanilla JavaScript (no jQuery), highly customizable, and easy to use. It fits every screen from small mobile devices to large desktops, and it's MIT-licensed.

Live Demo · Documentation · Framework Editions · Premium Templates

AdminLTE 4 dashboard — light mode AdminLTE 4 dashboard — dark mode

Framework editions

The same AdminLTE 4 dashboard, officially integrated for the framework you know best — you're looking at the HTML / Bootstrap core:

HTML React Next.js Vue Nuxt Angular Laravel Symfony Django ASP.NET Drupal Docs
Edition Repository Live demo Install
HTML / Bootstrap (this repo) AdminLTE themes/v4 npm install admin-lte
React & Next.js — 30+ typed components, RSC-ready, ⌘K palette adminlte-react themes/next-react see repo
Vue 3 & Nuxt — 45+ typed components, composables, SSR-safe theming adminlte-vue themes/vue-nuxt see repo
Laravel — Blade components, config-driven menu, auth scaffolding adminlte-laravel laravel.adminlte.io composer require colorlibhq/adminlte-laravel
Django — reusable app, menu filter pipeline, themed admin adminlte-django django.adminlte.io pip install django-adminlte4
Symfony — Twig Components, AssetMapper, config-driven menu, EasyAdmin theme adminlte-symfony see repo composer require colorlibhq/adminlte-symfony
Angular 22 — 44 standalone signal components, dark mode, ⌘K palette adminlte-angular see repo npm i @adminlte/angular
ASP.NET Core (.NET 10) — Blazor components + MVC/Razor Pages Tag Helpers adminlte-aspnet see repo dotnet add package ColorlibHQ.AdminLTE.AspNetCore
Drupal — admin theme for Drupal 10.3+/11, themed admin UI adminlte-drupal see repo see repo
Docs — guides, components, and API reference for every edition docs.adminlte.io docs.adminlte.io —

Every edition ships the full AdminLTE 4 design — Bootstrap 5.3, dark mode, RTL — with idiomatic integrations for its stack (components, routing, auth, theming).

Quick start

CDN — no build step:

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

npm:

npm install admin-lte@4

Composer:

composer require almasaeed2010/adminlte

Then start from the Getting Started guide or copy one of the demo pages.

Developing AdminLTE itself

  1. Install dependencies: npm install
  2. Start the dev server: npm start (opens http://localhost:3000 with live reload)
  3. Build: npm run build — or npm run production for the full lint + optimize + bundlewatch pipeline
All npm scripts
  • npm 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

What's new in v4

The v4 line is a ground-up rewrite on Bootstrap 5.3 with no jQuery: 18 new demo pages (Calendar, Kanban, Chat, File Manager, Mailbox, Wizard, Tabulator data tables, and more), a documentation overhaul, and major dependency upgrades. See the CHANGELOG for full details.

New in 4.3

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 with hero, live search, section chips, and an accordion of 23 questions
  • Split sidebar navigation: dashboard demo and docs each have their own nav

Major dependency upgrades

  • ESLint 10, TypeScript 6, Stylelint 17, Astro 6.3, Bootstrap 5.3.8, Node 22 LTS in CI
  • npm install runs clean with 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
  • The bundled plugins/ folder is gone — every v3 jQuery widget has a documented vanilla-JS successor (replacement table: Select2 → Tom Select, DataTables → Tabulator, Summernote → Quill, …)
  • The v3 extra colours (.bg-navy, .bg-teal, the sidebar skins, …) live in opt-in stylesheets: dist/css/adminlte-colors.css — fourteen redesigned colours, every one readable with white text, 17 skin presets, plus a one-line hook for your brand colour — or dist/css/adminlte-colors-v3.css, the 18 AdminLTE 3 colours exactly as they were. Either sheet also lets you make one of them Bootstrap's primary — <html data-lte-primary="teal"> recolours buttons, links, pagination and form focus (Colors docs, live demo). Nothing is added to adminlte.css.

See the dedicated Migration from v3 guide.

Premium templates

AdminLTE will always be free and open source. When a project needs more — app-ready pages, framework-native codebases, dedicated support — our team hand-picks premium dashboards at adminlte.io/premium, including editions built for the same stacks AdminLTE integrates with:

Admindek — feature-rich Bootstrap 5 dashboard with dark mode
Admindek
The natural next step from AdminLTE: Bootstrap 5 + vanilla JS, 100+ components, dark/light modes, RTL, 10 color presets.
Also for Laravel · Next.js · Angular
Apex Dashboard — admin template available for Next.js, Laravel, Django and Angular
Apex Dashboard
5 dashboard variants, 20+ app pages, 125+ routes, full CRUD — in your backend's native stack.
For Next.js · Laravel · Django · Angular
Zenith — ultra-minimal admin dashboard, Django edition
Zenith Dashboard — Django
Achromatic, ultra-minimal design as a ready-to-run Django project: 50+ pages, 6 dashboards, live theme customizer.
Haze — Nuxt 4 admin dashboard with 92+ pages and 5 dashboards
Haze — Nuxt
Nuxt 4 + Nuxt UI v4 + Tailwind CSS v4. 92+ pages, 7 layouts, 5 dashboards, RTL, i18n, mock API layer.

View all premium templates →

Browser & platform support

AdminLTE supports the latest versions of all modern browsers (Chrome, Firefox, Safari, Edge) via Bootstrap 5.3.8. The build scripts run cross-platform — Windows (CMD, PowerShell, Git Bash), macOS and Linux — using cross-platform npm utilities throughout.

Security & production deployment

AdminLTE is a UI template. Deploy only the compiled production assets (dist/js/adminlte.min.js, dist/css/adminlte.min.css) and your own application files — never node_modules/, the demo HTML pages, or the src/ directory.

About CVE-2021-36471: this CVE is disputed and does not represent a vulnerability in AdminLTE — it refers to demo pages being accessible when example files are incorrectly deployed to production. AdminLTE v4 cleanly separates development demos from production assets.

For detailed guidelines, authentication requirements, and best practices, see 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

Contributions are highly welcome:

  1. Install Node.js (LTS) and clone this repository (master branch).
  2. npm install, then npm start to run the dev server.
  3. Make your changes (run npm run lint before committing) and open a PR against master.

License

AdminLTE is an open source project by AdminLTE.io licensed under MIT. AdminLTE.io reserves the right to change the license of future releases.

Image credits

[Pixeden](http://www.pixed

AdminLTE (ColorlibHQ/AdminLTE)

Searching Database…

45.7K ·GitHub
What is this?AdminLTE is a free, open-source admin dashboard template built on Bootstrap 5.3 with vanilla JavaScript (no jQuery), fully responsive and MIT-licensed, with official editions for React, Vue, Laravel, Django, Symfony, Angular, ASP.NET Core and Drupal.
Is this a framework, or just a set of HTML/CSS/JS files to drop into my app?It is a UI template, not an app or framework — you deploy the compiled CSS/JS assets alongside your own backend and pages; the HTML/Bootstrap version here is the core, with separately maintained component ports for other stacks.
How do I get it running?Pull it in via CDN with no build step, run `npm install admin-lte`, or use the framework-specific package (e.g. `composer require colorlibhq/adminlte-laravel`); to work on AdminLTE itself, clone the repo, run `npm install`, then `npm start` for a live-reload dev server.
Do I need jQuery or another Bootstrap setup first?No — v4 bundles Bootstrap 5.3.8 and ships zero jQuery, since all plugins were rewritten in vanilla TypeScript; building from source just needs Node.js 20+.
Is upgrading from AdminLTE v3 a drop-in replacement?No — v4 renames core classes (.wrapper to .app-wrapper, etc.), swaps data-toggle for data-bs-toggle, moves dark mode to Bootstrap's data-bs-theme attribute, and removes the bundled jQuery plugins/ folder in favor of vanilla-JS successors like Tabulator for DataTables.
Which frameworks does it officially integrate with besides plain HTML?There are maintained sibling editions for React & Next.js, Vue 3 & Nuxt, Laravel, Django, Symfony, Angular 22, ASP.NET Core (.NET 10) and Drupal, each shipping the same Bootstrap 5.3 design with idiomatic components for that stack.
Does AdminLTE cost anything?The core template is free forever under MIT. ColorlibHQ separately sells premium dashboard variants (ultra-minimal design, framework-native codebases, extra app pages) for teams that want more out of the box.
What's actually new in v4 compared to the old jQuery-based v3?v4 is a ground-up rewrite on Bootstrap 5.3 with no jQuery, adding 18 new demo pages (Calendar, Kanban, Chat, File Manager, Mailbox, Wizard, Tabulator data tables) and a completely rewritten documentation site.
Can I switch color themes or dark mode easily?Yes — v4 uses Bootstrap's native data-bs-theme="dark" attribute for dark mode, and ships optional stylesheets (adminlte-colors.css with 17 skin presets, or adminlte-colors-v3.css for the classic palette) that can even remap Bootstrap's primary color.
Creator
ColorlibHQ
Size
144.3 MB
Stars
45.7K
Age
12y
Commits · 90 Days