Sm0ke

Posted on Dec 10, 2022 • Edited on Jan 5 • Originally published at app-generator.dev

Django AdminLTE - PyPi Library

#adminlte #django #opensource

Hello Coders!

This article presents Django AdminLTE, the PyPi integration of this iconic design for Django. AdminLTE maintainers provide the latest stable version, including Dark Mode, widgets, charts, calendar, and Kanban board. The product can be used in any Django project (new or legacy) that needs a modern design with AdminLTE design DNA. Thanks for reading!

👉 Django AdminLTE - Documentation Link
More Django Templates - free & paid starters

What's in the box

This library can be installed and used with minimum effort and configuration. Once installed, the design covers the following:

✅ Admin Section reserved for Django superusers
✅ All Django.contrib.AUTH pages + Registration
✅ Pages for common users: Dashboard, Widgets, Forms

How to use it

As mentioned before, the library can be used in a new Django project or for legacy projects that need a small UI boost in order to look better. In the following section, I will mention the installation steps as listed on the official PyPi Page.

👉 Step #1 - Install the library

$ pip install django-admin-adminlte

👉 Step #2 - Update the INSTALLED_APPS section of the project

    INSTALLED_APPS = (
        ...
        'admin_adminlte.apps.AdminAdminlteConfig',  # <-- NEW
        'django.contrib.admin',
    )

Make sure the AdminLTE line is above django.contrib.admin in order to overwrite the Django defaults.

👉 Step #3 - Update project routing to include the theme URLs

    from django.urls import path, include

    urlpatterns = [
        ...
        path('', include('admin_adminlte.urls')),  # <-- NEW
    ]

👉 Step #4 - Migrate & start the project

$ # Set up the database
$ python manage.py makemigrations
$ python manage.py migrate
$
$ # Create the superuser
$ python manage.py createsuperuser
$
$ # Start the application (development mode)
$ python manage.py runserver # default port 8000

At this point, the AdminLTE styling should cover all sections: authentication, the admin section reserved for superusers, and pages for common users.

Django AdminLTE - Calendar Page

Django AdminLTE Starter

For those who don't have the time or patience to manually configure the project, a playground app is also available with all the above steps already crafted.