https://github.com/creativetimofficial/material-dashboard-django
Material Dashboard - Django Template | Creative-Tim
https://github.com/creativetimofficial/material-dashboard-django
admin-dashboard appseed creative-tim django material-design open-source
Last synced: 30 days ago
JSON representation
Material Dashboard - Django Template | Creative-Tim
- Host: GitHub
- URL: https://github.com/creativetimofficial/material-dashboard-django
- Owner: creativetimofficial
- License: mit
- Created: 2020-07-30T10:31:17.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2025-05-12T08:01:45.000Z (5 months ago)
- Last Synced: 2025-08-30T23:56:20.564Z (about 1 month ago)
- Topics: admin-dashboard, appseed, creative-tim, django, material-design, open-source
- Language: HTML
- Homepage: https://www.creative-tim.com/product/material-dashboard-django
- Size: 23.9 MB
- Stars: 97
- Watchers: 5
- Forks: 410
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# [Material Dashboard Django](https://www.creative-tim.com/product/material-dashboard-django) [](https://twitter.com/home?status=Material%20Dashboard,%20a%20free%20Material%20Bootstrap%204%20Admin%20Template%20%E2%9D%A4%EF%B8%8F%20https%3A//bit.ly/2Lyat1Y%20%23bootstrap%20%23material%20%23design%20%23developers%20%23freebie%20%20via%20%40CreativeTim)
 [](https://github.com/creativetimofficial/material-dashboard-django/issues?q=is%3Aopen+is%3Aissue) [](https://github.com/creativetimofficial/material-dashboard-django/issues?q=is%3Aissue+is%3Aclosed) [](https://gitter.im/creative-tim-general/Lobby) [](https://discord.gg/E4aHAQy)
Open-source **[Django Template](https://www.creative-tim.com/templates/django)** built on top of **Material Dashboard**, a modern Bootstrap 5 design. Start your development with a modern Bootstrap 5 Admin template for Django. Soft UI Dashboard is built with over 70 individual components, giving you the freedom of choosing and combining. If you want to code faster, with a smooth workflow, then you should try this template carefully developed with Django, a well-known Python Framework.
> NOTE: Starter provided in partnership with [App-Generator](https://app-generator.dev/), an open-source platform for developers
## Features:
- Simple, Easy-to-Extend Codebase
- Material Dashboard design Integration
- Bootstrap CSS Styling
- Session-based Authentication, Password recovery
- DB Persistence: SQLite (default), can be used with MySql, PgSql
- Apps:
- [DEMO](https://django-material-dash2.onrender.com/dynamic-dt/product/) **Dynamic DataTables** - generate server-side datatables without coding
- [DEMO](https://django-material-dash2.onrender.com/api/product/) **Dynamic APIs** - Expose secure APIs without coding
- [DEMO](https://django-material-dash2.onrender.com/charts/) **Charts** - powered by ApexCharts
- [Django CLI Package](https://app-generator.dev/docs/developer-tools/django-cli/index.html)
- `Commit/rollback Git Changes`
- `Backup & restore DB`
- `Interact with Django Core`
- `Manage Environment`
- `Manage Dependencies`
- [Deployment](https://app-generator.dev/docs/deployment.html)
- Docker/Docker Compose Scripts
- CI/CD for [Render](https://app-generator.dev/docs/deployment/render/index.html)
- [Vite](https://app-generator.dev/docs/technologies/vite/index.html) for assets management
## Table of Contents
* [Demo](#demo)
* [Quick Start](#quick-start)
* [Documentation](#documentation)
* [File Structure](#file-structure)
* [Browser Support](#browser-support)
* [Resources](#resources)
* [Reporting Issues](#reporting-issues)
* [Technical Support or Questions](#technical-support-or-questions)
* [Licensing](#licensing)
* [Useful Links](#useful-links)
## Demo
> To authenticate use the default credentials or create a new user on the **registration page**.
- **Material Dashboard Django** [Login Page](https://www.creative-tim.com/live/material-dashboard-django)
## Quick start
> 👉 Download the code
```bash
$ git clone https://github.com/creativetimofficial/material-dashboard-django.git
$ cd material-dashboard-django
```
> 👉 Install modules via `VENV`
```bash
$ virtualenv env
$ source env/bin/activate
$ pip install -r requirements.txt
```
> 👉 Set Up Database
```bash
$ python manage.py makemigrations
$ python manage.py migrate
```
> 👉 Create the Superuser
```bash
$ python manage.py createsuperuser
```
> 👉 Start the app
```bash
$ python manage.py runserver
```
At this point, the app runs at `http://127.0.0.1:8000/`.
## Documentation
The documentation for the **Soft UI Dashboard Django** is hosted at our [website](https://app-generator.dev/docs/products/django/soft-ui-dashboard/index.html).
## Codebase structure
The project is coded using a simple and intuitive structure presented below:
```bash
< PROJECT ROOT >
|
|-- config/
| |-- settings.py # Project Configuration
| |-- urls.py # Project Routing
|
|-- apps/
| |-- charts
| |-- dyn_api # APP Routing
| |-- dyn_dt # APP Models
| |-- pages # Tests
|
|-- requirements.txt # Project Dependencies
|
|-- env.sample # ENV Configuration (default values)
|-- manage.py # Start the app - Django default start script
|
|-- ************************************************************************
```
## Deploy on [Render](https://render.com/)
- Create a Blueprint instance
- Go to https://dashboard.render.com/blueprints this link.
- Click `New Blueprint Instance` button.
- Connect your `repo` which you want to deploy.
- Fill the `Service Group Name` and click on `Update Existing Resources` button.
- After that your deployment will start automatically.
At this point, the product should be LIVE.
## Reporting Issues
We use GitHub Issues as the official bug tracker for the **Material Dashboard Django**. Here are some advices for our users that want to report an issue:
1. Make sure that you are using the latest version of the **Material Dashboard Django**. Check the CHANGELOG from your dashboard on our [website](https://www.creative-tim.com/).
2. Providing us reproducible steps for the issue will shorten the time it takes for it to be fixed.
3. Some issues may be browser-specific, so specifying in what browser you encountered the issue might help.
## Support
Being a product that is actively supported and improved, feel free to contact us using these funnels:
- **Creative-Tim** [Discord](https://discord.gg/haJ7ErsNY3) Server - for general product assistance and UI/UX
- **App Generator** [Discord](https://discord.gg/fZC6hup) Server - for **Django specific questions** and assistance.
## Licensing
- Copyright 2019 - present [Creative Tim](https://www.creative-tim.com/)
- Licensed under [Creative Tim EULA](https://www.creative-tim.com/license)
## Useful Links
- [More products](https://www.creative-tim.com/bootstrap-themes) from Creative Tim
- [Tutorials](https://www.youtube.com/channel/UCVyTG4sCw-rOvB9oHkzZD1w)
- [Freebies](https://www.creative-tim.com/bootstrap-themes/free) from Creative Tim
- [Affiliate Program](https://www.creative-tim.com/affiliates/new) (earn money)
## Social Media
- Twitter:
- Facebook:
- Dribbble:
- Instagram:
---
[Material Dashboard Django](https://www.creative-tim.com/product/material-dashboard-django) - Provided by [Creative Tim](https://www.creative-tim.com/) and [App-Generator](https://app-generator.dev/).