django-unfold

Django Unfold is a modern theme and toolkit for the Django admin that enhances django.contrib.admin with a polished interface built on Tailwind CSS, Alpine.js, and HTMX. Rather than replacing the admin, it layers on top of it, so existing models and workflows keep working while gaining a refreshed UI, sidebar navigation, dark mode, and richer components.

It ships drop-in ModelAdmin base classes, advanced filters, flexible actions, dashboards, and configurable UI elements, making it practical to turn the standard Django admin into a capable back-office and internal-tools platform with incremental adoption.

What You Get

• A modern, responsive admin UI built with Tailwind CSS and Alpine.js
• Drop-in ModelAdmin base classes that work alongside the default Django admin
• Configurable sidebar navigation with icons and collapsible sections
• Built-in light and dark mode themes
• Advanced filters, flexible actions, and dashboard components
• Incremental adoption with no model migrations required

Common Use Cases

• Giving an existing Django project a modern admin interface without rewrites
• Building internal tools and back-office dashboards on top of the Django admin
• Customizing admin navigation, filters, and actions for operational teams
• Adding dark mode and responsive layouts to an existing admin

Under The Hood

Architecture - The package lives under src/unfold and extends Django’s admin through subclassed components: admin.py provides the Unfold ModelAdmin, while components.py, dataclasses.py, decorators.py, checks.py, and a contrib package supply UI building blocks, configuration validation, and integrations. Front-end assets are compiled from Tailwind CSS with Alpine.js and HTMX behavior. Tech Stack - Python/Django on the server, Tailwind CSS plus Alpine.js and HTMX on the client, with a Node toolchain (package.json) for building styles and a pyproject.toml/uv.lock Python build. Code Quality - The repository includes a tests directory, structured docs, a maintained changelog, and CI release workflows, indicating active, disciplined maintenance. API Design - Adoption is deliberately low-friction: add unfold to INSTALLED_APPS, inherit from unfold.admin.ModelAdmin, and existing admin classes light up, with further customization available through declarative configuration.