https://github.com/unfoldadmin/django-unfold
Modern Django Admin
https://github.com/unfoldadmin/django-unfold
admin alpinejs darkmode dashboard django filters htmx python responsive tailwindcss theme ui wysiwyg
Last synced: 30 days ago
JSON representation
Modern Django Admin
- Host: GitHub
- URL: https://github.com/unfoldadmin/django-unfold
- Owner: unfoldadmin
- License: mit
- Created: 2022-08-19T07:00:41.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2026-10-12T08:44:19.000Z (about 1 month ago)
- Last Synced: 2026-10-12T10:35:09.173Z (about 1 month ago)
- Topics: admin, alpinejs, darkmode, dashboard, django, filters, htmx, python, responsive, tailwindcss, theme, ui, wysiwyg
- Language: Python
- Homepage: https://unfoldadmin.com
- Size: 7.79 MB
- Stars: 3,719
- Watchers: 32
- Forks: 377
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
- Security: .github/SECURITY.md
Awesome Lists containing this project
- awesome-django - django-unfold - Modern Django admin theme for seamless interface development. (Third-Party Packages / Admin Themes)
- fucking-awesome-python - django-unfold - Elevate your Django admin with a stunning modern interface, powerful features, and seamless user experience. (Admin Panels)
- awesome-django-admin-interface - Django Unfold - Modern Django admin theme for seamless interface development. (Best Django Admin Interface Resources / Django Admin Themes & UI Enhancements)
- awesome-django-admin - django-unfold
- awesome-python - django-unfold - Elevate your Django admin with a stunning modern interface, powerful features, and seamless user experience. (Admin Panels)
README
Unfold - Modern Django admin
A modern Django admin theme for building dashboards, internal tools, and business applications
Live demo ·
Documentation ·
Discord ·
PyPI
## Quickstart
**Install the package**
```sh
uv add django-unfold
```
**Add Unfold to INSTALLED_APPS**
```python
INSTALLED_APPS = [
"unfold", # First in the list
# ...
]
```
**Use Unfold's ModelAdmin**
```python
from django.contrib import admin
from unfold.admin import ModelAdmin
@admin.register(MyModel)
class MyModelAdmin(ModelAdmin):
pass
```
## Why Unfold?
- **Django native** - Built on `django.contrib.admin`, preserving familiar models, permissions, and conventions.
- **Incremental adoption** - Introduce Unfold gradually without rebuilding your existing admin.
- **Built for real applications** - Designed for dashboards, internal tools, backoffice systems, and workflows.
## Features
- **Modern interface** - Responsive Tailwind CSS design with dark mode, customizable colors, layout options, and other visual settings for a polished admin experience.
- **Dashboards and components** - Build custom dashboards and admin pages using reusable cards, charts, buttons, and other UI components for data-rich interfaces.
- **Advanced filtering** - Dropdown, autocomplete, text, numeric, date range, checkbox, radio, and facet filters for more powerful and flexible changelists.
- **Flexible actions** - Add global, row-level, detail, submit, and dropdown actions with custom permissions, styles, and flexible placement options across the admin.
- **Navigation and tabs** - Customize the sidebar and organize models, fieldsets, and inlines using flexible tab navigation and layout options for complex interfaces.
- **Enhanced forms and inlines** - Conditional fields, sortable and paginated inlines, WYSIWYG editing, ArrayField widgets, and django-crispy-forms support for richer admin forms.
- **Third-party integrations** - Built-in support for popular Django packages including django-import-export, django-guardian, django-simple-history, django-constance, and more.
[Explore all features](https://unfoldadmin.com/features/?utm_source=github&utm_medium=readme)
## Third-party package support
- [django-celery-beat](https://github.com/celery/django-celery-beat) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-celery-beat/?utm_source=github&utm_medium=readme)
- [django-constance](https://github.com/jazzband/django-constance) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-constance/?utm_source=github&utm_medium=readme)
- [django-guardian](https://github.com/django-guardian/django-guardian) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-guardian/?utm_source=github&utm_medium=readme)
- [django-hijack](https://github.com/django-hijack/django-hijack) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-hijack/?utm_source=github&utm_medium=readme)
- [django-import-export](https://github.com/django-import-export/django-import-export) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-import-export/?utm_source=github&utm_medium=readme)
- [django-json-widget](https://github.com/jmrivas86/django-json-widget) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-json-widget/?utm_source=github&utm_medium=readme)
- [django-location-field](https://github.com/caioariede/django-location-field) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-location-field/?utm_source=github&utm_medium=readme)
- [django-money](https://github.com/django-money/django-money) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-money/?utm_source=github&utm_medium=readme)
- [django-reversion](https://github.com/etianen/django-reversion) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-reversion/?utm_source=github&utm_medium=readme)
- [django-reversion-compare](https://codeberg.org/jedie/django-reversion-compare) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-reversion-compare/?utm_source=github&utm_medium=readme)
- [django-simple-history](https://github.com/jazzband/django-simple-history) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-simple-history/?utm_source=github&utm_medium=readme)
- [django-waffle](https://github.com/django-waffle/django-waffle) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-waffle/?utm_source=github&utm_medium=readme)
- [djangoql](https://github.com/ivelum/djangoql) - [Integration guide](https://unfoldadmin.com/docs/integrations/djangoql/?utm_source=github&utm_medium=readme)
## Credits
- [Tailwind CSS](https://github.com/tailwindlabs/tailwindcss) - Licensed under the [MIT License](https://opensource.org/licenses/MIT).
- [Material Symbols](https://github.com/google/material-design-icons) - Licensed under the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).
- [Inter](https://github.com/rsms/inter) - Licensed under the [SIL Open Font License 1.1](https://scripts.sil.org/OFL).
- [Chart.js](https://github.com/chartjs/Chart.js) - Licensed under the [MIT License](https://opensource.org/licenses/MIT).
- [Alpine.js](https://github.com/alpinejs/alpine) - Licensed under the [MIT License](https://opensource.org/licenses/MIT).
- [HTMX](https://htmx.org/) - Licensed under the [BSD 2-Clause License](https://opensource.org/licenses/BSD-2-Clause).
- [Trix](https://github.com/basecamp/trix) - Licensed under the [MIT License](https://opensource.org/licenses/MIT).
- [Jedison](https://github.com/germanbisurgi/jedison) - Licensed under the [MIT License](https://opensource.org/licenses/MIT).