Repolode
jazzband

jazzband/django-admin2

A rewrite of Django's built-in admin interface, built on class-based views and designed to be extended and themed.

Stars
1,186
Forks
147
Open issues
43
Last commit
26 days ago

What is it?

django-admin2 is a rewrite of django.contrib.admin, the configurable data management interface that ships with Django. It is rebuilt on modern Class-Based Views so that the codebase avoids legacy code and is easier to extend and adapt.

The project provides drop-in themes that can be switched through a settings option, with a Bootstrap 3 theme as the default. It also includes a built-in RESTful API alongside the admin views. Models are registered with a site object, and each model can get a custom ModelAdmin2 class that sets its own create and update forms.

It requires Django 2.2 or later and Python 3.5 or later, and depends on django-braces, django-extra-views, django-rest-framework and django-filter.

Key features

  • 01Rewrites Django's admin backend using Class-Based Views.
  • 02Supports drop-in themes selected through a settings option.
  • 03Includes a built-in RESTful API.
  • 04Lets each model define its own admin class with custom create and update forms.

Use cases

  • Extending the Django admin with custom views for specific models.
  • Building a custom-themed admin interface for a Django project.
  • Exposing admin data through a RESTful API within a Django app.

Quick start

  1. 1

    Install the package from PyPI

    pip install django-admin2
  2. 2

    Add djadmin2 and rest_framework to INSTALLED_APPS, plus the default theme and REST_FRAMEWORK settings

  3. 3

    Add djadmin2 URLs to your URLconf and register your models in an admin2 module

Things to know

  • The README lists old requirements (Django 2.2+, Python 3.5+), so check compatibility with your current Django version.
  • Setup needs several manual settings and a theme choice before the admin works.

In collections

Topics

FAQ

What is django-admin2?
A rewrite of Django's built-in admin interface, built on class-based views and designed to be extended and themed. django-admin2 is a rewrite of django.contrib.admin, the configurable data management interface that ships with Django. It is rebuilt on modern Class-Based Views so that the codebase avoids legacy code and is easier to extend and adapt.
Is django-admin2 free to use? What license does it have?
django-admin2 is open source under the BSD-3-Clause license. Check the license terms before using it in commercial products.
Is django-admin2 still maintained?
Actively maintained. The last commit to django-admin2 was on Oct 13, 2026.
What can I use django-admin2 for?
Extending the Django admin with custom views for specific models. Building a custom-themed admin interface for a Django project. Exposing admin data through a RESTful API within a Django app.
How do I install django-admin2?
Install the package from PyPI: pip install django-admin2 Add djadmin2 and rest_framework to INSTALLED_APPS, plus the default theme and REST_FRAMEWORK settings Add djadmin2 URLs to your URLconf and register your models in an admin2 module
Where can I get django-admin2?
The source code and installation instructions are on GitHub: https://github.com/jazzband/django-admin2

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects