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
AdminLTE
这是什么？AdminLTE 是一款免费开源的后台管理仪表盘模板，基于 Bootstrap 5.3 和原生 JavaScript（不依赖 jQuery）构建，完全响应式布局，采用 MIT 许可证，并提供 React、Vue、Laravel、Django、Symfony、Angular、ASP.NET Core 和 Drupal 的官方版本。
这是一个框架，还是只是一组可以直接放进我应用里的 HTML/CSS/JS 文件？它是一个界面模板，而不是应用或框架——你需要把编译后的 CSS/JS 资源和你自己的后端、页面一起部署；这里的 HTML/Bootstrap 版本是核心，其他技术栈则有单独维护的组件移植版。
我该怎么让它跑起来？可以通过 CDN 直接引入，无需构建步骤；也可以运行 `npm install admin-lte`，或使用针对特定框架的包（例如 `composer require colorlibhq/adminlte-laravel`）。如果要参与 AdminLTE 本身的开发，请克隆仓库，运行 `npm install`，然后用 `npm start` 启动支持热重载的开发服务器。
我需要先安装 jQuery 或其他 Bootstrap 配置吗？不需要——v4 内置了 Bootstrap 5.3.8，完全不含 jQuery，因为所有插件都已用原生 TypeScript 重写；从源码构建只需要 Node.js 20 或更高版本。
从 AdminLTE v3 升级后可以直接替换吗？不可以——v4 会重命名核心类名（例如 .wrapper 改为 .app-wrapper 等），把 data-toggle 换成 data-bs-toggle，将深色模式改为 Bootstrap 的 data-bs-theme 属性，并移除内置的 jQuery 插件 plugins/ 文件夹，改用原生 JavaScript 的替代方案，例如用 Tabulator 替代 DataTables。
除了纯 HTML，它还官方支持哪些框架？目前有持续维护的同系列版本，支持 React 和 Next.js、Vue 3 和 Nuxt、Laravel、Django、Symfony、Angular 22、ASP.NET Core（.NET 10）以及 Drupal。每个版本都采用相同的 Bootstrap 5.3 设计，并提供符合各自技术栈习惯的组件。
AdminLTE 收费吗？核心模板依据 MIT 许可证永久免费。ColorlibHQ 另外还销售付费的仪表盘变体（超简约设计、与框架原生结合的代码库、额外的应用页面），面向希望开箱即用功能更多的团队。
和基于 jQuery 的旧版 v3 相比，v4 到底有什么新变化？v4 基于 Bootstrap 5.3 完全重写，不再使用 jQuery，新增了 18 个演示页面（日历、看板、聊天、文件管理器、邮箱、向导、Tabulator 数据表格），文档网站也进行了全面重写。
我能轻松切换配色主题或深色模式吗？可以——v4 使用 Bootstrap 原生的 data-bs-theme="dark" 属性实现深色模式，并提供可选的样式表：adminlte-colors.css 包含 17 套皮肤预设，adminlte-colors-v3.css 则提供经典配色；这些样式表甚至可以重新映射 Bootstrap 的主色调。
What are similar projects?gentelella, coreui-free-bootstrap-admin-template, tabler, vuestic-admin, blur-admin, ngx-admin, mdb-ui-kit, shadcn-admin
Which topics is it in?vanilla-js, bootstrap5, admin-ui, admin-template, dashboards, admin-panel, css-framework, astro, bootstrap, admin, vanilla-javascript, responsive
Creator
ColorlibHQ
Size
144.3 MB
Stars
45.7K
Updated
CommitOct 08Releasev4.10.1Oct 08
Age
12y
Commits · 90 Days