Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/app-generator/django-corporate-dashboard

Django Corporate Dashboard - Open-Source Starter | AppSeed
https://github.com/app-generator/django-corporate-dashboard

corporate-admin corporate-dashboard corporate-design corporate-site corporate-ui corporate-website django-corporate django-starter django-template

Last synced: 2 days ago
JSON representation

Django Corporate Dashboard - Open-Source Starter | AppSeed

Awesome Lists containing this project

README

        

# [Django Corporate](https://appseed.us/product/corporate-dashboard/django/)

Open-source **[Django Dashboard](https://appseed.us/admin-dashboards/django/)** project crafted on top of **Corporate UI**, 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, `Corporate Dashboard` is ready to help you create stunning websites and web apps.

- 👉 [Django Corporate](https://django-corporate.onrender.com/) - `LIVE Demo`
- 🛒 [Django Corporate PRO](https://appseed.us/product/corporate-dashboard-pro/django/) - `PRO Version`
- 🚀 Free [Support](https://appseed.us/support/) via Email & `Discord`


> Features:

- ✅ `Up-to-date Dependencies`
- ✅ Theme: [Django Admin Corporate](https://github.com/app-generator/django-admin-corporate), designed by [Creative-Tim](https://www.creative-tim.com/product/corporate-ui-dashboard?AFFILIATE=128200)
- `can be used in any Django project` (new or legacy)
- ✅ **Authentication**: `Django.contrib.AUTH`, Registration
- 🚀 `Deployment`
- `CI/CD` flow via `Render`
- [Django Soft - Go LIVE](https://www.youtube.com/watch?v=1QVdQVSkUCI) - `video presentation`


![Django Corporate Dashboard](https://user-images.githubusercontent.com/51070104/229719846-cfe96c5c-89c2-4ea0-89a9-7be69ebbb228.png)


## Start with `Docker`

> 👉 **Step 1** - Download the code from the GH repository (using `GIT`)

```bash
$ git clone https://github.com/app-generator/django-corporate-dashboard.git
$ cd django-corporate-dashboard
```


> 👉 **Step 2** - Start the APP in `Docker`

```bash
$ chmod +x entrypoint.sh
$ docker-compose up --build
```

Visit `http://localhost:5085` in your browser. The app should be up & running.


## Manual Build

> 👉 Download the code

```bash
$ git clone https://github.com/app-generator/django-corporate-dashboard.git
$ cd django-corporate-dashboard
```


> 👉 Install modules via `VENV`

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


> 👉 Set Up Database

```bash
$ python manage.py makemigrations
$ python manage.py migrate
```


> 👉 Create the Superuser

```bash
$ python manage.py createsuperuser
```


> 👉 Start the app

```bash
$ python manage.py runserver
```

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


## Codebase structure

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

```bash
< 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
| |-- corporate-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.

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

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

```scss
$primary: #774dd3 !default; // EDIT for customization
$secondary: #64748b !default; // EDIT for customization
$info: #55a6f8 !default; // EDIT for customization
$success: #67c23a !default; // EDIT for customization
$warning: #f19937 !default; // EDIT for customization
$danger: #ea4e3d !default; // EDIT for customization
```


## Deploy on [Render](https://render.com/)

- Create a Blueprint instance
- Go to https://dashboard.render.com/blueprints this link.
- 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.


---
[Django Corporate](https://appseed.us/product/corporate-dashboard/django/) - **Django** starter provided by **[AppSeed](https://appseed.us/)**