About this project
AdminLTE is an open-source admin dashboard UI template distributed under the MIT license by AdminLTE.io. This repository is the HTML/Bootstrap core edition; the same design is also maintained as separate repositories for other stacks.
Technology and layout
- Built on Bootstrap 5.3 and vanilla JavaScript, without a jQuery dependency in v4.
- Responsive layouts intended to fit small mobile screens through large desktops.
- Dark mode uses Bootstrap 5.3's native data-bs-theme attribute instead of a custom body class.
- RTL support, plus opt-in colour stylesheets: dist/css/adminlte-colors.css (redesigned colours, white-text readable, 17 skin presets, and a data-lte-primary hook for branding) or dist/css/adminlte-colors-v3.css, which keeps the 18 AdminLTE 3 colours as they were. Nothing is added to adminlte.css.
Installation and development
- CDN: link admin-lte@4 CSS and JS from jsDelivr, no build step.
- npm: npm install admin-lte@4.
- Composer: composer require almasaeed2010/adminlte.
- Working on AdminLTE itself: npm install, then npm start for a dev server on port 3000 with live reload; npm run build for development assets; npm run production for the full lint, optimize and bundlewatch pipeline. Separate npm run css, npm run js, and npm run lint tasks are documented.
What v4 changes
The v4 line is described in the README as a ground-up rewrite on Bootstrap 5.3 without jQuery. It adds 18 demo pages and reworks the documentation. Demo pages cover apps (Calendar with FullCalendar, Kanban with SortableJS, Chat, File Manager, Projects, Mailbox inbox/read/compose), forms (a four-step wizard with validation), tables (Tabulator-based data tables, jQuery-free), pages (Profile, Settings, Invoice, Pricing, FAQ) and error pages (404, 500, Maintenance).
The 4.3 release notes mention a SidebarSearch plugin that filters the sidebar menu while typing, expands whichever submenu holds a match, and restores the menu when cleared; ribbon corner banners in three sizes that mirror in RTL; social and post widgets (.user-block, .post, .widget-user, .widget-user-2, .description-block); and three new demo pages (Gallery, Search Results, Ribbons). Nav tabs, modals and offcanvas were added to the general UI showcase, and documentation gained card, miscellaneous and language-switcher pages so that every component shipping CSS has a reference page.
Migration from v3
The README lists breaking changes: class renames such as .wrapper to .app-wrapper, .main-header to .app-header, .main-sidebar to .app-sidebar, .content-wrapper to .app-main; data attribute changes such as data-toggle to data-bs-toggle, data-widget="pushmenu" to data-lte-toggle="sidebar" and the equivalent for treeview; dark mode moving to data-bs-theme. The bundled plugins/ folder is removed, and a replacement table maps each v3 jQuery widget to a vanilla-JS successor (for example Select2 to Tom Select, DataTables to Tabulator, Summernote to Quill).
Framework editions
Separate repositories integrate the same dashboard for React and Next.js, Vue 3 and Nuxt, Laravel (Blade components, config-driven menu, auth scaffolding), Django (reusable app, menu filter pipeline, themed admin), Symfony (Twig components, AssetMapper, EasyAdmin theme), Angular, ASP.NET Core (Blazor components plus MVC/Razor Pages tag helpers) and Drupal. Each is installed through its own package manager entry point.
Deployment and security
AdminLTE is a UI template: production deployments should ship only the compiled dist assets and application files, never node_modules, the demo HTML pages or src/. The README states that CVE-2021-36471 is disputed and refers to demo pages being reachable when example files are incorrectly deployed, and that SECURITY.md holds detailed guidance on authentication and best practices.
Browser support, contributing and licensing
Bootstrap 5.3 supports current versions of Chrome, Firefox, Safari and Edge, and the build scripts are described as cross-platform across Windows, macOS and Linux. Contributions target the master branch: install Node.js LTS, run npm install and npm start, lint before committing, and open a pull request. The project is MIT licensed, and the README also points to premium templates and GitHub Sponsors or PayPal donation options alongside the free edition.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.