Gradient Able PRO#
Open-Source Django Template built with a minimum set of features on top of Gradient Able, a modern dashboard design from CodedThemes. This template can be used to start a new project quickly by adding new features on top of the existing ones or simply for learning purposes.
👉 Gradient Able Django PRO - Product page
👉 Gradient Able Django PRO - LIVE demo
Features#
Up-to-date dependencies
Database: SQLite (default), PgSQL, MySql
Authentication - Session-Based authentication - Social Login: Github
User Extended profile
API via DRF
Celery (Async Tasks)
File Manager
Docker
Automated e2e Tests - reports generated in HTML and Video format
Prerequisites#
A few tools need to be installed in the system to use the starter efficiently:
Download Sources#
The product can be downloaded from the official page - requires a purchase
Product Page - requires authentication
Once the download is complete, the project can be opened in VsCode.
$ unzip django-gradient-able-pro.zip
$ cd django-gradient-able-pro
Start in Docker#
Te fastest way to see the product running in the browser is to start Django Gradient Able in Docker:
docker-compose up --build
If Docker is properly installed in the system, you can visit the browser at http://localhost:5085. Gradient Able should be up and running.
Manual Build#
This section presents all steps to start Django Gradient Able manually.
virtualenv env # Create a Virtual Environment
source env/bin/activate # Activate the environment
pip install -r requirements.txt # Install modules
python manage.py makemigrations # Migrate DataBase (generate tables)
python manage.py migrate # Apply Changes on Database
The project environment and database are ready to be used. The last thing is to start the application:
python manage.py runserver # Starts on default PORT 8000
python manage.py runserver 8999 # Starts on PORT 8999 (custom port)
By default Django starts on port 8000 but this can be easily changed by adding the PORT number as argument. At this point, the app runs at http://127.0.0.1:8000/
Codebase#
The project is coded using a simple and intuitive structure presented below:
Core: holds the project settings
Home: the application that integrates the Gradient Able Design
Api: the generated API
< PROJECT ROOT >
|
|-- core/ # Implements app configuration
| |-- settings.py # Defines Global Settings
| |-- wsgi.py # Start the app in production
| |-- urls.py # Define URLs served by all apps/nodes
|
|-- home/ # Serves all pages from the UI Kit
|
|-- apps/
| |
| |-- common/ # Assets used by all APPS (models, helpers)
| |-- users/ # Handles Auth Flow
| |-- api/ # DRF API
| |-- charts/ # Charts APP
| |-- tables/ # DataTables APP
| |-- tasks/ # Celery App
|
|-- templates/ # Pages & Templates
|-- assets/ # Static Assets [ JS, CSS, images ]
|
|-- requirements.txt # Development modules - SQLite storage
|
|-- .env # Environment
|-- env.sample # Environment Sample
|
|-- manage.py # Django Manager File
|
|-- ************************************************************************
Create Users#
By default, the app redirects guest users to authenticate. In order to access the private pages, follow this set up:
Start the app
Access the registration page and create a new user: - http://127.0.0.1:8000/register/
Access the sign in page and authenticate - http://127.0.0.1:8000/login/
Start Celery (async tasks)#
Make sure you have a Redis Server running: redis://localhost:6379 - $ redis-cli and type ping
In the base directory inside tasks_scripts folder you need to write your scripts file.
Run the celery command from the CLI.
export DJANGO_SETTINGS_MODULE="core.settings"
celery -A apps.tasks worker -l info -B
You will see a new route Apps -> Tasks in the sidebar.
You can start and cancel any task from the UI.