Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/app-generator/flask-v3-volt-dashboard

Flask v3 - Volt Dashboard (Free Sample) | AppSeed
https://github.com/app-generator/flask-v3-volt-dashboard

flask flask-bootstrap flask-bs5 flask-v3 flask-v3-sample flask-v3-template flask-volt flask3-sample flask3-template

Last synced: 10 days ago
JSON representation

Flask v3 - Volt Dashboard (Free Sample) | AppSeed

Awesome Lists containing this project

README

        

# Flask v3 `Volt Dashboard`

Open-source **Flask/Jinja Template** provided by `AppSeed` on top of **Volt Dashboard**, a modern `Bootstrap 5` dashboard design.

The project is a super simple Flask project WITHOUT database, ORM, or any other hard dependency - Design from **Themesberg**.

> Features

- ✅ `Up-to-date dependencies` using a **Flask v3.0.0** compatible stack
- ✅ Render Engine: Flask / [Jinja2](https://jinja.palletsprojects.com/)
- ✅ **UI Kit**: Volt Dashboard by Themesberg
- ✅ `Docker`
- ✅ `CI/CD` via Render

![Volt Dashboard - Full-Stack Starter generated by AppSeed.](https://user-images.githubusercontent.com/51070104/168843604-b026fd94-5969-4be7-81ac-5887cf0958e5.png)


## Start with `Docker`

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

```bash
$ git clone https://github.com/app-generator/flask-v3-volt-dashboard.git
$ cd flask-v3-volt-dashboard
```


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

```bash
$ 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/flask-v3-volt-dashboard.git
$ cd flask-v3-volt-dashboard
```


### 👉 Set Up for `Unix`, `MacOS`

> Install modules via `VENV`

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


> Set Up Flask Environment

```bash
$ export FLASK_APP=run.py
$ export FLASK_ENV=development
```


> Start the app

```bash
$ flask run
```

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


### 👉 Set Up for `Windows`

> Install modules via `VENV` (windows)

```
$ virtualenv env
$ .\env\Scripts\activate
$ pip3 install -r requirements.txt
```


> Set Up Flask Environment

```bash
$ # CMD
$ set FLASK_APP=run.py
$ set FLASK_ENV=development
$
$ # Powershell
$ $env:FLASK_APP = ".\run.py"
$ $env:FLASK_ENV = "development"
```


> Start the app

```bash
$ flask run
```

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


## Codebase Structure

The project has a simple, intuitive structure presented bellow:

```bash
< PROJECT ROOT >
|
|-- apps/__init__.py
|-- apps/
| |-- static/
| | |-- # CSS files, Javascripts files
| |
| |-- templates/
| |
| |-- includes/ # Page chunks, components
| | |
| | |-- navigation.html # Top bar
| | |-- sidebar.html # Left sidebar
| | |-- scripts.html # JS scripts common to all pages
| | |-- footer.html # The common footer
| |
| |-- layouts/ # App Layouts (the master pages)
| | |
| | |-- base.html # Used by common pages like index, UI
| | |-- base-fullscreen.html # Used by auth pages (login, register)
| |
| index.html # The default page
| page-404.html # Error 404 page (page not found)
| page-500.html # Error 500 page (server error)
| *.html # All other pages provided by the UI Kit
|
|-- requirements.txt
|
|-- run.py
|
|-- ************************************************************************
```


## [Flask Soft Dashboard](https://appseed.us/product/soft-ui-dashboard-pro/flask/) `PRO`

> For more components, pages and priority on support, feel free to take a look at this starter:

Volt Pro is a premium Bootstrap 5 Admin Dashboard featuring over 800 components, 20 example pages and 10 fully customized plugin written in Vanilla Javascript.

- 👉 [Flask Volt PRO](https://appseed.us/product/volt-dashboard-pro/flask/) - product page
- 👉 [Flask Volt PRO](https://flask-volt-pro.appseed-srv1.com/) - LIVE deployment

![Flask Volt PRO - Premium Starter.](https://user-images.githubusercontent.com/51070104/167878207-37758fbf-fbea-4140-9232-d5bf0c6a1fe8.jpg)


---
Volt Dashboard - Open-source Flask v3 starter provided by **[AppSeed](https://appseed.us/)**.