Skip to main content

Django Material Kit 2 PRO

Premium Django Starter coded on top Material Kit2 PRO Design (Premium BS5 Version).

Django starter styled with Material Kit 2 PRO, a premium Bootstrap 5 KIT from Creative-Tim. The product is designed to deliver the best possible user experience with highly customizable feature-rich pages.

v1.0.1 - release date 2023-01-12

Features

  • Up-to-date Dependencies
  • Design: Django Theme Mkit 2 - PRO Version
  • Sections covered by the design:
    • Authentication: Django.contrib.AUTH, Registration
    • All Pages available in for ordinary users
  • Docker
  • Deployment
    • CI/CD flow via Render

Material Kit2 PRO (BS5) - Starter generated by AppSeed.

✅ Environment

To use the starter, Python3 should be installed properly in the workstation. If you are not sure if Python is installed, please open a terminal and type python --version. Here is the full list with dependencies and tools required to build the app:

  • Python3 - the programming language used to code the app
  • GIT - used to clone the source code from the Github repository
  • Basic development tools (g++ compiler, python development libraries ..etc) used by Python to compile the app dependencies in your environment.
  • (Optional) Docker - a popular virtualization software

✅ Manual Build

👉 Download the code

$ git clone https://github.com/app-generator/django-material-kit2-pro.git
$ cd django-material-kit2-pro

Export GITHUB_TOKEN in the environment. The value is provided by AppSeed during purchase.

This is required because the project has a private REPO dependency: github.com/app-generator/priv-django-theme-mkit2-pro

$ export GITHUB_TOKEN='TOKEN_HERE'  # for Linux, Mac
$ set GITHUB_TOKEN='TOKEN_HERE' # Windows CMD
$ $env:GITHUB_TOKEN = 'TOKEN_HERE' # Windows powerShell

👉 Install modules via VENV.

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

👉 Edit the .env using the template .env.sample.


# True for development, False for production
DEBUG=True

👉 Set Up Database

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

👉 Create the Superuser

$ python manage.py createsuperuser

👉 Start the app

$ python manage.py runserver

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

✅ Manage App Users

By default, the starter is not provided with users. To access the private pages and the admin section (reserved for superusers) follow up the next sections.

👉 Create Superusers

To access the admin section, Django requires superuser privilegies. Let's create a new superuser and access the admin section of the project:

$ python manage.py createsuperuser

Once the superuser is successfully created, we can access the admin section:

http://localhost:8000/admin/

✅ Codebase structure

The project is coded using a simple and intuitive structure presented below:

< PROJECT ROOT >
|
|-- core/
| |-- settings.py # Project Configuration
| |-- urls.py # Project Routing
|
|-- home/
| |-- views.py # APP Views
| |-- urls.py # APP Routing
| |-- models.py # APP Models
| |-- tests.py # 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