Adminita Django Admin Theme

Project Details

Adminita Django Admin Theme

Completed December 2025. A beautiful, responsive Django admin theme built with Tailwind CSS v4 featuring dark mode support.

Live Site GitHub Repo For Sale

Technologies Used

Claude Code Django TailwindCSS

Overview

Key takeaways
  • Adminita is a drop-in replacement for Django's default admin that needs minimal configuration.
  • It is built with Tailwind CSS v4, with responsive design and dark mode support.
  • Full Django admin functionality is kept.
  • It is open source and available on PyPI and GitHub.

Adminita transforms Django's default admin interface into a sleek, modern dashboard. Built with Tailwind CSS v4, it provides a professional-grade admin experience with responsive design, dark mode support, and contemporary styling while maintaining full Django admin functionality.

Built from the ground up with Tailwind CSS v4, Adminita delivers a polished, professional admin experience that you'd expect from a premium SaaS dashboard. Clean typography, intuitive spacing, smooth transitions, and a dark mode (once it works!).

The project was created to provide an alternative to the regular Django default admin. It is  a drop-in replacement that requires minimal configuration.

v1.0Open-source release
MITOpen source terms
pipInstall from PyPI

Technical Details

What is inside Adminita

Built with

  • Django 5.2 - Built and tested with the latest Django version
  • Tailwind CSS v4 - Uses the new @theme syntax and CSS-first approach
  • PyPI Package - Distributed as an installable Python package
  • PYPI profile - https://pypi.org/project/adminita/

Features

  • Dark Mode - System preference detection with manual toggle and localStorage persistence
  • Responsive Design - Mobile-first approach with collapsible sidebar navigation
  • Template Overrides - Custom templates for login, index, change_list, and change_form views
  • Utility Classes - Includes AlwaysVisibleAdmin and SingletonAdmin helpers for common admin patterns
Guide

Quick Start

  1. Install via pipOne command installs the package.
    Show the command

    pip install adminita

  2. Add to INSTALLED_APPSIt must be before django.contrib.admin.
    Show the setting

    INSTALLED_APPS = [
    "adminita", # Must be FIRST!
    "django.contrib.admin",
    "django.contrib.auth",
    # ... your other apps ]

  3. Configure static filesSet the static URL and root.
    Show the setting

    STATIC_URL = "/static/"
    STATIC_ROOT = BASE_DIR / "staticfiles"

  4. Set your admin site namesDo this in your project-level urls.py.
    Show the code

    from django.contrib import admin

    admin.site.site_header = "Your Site Name"
    admin.site.site_title = "Your Site Title"
    admin.site.index_title = "Welcome to Your Site"

  5. Collect static files and runThen visit /admin/.
    Show the commands

    python manage.py collectstatic --noinput
    python manage.py runserver

Results

Adminita v-1.0 is available as an open-source package on PyPI and GitHub. It provides  a modern admin interface that improves usability and visual appeal without sacrificing any built-in Django admin functionality.

The theme has been tested across my Django projects including production sites, ensuring compatibility with various model types, inline forms, and custom admin configurations.

Works with

It plays nicely with popular packages like django-tinymce, django-import-export, and django-solo.

As an open-source MIT-licensed project, Adminita is free to use, modify, and extend. Whether you are building a side project or deploying enterprise software, your admin deserves to look as good as your frontend.

Install and setup guide See Adminita live Adminita on GitHub Adminita on PyPI Get Adminita free
Built with

This page was made using Interactive Content Blocks

The key takeaways and the quick start guide on this page come from Interactive Content Blocks: seven ready-made blocks that let readers tick, write, score themselves and keep their progress. One purchase covers every site you own, and your AI assistant writes the blocks from the included skill file.

See Interactive Content Blocks →
Back to Portfolio