Skip to content

Latest commit

 

History

History
173 lines (126 loc) · 5.66 KB

README.md

File metadata and controls

173 lines (126 loc) · 5.66 KB
Raw

Django v5 Soft Dashboard

Open-source Django Dashboard crafted on top of Soft UI Dashboard, an open-source Bootstrap 5 design from Creative-Tim. Designed for those who like bold elements and beautiful websites. Made of hundreds of elements, designed blocks and fully coded pages, Soft UI Dashboard is ready to help you create stunning websites and web apps.


Features:

  • ✅ Up-to-date Dependencies - Django v5.x
  • ✅ Theme: Django Admin Soft, designed by Creative-Tim
    • can be used in any Django project (new or legacy)
  • ✅ Authentication: Django.contrib.AUTH, Registration
  • 🚀 Deployment

Django Admin Soft - Template project for Django provided by AppSeed.


Manual Build

👉 Download the code

$ git clone https://github.com/app-generator/django-v5-soft-dashboard.git
$ cd django-v5-soft-dashboard

👉 Install modules via VENV

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

👉 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/.


Deploy on Render

At this point, the product should be LIVE.


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  
   |     
   |-- templates/
   |    |-- includes/     # UI components 
   |    |-- layouts/      # Masterpages
   |    |-- pages/        # Kit pages 
   |
   |-- static/   
   |    |-- css/                                   # CSS Files 
   |    |-- scss/                                  # SCSS Files 
   |         |-- soft-ui-dashboard/_variables.scss # File Used for Theme Styling
   |
   |-- requirements.txt   # Project Dependencies
   |
   |-- env.sample         # ENV Configuration (default values)
   |-- manage.py          # Start the app - Django default start script
   |
   |-- ************************************************************************

Recompile SCSS

The SCSS/CSS files used to style the Ui are saved in the static directory. In order to update the Ui colors (primary, secondary) this procedure needs to be followed.

$ yarn                                             # install modules
$ vi static/scss/soft-ui-dashboard/_variables.scss # edit variables 
$ gulp                                             # SCSS to CSS translation

The _variables.scss content defines the primary and secondary colors:

$primary:       #cb0c9f !default;   // EDIT for customization 
$secondary:     #8392AB !default;   // EDIT for customization 
$info:          #17c1e8 !default;   // EDIT for customization 
$success:       #82d616 !default;   // EDIT for customization 
$warning:       #fbcf33 !default;   // EDIT for customization 
$danger:        #ea0606 !default;   // EDIT for customization

Django Soft Dashboard PRO

This design is a pixel-perfect Bootstrap 5 Dashboard with a fresh, new design concept. Soft UI Dashboard PRO is built with over 300 frontend individual elements, like buttons, inputs, navbars, nav tabs, cards, or alerts, giving you the freedom of choosing and combining.

Features:

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

Soft UI Dashboard Pro


Django Soft Dashboard - Django starter provided by AppSeed