Package: django-admin-material-dashboard
Django Admin MaterialModern template forDjangothat coversAdmin Section, all authentication pages (registration included) crafted on top ofMaterial Dashboard, an open-sourceBootstrap 5design fromCreative-Tim.Actively supported byAppSeedviaEmailandDiscord.Links & ResourcesDjango Admin Material-Product pageFeatures: Fully-configured,CI/CDvia RenderUI Kit:Material Dashboard BS5v3.0.5by Creative-TimSections Covered:Admin Section, reserved forsuperusersAll pagesmanaged byDjango.contrib.AUTHRegistrationpageMisc pages: colors, icons, typography, blank-pageWhyDjango Admin MaterialModernBootstrap 5DesignResponsive InterfaceMinimal TemplateoverridingEasy integrationHow to use itInstall the packageviaPIP$pipinstalldjango-admin-material-dashboard
//OR
$pipinstallgit+https://github.com/app-generator/django-admin-material-dashboard.gitAddadmin_materialapplication to theINSTALLED_APPSsetting of your Django projectsettings.pyfile (note it should be beforedjango.contrib.admin):INSTALLED_APPS=(...'admin_material.apps.AdminMaterialDashboardConfig','django.contrib.admin',)AddLOGIN_REDIRECT_URLandEMAIL_BACKENDof your Django projectsettings.pyfile:LOGIN_REDIRECT_URL='/'# EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'EMAIL_BACKEND='django.core.mail.backends.console.EmailBackend'Addadmin_materialurls in your Django Projecturls.pyfilefromdjango.urlsimportpath,includeurlpatterns=[...path('',include('admin_material.urls')),]Collect staticif you are inproduction environment:$pythonmanage.pycollectstaticStart the app$# Set up the database$pythonmanage.pymakemigrations
$pythonmanage.pymigrate
$
$# Create the superuser$pythonmanage.pycreatesuperuser
$
$# Start the application (development mode)$pythonmanage.pyrunserver# default port 8000Access theadminsection in the browser:http://127.0.0.1:8000/How to CustomizeWhen a template file is loaded,Djangoscans all template directories starting from the ones defined by the user, and returns the first match or an error in case the template is not found.
The theme used to style this starter provides the following files:# This exists in ENV: LIB/admin_material<UI_LIBRARY_ROOT>||--templates/# Root Templates Folder||||--accounts/|||--login.html# Sign IN Page|||--register.html# Sign UP Page||||--includes/|||--footer.html# Footer component|||--sidebar.html# Sidebar component|||--navigation.html# Navigation Bar|||--scripts.html# Scripts Component||||--layouts/|||--base.html# Masterpage|||--base-auth.html# Masterpage for Auth Pages||||--pages/||--index.html# Dashboard Page||--profile.html# Profile Page||--*.html# All other pages||--************************************************************************When the project requires customization, we need to copy the original file that needs an update (from the virtual environment) and place it in the template folder using the same path.For instance, if we want to customize thefooter.htmlthese are the steps:Step 1: create thetemplatesDIRECTORY inside your appStep 2: configure the project to use this new template directoryEditsettings.pyTEMPLATES sectionStep 3: copy thefooter.htmlfrom the original location (inside your ENV) and save it to theYOUR_APP/templatesDIRSource PATH:<YOUR_ENV>/LIB/admin_material/templates/includes/footer.htmlDestination PATH:YOUR_APP/templates/includes/footer.htmlEdit thefooter.html(Destination PATH)At this point, the default version of thefooter.htmlshipped in the library is ignored by Django.In a similar way, all other files and components can be customized easily.CSS StylingThe UI can be customized via the SCSS file. This setup was tested using:Nodev16.15.0Yarn1.22.18GulpCLI version:2.3.0, Local version:4.0.2$cdadmin_material/static
$yarn# Install Modules$viscss/material-dashboard/_variables.scss# Edit primary, secondary colors$gulp# Regenerate CSS filesNOTE, once the CSS files are successfully regenerated, force a hard refresh in the browser (Shift + F5 in Chrome).The relevant lines in_variables.scssare highlighted below:// _variables.scss, LINES 56 -> 63$primary:#e91e63!default;// EDIT & Recompile SCSS$secondary:#7b809a!default;// EDIT & Recompile SCSS$info:#1A73E8!default;// EDIT & Recompile SCSS$success:#4CAF50!default;// EDIT & Recompile SCSS$warning:#fb8c00!default;// EDIT & Recompile SCSS$danger:#F44335!default;// EDIT & Recompile SCSS$light:$gray-200!default;// EDIT & Recompile SCSS$dark:$h-color!default;// EDIT & Recompile SCSSPRO VersionThis design is a pixel-perfectBootstrap 5Dashboard with a fresh, new design inspired by Google's Material Design.Material Dashboard 2 PROis built with over 300 frontend individual elements, like buttons, inputs, navbars, nav tabs, cards, or alerts, giving you the freedom of choosing and combining.Features:Up-to-date DependenciesUI Theme:Material2 PROcan be used in any Django project (new or legacy)Sectionscovered by the design:Admin section(reserved for superusers)Authentication:Django.contrib.AUTH, RegistrationAll Pagesavailable in for ordinary usersDocker,Deployment:CI/CDflow viaRenderDjango Admin Material- Modern Admin Interface provided byAppSeed