TwitchChen/flask-gentelella

Gentelella template powered by Flask

Flask Gentelella

Gentelella is a free to use Bootstrap admin template.

This project integrates Gentelella with Flask using:

• Blueprints for scalability.
• flask_login to implement a real login system.
• flask_migrate.

Flask-gentelella also comes with a robust CI/CD pipeline using:

• The Pytest framework for the test suite (see the tests folder).
• Travis CI
• Coverage to measure the code coverage of the tests.
• Selenium to test the application with headless chromium.
• A Dockerfile showing how to containerize the application with gunicorn, and a Docker image available on dockerhub, and integrated to the CI/CD pipeline (see instructions below).

Here is an example of a real project implemented using Flask-Gentelella:

• Online demo
• Source code

This project shows:

• how back-end and front-end can interact responsively with AJAX requests.
• how to implement a graph model with SQLAlchemy and use D3.js for graph visualization.
• how to use Leaflet.js for GIS programming.
• how to use Flask APScheduler to implement crontab-like features.

Installation

(Optional) Set up a virtual environment

1. Get the code

git clone https://github.com/afourmy/flask-gentelella.git
cd flask-gentelella

2. Install requirements

pip install -r requirements.txt

3. Set the FLASK_APP environment variable

(Windows) set FLASK_APP=gentelella.py
(Unix) export FLASK_APP=gentelella.py

4. Run the application

flask run

4. Go the http://127.0.0.1:5000/

5. Create an account and log in

Run Flask Gentelella in a docker container in one command

1. Fetch the image on dockerhub

docker run -d -p 5000:5000 --name gentelella --restart always afourmy/flask-gentelella

2. Go the http://127.0.0.1:5000/

3. Create an account and log in