DEV Community

Cover image for Django Cookie-Cutter - Material Dashboard
Sm0ke
Sm0ke

Posted on • Edited on • Originally published at blog.appseed.us

Django Cookie-Cutter - Material Dashboard

Hello Coders!

This article explains how to generate a simple Django Dashboard using Cookiecutter, a well-known command-line utility that creates projects from project templates.

The customization process allows choosing the project name, database type, and other related information like project name, version, and support email (if any). For newcomers, Django is a leading web framework created and actively supported by experienced developers using a batteries-included concept.

Thanks for reading! - Content provided by App Generator.



โœจ How it Works

To start fast and generate a new project the workstation should have a minimal toolchain used by the generator: Python3, GIT, and (optional) a modern code editor like VsCode or Atom.

๐Ÿ‘‰ Step #1 - Create a virtual environment for dependencies

$ virtualenv env
$ source env/bin/activate
Enter fullscreen mode Exit fullscreen mode

๐Ÿ‘‰ Step #2 - Install Modules

$ pip install cookiecutter
$ pip install GitPython 
Enter fullscreen mode Exit fullscreen mode

๐Ÿ‘‰ Step #3 - Generate the project

$ cookiecutter https://github.com/app-generator/cookiecutter-django.git
Enter fullscreen mode Exit fullscreen mode

console output

>>> project_name [Django Seed project]: Django Material
>>> project_slug [django_material]:
>>> description [A simple Django project]:
>>> author_name [AppSeed]:
>>> domain_name [example.com]:
>>> email [appseed@example.com]:
>>> version [0.0.1]:
>>> Select theme:
1 - volt
2 - soft-ui
3 - datta-able
4 - material-dashboard
Choose from 1, 2, 3, 4 [1]: 4       <---- SELECT the Material Design
>>> Select database:
1 - sqlite3
2 - mysql
3 - postgresql
Choose from 1, 2, 3 [1]:
>>> database_name [appseed_django]:
>>> database_user [appseed_user]:
>>> database_pass [Pass1234]:
>>> PRE Gen hook executed
 Cloning theme: <material-dashboard>, REPO: https://github.com/app-generator/django-dashboard-material.git
 ...done
>>> POST Gen hook executed
 *** Copy assets
 ...done
 *** Copy templates
 ...done
Enter fullscreen mode Exit fullscreen mode

Once the process is finished, we can change the directory inside the generated sources and use Docker to start the app:

$ cd django_material
$ docker-compose up --build
Enter fullscreen mode Exit fullscreen mode

At this point, the app should be accessible in the browser at the address http://localhost:85.


Django Cookie-Cutter Material - Login Page.


โœจ Django Cookie-Cutter - Dashboard Page

Django Cookie-Cutter Material - Dashboard Page.


โœจ Django Cookie-Cutter - VR page

Django Cookie-Cutter Material - VR Page.


Thanks for reading! For more resources, feel free to access:

Top comments (7)

Collapse
 
uithemes profile image
ui-themes

Any plans to add more UI Kits?

Collapse
 
sm0ke profile image
Sm0ke

Thanks for reading! Yes, AdminLTE and CoreUI are on the list.
๐Ÿš€๐Ÿš€

Collapse
 
uithemes profile image
ui-themes

SB Admin? maybe :)

Thread Thread
 
sm0ke profile image
Sm0ke

๐Ÿš€๐Ÿš€

Collapse
 
crearesite profile image
WebsiteMarket • Edited

Nice work!
Can I customize the models?

Collapse
 
sm0ke profile image
Sm0ke

๐Ÿš€๐Ÿš€ TY!

Collapse
 
sm0ke profile image
Sm0ke

:)