Unfold - Modern Django Admin
Enhance Django Admin with a modern interface and powerful tools to build internal applications.
- Documentation: The full documentation is available at unfoldadmin.com.
- Live demo: The demo site is available at unfoldadmin.com.
- Demo repository: A repository with a demo implementation is available at github.com/unfoldadmin/formula.
- Discord: Join our Unfold community on Discord.
Quickstart
Install the package
pip install django-unfold
Change INSTALLED_APPS in settings.py
INSTALLED_APPS = [
"unfold",
# Rest of the apps
]
Use Unfold ModelAdmin
from unfold.admin import ModelAdmin
@admin.register(MyModel)
class MyModelAdmin(ModelAdmin):
pass
Unfold works alongside the default Django admin and requires no migration of existing models or workflows. Unfold is actively developed and continuously evolving as new use cases and edge cases are discovered.
Why Unfold?
- Built on
django.contrib.admin: Enhances the existing admin without replacing it. - Provides a modern interface and improved workflows.
- Designed for real internal tools and backoffice apps.
- Incremental adoption for existing projects.
Features
- Visual interface: Provides a modern user interface based on the Tailwind CSS framework.
- Sidebar navigation: Simplifies the creation of sidebar menus with icons, collapsible sections, and more.
- Dark mode support: Includes both light and dark mode themes.
- Flexible actions: Provides multiple ways to define actions throughout the admin interface.
- Advanced filters: Features custom dropdowns, autocomplete, numeric, datetime, and text field filters.
- Dashboard tools: Includes helpers for building custom dashboard pages.
- UI components: Offers reusable interface components such as cards, buttons, and charts.
- Crispy forms: Custom template pack for django-crispy-forms to style forms with Unfold's design system.
- WYSIWYG editor: Built-in support for WYSIWYG editing through Trix.
- Array widget: Support for
django.contrib.postgres.fields.ArrayField. - Inline tabs: Group inlines into tab navigation in the change form.
- Conditional fields: Show or hide fields dynamically based on the values of other fields in the form.
- Model tabs: Allow defining custom tab navigation for models.
- Fieldset tabs: Merge multiple fieldsets into tabs in the change form.
- Sortable inlines: Allow sorting inlines by dragging and dropping.
- Command palette: Quickly search across models and custom data.
- Datasets: Custom changelists
ModelAdmindisplayed on change form detail pages. - Environment label: Distinguish between environments by displaying a label.
- Nonrelated inlines: Display nonrelated models as inlines in the change form.
- Paginated inlines: Break down large record sets into pages within inlines for better admin performance.
- Favicons: Built-in support for configuring various site favicons.
- Theming: Customize color schemes, backgrounds, border radius, and more.
- Font colors: Adjust font colors for better readability.
- Changeform modes: Display fields in compressed mode in the change form.
- Language switcher: Allow changing language directly from the admin area.
- Infinite paginator: Efficiently handle large datasets with seamless pagination that reduces server load.
- Parallel admin: Supports running the default admin alongside Unfold.
- Third-party packages: Provides default support for multiple popular applications.
- Configuration: Allows basic options to be changed in
settings.py. - Dependencies: Built entirely on
django.contrib.admin.
Third-party package support
- django-guardian - Integration guide
- django-import-export - Integration guide
- django-simple-history - Integration guide
- django-constance - Integration guide
- django-celery-beat - Integration guide
- django-money - Integration guide
- django-location-field - Integration guide
- djangoql - Integration guide
- django-json-widget - Integration guide
- django-hijack - Integration guide
- django-waffle - Integration guide
Professional services
Need help integrating, customizing, or scaling Django Admin with Unfold?
- Consulting: Expert guidance on Django architecture, performance, feature development, and Unfold integration. Learn more
- Support: Assistance with integrating or customizing Unfold, including live 1:1 calls and implementation review. Fixed price, no ongoing commitment. Learn more
- Studio: Extend Unfold with advanced dashboards, visual customization, and additional admin tooling. Learn more
Credits
- Tailwind: Tailwind CSS - Licensed under the MIT License.
- Icons: Material Symbols - Licensed under the Apache License 2.0.
- Font: Inter - Licensed under the SIL Open Font License 1.1.
- Charts: Chart.js - Licensed under the MIT License.
- JavaScript Framework: Alpine.js - Licensed under the MIT License.
- AJAX calls: HTMX - Licensed under the BSD 2-Clause License.
- WYSIWYG Editor: Trix - Licensed under the MIT License.
1 maintainer
Metadata
1 maintainer
Release files for django-unfold 0.105.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| django_unfold-0.105.0.tar.gz | 1.1 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| django_unfold-0.105.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.3 MB
Release files / django_unfold-0.105.0.tar.gz
| Download URL | django_unfold-0.105.0.tar.gz |
|---|---|
| Size | 1.1 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0051c43185bc54807d522fad50663a5b1332ae0e54ebe490b1f6c879cc6962db
|
|
BLAKE2b-256 checksum How to use checksums |
1bb672c412b2a296a3d7a283d5cff80a2b2b539dd621434da0d0e67f9df4add3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.9 {"installer":{"name":"uv","version":"0.12.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / django_unfold-0.105.0-py3-none-any.whl
| Download URL | django_unfold-0.105.0-py3-none-any.whl |
|---|---|
| Size | 1.2 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b72880caa376bdc893c2e256dd990812c0301f269e0b977a6b9b4342c6606477
|
|
BLAKE2b-256 checksum How to use checksums |
08c272eccd0adacdca28a6dbd54b7092c8cd29b71ef881fc293e49ee57276fd9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.9 {"installer":{"name":"uv","version":"0.12.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
