Introduction
AdminLTE 4 for Django is the official Django integration that brings the AdminLTE 4 admin template to your project as a reusable app — a base layout you extend with template blocks, a config-driven sidebar with a per-request filter pipeline, 33+ django-components components, and a themed django.contrib.admin.
The package wraps AdminLTE 4 (Bootstrap 5.3) the way a Django developer expects: add the app to INSTALLED_APPS, declare your menu in an ADMINLTE settings dict, extend adminlte/page.html, and drop {% component "adminlte_card" %} tags into your templates. It hooks into Django's own forms, tables, auth, messages, pagination and i18n — and ships a pre-built asset bundle so you can run with zero Node.
Key features
- django-components library — 33+ components such as
adminlte_card,adminlte_small_boxandadminlte_info_box, mirroring the inventory of the Vue and React ports. - Config-driven sidebar menu — one
menuarray insettings.ADMINLTE, run through a filter pipeline that resolves named routes, computes active state, and hides items behind permissions or callables per request. - Themed Django admin —
django.contrib.adminwears the AdminLTE 4 shell out of the box, with a sidebar auto-generated from your registered apps/models. - Form integration — a
FORM_RENDERERthat makes plain{{ form }}render Bootstrap 5 markup, plus bespoke form components and optional crispy-forms support. - Dark mode — built on Bootstrap 5.3's
data-bs-themewith a Light / Dark / Auto toggle in the topbar. - Vite-ready, or Node-free — the default
"vite"pipeline gives HMR and lazy-loaded plugins viadjango-vite;"static"serves the shipped bundle with justcollectstatic.
Requirements
| Dependency | Version |
|---|---|
| Python | 3.12+ |
| Django | 6.0+ |
| django-components | 0.150 |
| django-vite (vite mode only) | 3.1+ |
| Bootstrap | 5.3 |
| Node (Vite build only) | 18+ |
Install in one line
pip install adminlte-djangoThe PyPI package is adminlte-django; the Django app label you add to INSTALLED_APPS is django_adminlte4. See the Installation page for the full settings wiring.
Links
- Live demo: django.adminlte.io
- Repository: github.com/ColorlibHQ/adminlte-django
- PyPI: pypi.org/project/adminlte-django
- AdminLTE: adminlte.io
AdminLTE is available across many stacks — the same template is also offered as official ports for React/Next.js, Vue/Nuxt, Laravel, Symfony, Angular and ASP.NET Core.