https://github.com/unfoldadmin/django-unfold

Modern Django admin theme for seamless interface development
https://github.com/unfoldadmin/django-unfold

admin alpinejs darkmode dashboard django filters htmx python responsive tailwindcss theme ui wysiwyg

Last synced: 2 days ago
JSON representation

Modern Django admin theme for seamless interface development

• Host: GitHub
• URL: https://github.com/unfoldadmin/django-unfold
• Owner: unfoldadmin
• License: mit
• Created: 2022-08-19T07:00:41.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-10-28T17:38:12.000Z (about 1 month ago)
• Last Synced: 2024-10-29T15:11:04.406Z (about 1 month ago)
• Topics: admin, alpinejs, darkmode, dashboard, django, filters, htmx, python, responsive, tailwindcss, theme, ui, wysiwyg
• Language: HTML
• Homepage: https://unfoldadmin.com
• Size: 3.72 MB
• Stars: 1,776
• Watchers: 18
• Forks: 177
• Open Issues: 18
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.md

Awesome Lists containing this project

• awesome-django-admin - django-unfold
• awesome-django - django-unfold - Modern Django admin theme for seamless interface development. (Third-Party Packages / Admin)

README

        
![screenshot](https://github.com/user-attachments/assets/b5ec09b6-c8c7-454a-85af-1bba97593632)

## Unfold Django Admin Theme

[![PyPI - Version](https://img.shields.io/pypi/v/django-unfold.svg?style=for-the-badge)](https://pypi.org/project/django-unfold/)

[![Build](https://img.shields.io/github/actions/workflow/status/unfoldadmin/django-unfold/release.yml?style=for-the-badge)](https://github.com/unfoldadmin/django-unfold/actions?query=workflow%3Arelease)

![Pre Commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white&style=for-the-badge)

![Code Style - Ruff](https://img.shields.io/badge/code%20style-ruff-30173D.svg?style=for-the-badge)

Unfold is a theme for Django admin that incorporates common best practices for building full-fledged admin areas. It is designed to work on top of the default administration provided by Django.

- **Documentation:** Full docs are available at [unfoldadmin.com](https://unfoldadmin.com?utm_medium=github&utm_source=unfold).

- **Unfold:** Demo site is available at [unfoldadmin.com](https://unfoldadmin.com?utm_medium=github&utm_source=unfold).

- **Formula:** Repository with demo implementation at [github.com/unfoldadmin/formula](https://github.com/unfoldadmin/formula?utm_medium=github&utm_source=unfold).

- **Turbo:** Django & Next.js boilerplate implementing Unfold at [github.com/unfoldadmin/turbo](https://github.com/unfoldadmin/turbo?utm_medium=github&utm_source=unfold).

- **Discord:** Join the Unfold community on [Discord](https://discord.gg/9sQj9MEbNz).

## Are you using Unfold and need help?

Have you decided to start using Unfold but don’t have time to make the switch from the native Django admin? [Get in touch with us](https://unfoldadmin.com/consulting?utm_medium=github&utm_source=unfold) and let’s supercharge your development with our expertise.

## Features

- **Visual**: Provides a new user interface based on the Tailwind CSS framework.

- **Sidebar:** Simplifies the creation of sidebar navigation with icons, collapsibles, and more.

- **Dark mode:** Supports both light and dark mode versions.

- **Actions:** Offers multiple ways to define actions within different parts of the admin interface.

- **Filters:** Custom dropdowns, numeric, datetime, and text fields.

- **Dashboard:** Includes helpers for creating custom dashboard pages.

- **Components:** Reusable UI components such as cards, buttons, and charts.

- **WYSIWYG widget:** Built-in support for WYSIWYG (Trix).

- **Array widget:** Built-in widget for `django.contrib.postgres.fields.ArrayField`.

- **Inline tabs:** Groups inlines into tab navigation in the change form.

- **Model tabs:** Allows defining custom tab navigation for models.

- **Fieldset tabs:** Merges multiple fieldsets into tabs in the change form.

- **Sortable inlines:** Allows sorting inlines by dragging and dropping.

- **Environment label**: Distinguishes between environments by displaying a label.

- **Nonrelated inlines**: Displays nonrelated models as inlines in the change form.

- **Favicons**: Built-in support for configuring various site favicons.

- **Colors:** Allows customization of the default color scheme.

- **Changeform modes:** Displays fields in compressed mode in the change form.

- **Parallel admin**: Supports [running the default admin](https://unfoldadmin.com/blog/migrating-django-admin-unfold/?utm_medium=github&utm_source=unfold) alongside Unfold.

- **Third party packages:** Default support for multiple popular applications.

- **Configuration:** Most basic options can be changed in `settings.py`.

- **Dependencies:** Fully based on `django.contrib.admin`.

- **VS Code**: Project configuration and development container included.