Django jazzmin (Jazzy Admin)
Project Status
This project is being actively maintained, though with a reduced feature set, we are looking for contributors to help
maintain and improve the project, please get in touch if you would like to help.
Help needed with:
- Triaging issues
- Frontend fixes and UI improvements
- Testing
- Documentation
-
python3 -m build --sdist
Pull requests are welcome, though ive been pre-occupied with other projects lately, so have not been able to review
them as quickly as I would like, but im trying to get through them all now, hopefully with some outside help.
![Coverage Status](https://coveralls.io/repos/github/farridav/django-jazzmin/badge.svg?branch=master)
Drop-in theme for django admin, that utilises AdminLTE 3 & Bootstrap 4 to make yo' admin look jazzy
Installation
pip install django-jazzmin
Documentation
See Documentation or Test App
Features
- Drop-in admin skin, all configuration optional
- Customisable side menu
- Customisable top menu
- Customisable user menu
- 4 different Change form templates (horizontal tabs, vertical tabs, carousel, collapsible)
- Bootstrap 4 modal (instead of the old popup window, optional)
- Search bar for any given model admin
- Customisable UI (via Live UI changes, or custom CSS/JS)
- Responsive
- Select2 drop-downs
- Bootstrap 4 & AdminLTE UI components
- Using the latest adminlte + bootstrap
Screenshots
Dashboard
![dashboard](https://django-jazzmin.readthedocs.io/img/dashboard.png)
List view
![table list](https://django-jazzmin.readthedocs.io/img/list_view.png)
Change form templates
![form page](https://django-jazzmin.readthedocs.io/img/detail_view.png)
Expanded side menu
![Single](https://django-jazzmin.readthedocs.io/img/changeform_single.png)
Horizontal tabs
![Horizontal tabs](https://django-jazzmin.readthedocs.io/img/changeform_horizontal_tabs.png)
Vertical tabs
![Vertical tabs](https://django-jazzmin.readthedocs.io/img/changeform_vertical_tabs.png)
Collapsible
![Collapsible](https://django-jazzmin.readthedocs.io/img/changeform_collapsible.png)
Carousel
![Carousel](https://django-jazzmin.readthedocs.io/img/changeform_carousel.png)
Related modal
![Related modal](https://django-jazzmin.readthedocs.io/img/related_modal_bootstrap.png)
History page
![form page](https://django-jazzmin.readthedocs.io/img/history_page.png)
Login view
![login](https://django-jazzmin.readthedocs.io/img/login.png)
UI Customiser
![ui_customiser](https://django-jazzmin.readthedocs.io/img/ui_customiser.png)
Mobile layout
![mobile](https://django-jazzmin.readthedocs.io/img/dashboard_mobile.png)
Tablet layout
![tablet](https://django-jazzmin.readthedocs.io/img/dashboard_tablet.png)
Admin Docs (if installed)
![admin_docs](https://django-jazzmin.readthedocs.io/img/admin_docs.png)
Thanks
This was initially a Fork of https://github.com/wuyue92tree/django-adminlte-ui that we refactored so much we thought it
deserved its own package, big thanks to @wuyue92tree for all of his initial hard work, we are still patching into that
project were possible, but this project has taken a different direction.
The javascript modal implementation uses some code from django-admin-interface, so thanks to @fabiocaccamo for original work