whsheng / flask-black-dashboard

Flask Dashboard Black - Open-Source Admin Panel | AppSeed

Flask Dashboard Black

Open-Source Admin Dashboard coded in Flask Framework on top of Black Dashboard design. Features:

• SQLite, PostgreSQL, SQLAlchemy ORM
• Alembic (DB schema migrations)
• Modular design with Blueprints
• Session-Based authentication (via flask_login)
• Forms validation
• Deployment scripts: Docker, Gunicorn
• UI Kit: Black Dashboard provided by Creative-Tim

How to use it

$ # Get the code
$ git clone https://github.com/app-generator/flask-black-dashboard.git
$ cd flask-black-dashboard
$
$ # 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 (no PostgreSQL)
$ pip3 install -r requirements-sqlite.txt
$ 
$ # OR with PostgreSQL connector
$ pip install -r requirements.txt
$
$ # Set the FLASK_APP environment variable
$ (Unix/Mac) export FLASK_APP=run.py
$ (Windows) set FLASK_APP=run.py
$ (Powershell) $env:FLASK_APP = ".\run.py"
$
$ # Set up the DEBUG environment
$ # (Unix/Mac) export FLASK_ENV=development
$ # (Windows) set FLASK_ENV=development
$ # (Powershell) $env:FLASK_ENV = "development"
$
$ # Start the application (development mode)
$ # --host=0.0.0.0 - expose the app on all network interfaces (default 127.0.0.1)
$ # --port=5000    - specify the app port (default 5000)  
$ flask run --host=0.0.0.0 --port=5000
$
$ # Access the dashboard in browser: http://127.0.0.1:5000/

Docker execution

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

Get the code

$ git clone https://github.com/app-generator/flask-material-dashboard.git
$ cd flask-material-dashboard

Start the app in Docker

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

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

Credits & Links

• Flask Dashboard Black - Product page
• Flask Framework - Offcial website
• Flask Dashboard - Open-Source Boilerplates - A popular article published on Dev.to platform
• Flask Dashboard - Index provided by Admin-Dashboards.com

License

@MIT

---

Flask Dashboard Black - provided by AppSeed