Skip to content

creativetimofficial/black-dashboard-django

Repository files navigation

version GitHub issues open GitHub issues closed Join the chat at https://gitter.im/NIT-dgp/General Chat

Open-source Django Template crafted on top of Black Dashboard, a popular Bootstrap 4 design. Start your development with a modern, dark-themed Bootstrap 4 Admin template for Django. It features a huge number of components built to fit together and look fantastic. 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, an open-source platform for developers


Features:


Black Dashboard Django - Admin Dashboard coded in Django.


Table of Contents


Demo

To authenticate use the default credentials test / Pass12__ or create a new user on the registration page.


Quick start

UNZIP the sources or clone the repository. After getting the code, open a terminal and navigate to the working directory, with product source code.

$ git clone https://github.com/creativetimofficial/black-dashboard-django.git
$ cd black-dashboard-django

👉 Set Up for Unix, MacOS

Install modules via VENV

$ virtualenv env
$ source env/bin/activate
$ pip3 install -r requirements.txt

Set Up Database

$ python manage.py makemigrations
$ python manage.py migrate

Start the app

$ python manage.py runserver

At this point, the app runs at http://127.0.0.1:8000/.

Note: To use the app, please access the registration page and create a new user. After authentication, the app will unlock the private pages.


Documentation

The documentation for the Black Dashboard Django is hosted at our website.


File Structure

Within the download you'll find the following directories and files:

< 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

  • Create a Blueprint instance
  • 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.


Resources


Reporting Issues

We use GitHub Issues as the official bug tracker for the Black 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 Black Dashboard Django. Check the CHANGELOG from your dashboard on our website.
  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 Server - for general product assistance and UI/UX
  • App Generator Discord Server - for Django specific questions and assistance.

Licensing


Useful Links


Social Media


For more components, pages and priority on support, feel free to take a look at this amazing starter:

Black Dashboard is a premium Bootstrap Template Design now available for download in Django. Made of hundred of elements, designed blocks, and fully coded pages, Black Dashboard PRO is ready to help you create stunning websites and web apps.

  • Simple, Easy-to-Extend Codebase
  • Soft UI Dashboard Design - PRO Version Integration
  • Dynamic DataTables - Generate Data Tables with Django (no coding)
  • Dynamic API - Generate API Endpoints with Django (no coding)
  • Charts via ApexCharts.js
  • Media Files Manager
  • Async Tasks (celery)
  • CLI Tools for Django - migrate DB, manage GIT commits and
  • Session-based Authentication, Password recovery
  • DB Persistence: SQLite (default), can be used with MySql, PgSql
  • Docker
  • CI/CD integration for Render
  • Vite for assets management

Django Black Dashboard PRO - Premium Starter crafted by AppSeed and Creative-Tim.



Black Dashboard Django - Provided by Creative Tim and App-Generator.