/django-dashboard-black

Django Dashboard Dark - Open-Source Admin Panel | AppSeed

Primary LanguageCSSMIT LicenseMIT

Open-Source Admin Dashboard coded in Django Framework - Provided by AppSeed Web App Generator.

Dashboard Features

  • SQLite, Django native ORM
  • Modular design
  • Session-Based authentication (login, register)
  • Forms validation
  • UI Kit: Black Dashboard (Free Version) by Creative-Tim

Deployment Scripts

  • Heroku - Cloud Application Platform
  • Docker - execute the app using a sandboxed container
  • Gunicorn / Nginx - a common used configuration for Django Apps
  • Waitress - Gunicorn equivalent for Windows.

Web App Links


Want more? Go PRO!

PRO versions include Premium UI Kits, Lifetime updates and 24/7 LIVE Support (via Discord)

Django Dashboard Material PRO Django Dashboard Black PRO Django Dashboard Dashkit PRO
Django Dashboard Material PRO Django Dashboard Black PRO Django Dashboard Dashkit PRO


Django Dashboard Black - Open-Source Web App.


How to use it

$ # Get the code
$ git clone https://github.com/app-generator/django-dashboard-black.git
$ cd django-dashboard-black
$
$ # Virtualenv modules installation (Unix based systems)
$ virtualenv --no-site-packages env
$ source env/bin/activate
$
$ # Virtualenv modules installation (Windows based systems)
$ # virtualenv --no-site-packages env
$ # .\env\Scripts\activate
$ 
$ # Install modules
$ # SQLIte version
$ pip3 install -r requirements.txt
$
$ # Create tables
$ python manage.py makemigrations
$ python manage.py migrate
$
$ # Start the application (development mode)
$ python manage.py runserver # default port 8000
$
$ # Start the app - custom port 
$ # python manage.py runserver 0.0.0.0:<your_port>
$
$ # Access the web app in browser: http://127.0.0.1:8000/

Deployment

The app is provided with a basic configuration to be executed in Heroku, Docker, Gunicorn, and Waitress.

Heroku platform

$ # Get the code
$ git clone https://github.com/app-generator/django-dashboard-black.git
$ cd django-dashboard-black
$
$ # Heroku Login
$ heroku login
$
$ # Create the app in Heroku platform
$ heroku create # a random name will be generated by Heroku
$
$ # Disable collect static 
$ heroku config:set DISABLE_COLLECTSTATIC=1
$
$ # Push the source code and trigger the deploy
$ git push heroku master
$
$ # Execute DBSchema Migration
$ heroku run python manage.py makemigrations
$ heroku run python manage.py migrate
$
$ # Visit the deployed app in browser.
$ heroku open
$
$ # Create a superuser
$ heroku run python manage.py createsuperuser

Docker execution


The application can be easily executed in a docker container. The steps:

Get the code

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

Start the app in Docker

$ sudo docker-compose pull && sudo docker-compose build && sudo docker-compose up -d

Visit http://localhost:5005 in your browser. The app should be up & running.



Gunicorn 'Green Unicorn' is a Python WSGI HTTP Server for UNIX.

Install using pip

$ pip install gunicorn

Start the app using gunicorn binary

$ gunicorn --bind=0.0.0.0:8001 core.wsgi:application
Serving on http://localhost:8001

Visit http://localhost:8001 in your browser. The app should be up & running.



Waitress (Gunicorn equivalent for Windows) is meant to be a production-quality pure-Python WSGI server with very acceptable performance. It has no dependencies except ones that live in the Python standard library.

Install using pip

$ pip install waitress

Start the app using waitress-serve

$ waitress-serve --port=8001 core.wsgi:application
Serving on http://localhost:8001

Visit http://localhost:8001 in your browser. The app should be up & running.


Support

  • Free support via eMail < support @ appseed.us > and Github issues tracker
  • 24/7 Live Support via Discord for paid plans and commercial products.

Credits


License

@MIT



Django Dashboard Black - Provided by AppSeed Web App Generator.