https://github.com/farridav/django-jazzmin

Jazzy theme for Django
https://github.com/farridav/django-jazzmin

admin adminlte dashboard django jazzmin theme

Last synced: 4 days ago
JSON representation

Jazzy theme for Django

• Host: GitHub
• URL: https://github.com/farridav/django-jazzmin
• Owner: farridav
• License: mit
• Created: 2020-05-11T19:50:44.000Z (almost 5 years ago)
• Default Branch: main
• Last Pushed: 2025-03-06T04:29:43.000Z (about 1 month ago)
• Last Synced: 2025-03-17T12:48:32.830Z (27 days ago)
• Topics: admin, adminlte, dashboard, django, jazzmin, theme
• Language: HTML
• Homepage: https://django-jazzmin.readthedocs.io
• Size: 21.9 MB
• Stars: 1,709
• Watchers: 37
• Forks: 294
• Open Issues: 138
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-django-admin - django-jazzmin
• -awesome-django - django-jazzmin - Drop-in theme for django admin, that utilises AdminLTE 3 & Bootstrap 4 to make yo' admin look jazzy. (Third-Party Packages / Admin)
• awesome-starts - farridav/django-jazzmin - Jazzy theme for Django (HTML)
• awesome-django - Django Jazzmin - Drop-in theme for django admin, that utilises AdminLTE 3 & Bootstrap 4 to make yo' admin look jazzy (Admin interface)
• awesome-open-source - django-jazzmin - Jazzy theme for Django (Python)
• stars - farridav/django-jazzmin - Jazzy theme for Django (HTML)
• stars - farridav/django-jazzmin - Jazzy theme for Django (HTML)
• awesome-django - django-jazzmin - Drop-in theme for django admin, that utilises AdminLTE 3 & Bootstrap 4 to make yo' admin look jazzy. (Third-Party Packages / Admin Themes)

README

        

# 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

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.

[![Docs](https://readthedocs.org/projects/django-jazzmin/badge/?version=latest)](https://django-jazzmin.readthedocs.io)

![PyPI download month](https://img.shields.io/pypi/dm/django-jazzmin.svg)

[![PyPI version](https://badge.fury.io/py/django-jazzmin.svg)](https://pypi.python.org/pypi/django-jazzmin/)

![Python versions](https://img.shields.io/badge/python-%3E=3.9-brightgreen)

![Django Versions](https://img.shields.io/badge/django-%3E=4.2-brightgreen)

[![Coverage Status](https://coveralls.io/repos/github/farridav/django-jazzmin/badge.svg?branch=main)](https://coveralls.io/github/farridav/django-jazzmin?branch=main)

Drop-in theme for django admin, that utilises AdminLTE 3.2 & Bootstrap 5 to make yo' admin look jazzy

## Installation

```bash

pip install django-jazzmin

```

## Documentation

See [Documentation](https://django-jazzmin.readthedocs.io) or [Test App](https://github.com/farridav/django-jazzmin/tree/main/tests/test_app/library/settings.py)

## Demo

Live demo https://django-jazzmin-test.onrender.com

**Username**: [email protected]

**Password**: test

*Note: Data resets nightly*

*Note: ☕ If the app seems sleepy, give it a minute - it's just having its power nap on the free tier.*

## 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 5 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 5 & AdminLTE UI components

- Using the latest [adminlte](https://adminlte.io/) + [bootstrap](https://getbootstrap.com/)

## 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

### Collapsed side menu

![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  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](https://github.com/fabiocaccamo/django-admin-interface/blob/main/admin_interface/static/admin/js/popup_response.js), so thanks to @fabiocaccamo for original work

- Based on AdminLTE 3: 

- Using Bootstrap 5: 

- Using Font Awesome 5: