https://github.com/app-generator/flask-react-argon-design
React Argon Design - Flask API (free product) | AppSeed
https://github.com/app-generator/flask-react-argon-design
appseed argon-design-system flask-api react
Last synced: 9 months ago
JSON representation
React Argon Design - Flask API (free product) | AppSeed
- Host: GitHub
- URL: https://github.com/app-generator/flask-react-argon-design
- Owner: app-generator
- License: other
- Created: 2023-02-12T16:07:46.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-02-13T08:48:45.000Z (almost 3 years ago)
- Last Synced: 2025-03-11T05:55:50.358Z (9 months ago)
- Topics: appseed, argon-design-system, flask-api, react
- Language: CSS
- Homepage: https://appseed.us/generator/react/argon-design/
- Size: 2.12 MB
- Stars: 4
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# [Flask & React](https://github.com/app-generator/flask-react-argon-design) `Argon Design`
Full-Stack Seed project generated by **[React App Generator](https://appseed.us/generator/react/)** top of **[Argon Design](https://www.creative-tim.com/product/argon-design-system-react?AFFILIATE=128200)** design from `Creative-Tim`.
The backend logic is provided by a simple, `easy-to-extend` **Flask API Server** that manages the Authentication flow (login, registration, logout) using `JSON Web Tokens` (JWT).
- 👉 [React Flask Argon - How to Generate](https://www.youtube.com/watch?v=w52ts92z0_w) - `Video Presentation` (YouTube)
- 🚀 [React Generator for Argon](https://appseed.us/generator/react/argon-design/) - the `free tool` used to build this product
> Features
- ✅ Innovative `Argon Design System` - **Crafted by [Creative-Tim](https://www.creative-tim.com/?AFFILIATE=128200)**
- ✅ React, Redux, Redux-persist
- ✅ Full-stack ready using a simple [Flask API](https://github.com/app-generator/api-server-flask) (`open-source`)
## ✨ `React` Argon Design System
- Design by *[Creative-Tim](https://www.creative-tim.com/?AFFILIATE=128200)*
- Innovative **Argon Kit Design**
- Full-stack ready
- `UI Kit`: 750+ components, `4 Sample Pages`
> `Tests` (compatibility matrix)
| NodeJS | NPM | YARN |
| --- | --- | --- |
| `v14.0.0` | ✅ | ❌ |
| `v15.0.0` | ✅ | ❌ |
| `v16.15.0` | ✅ | ✅ |
## ✨ `Flask API` Features
- Stack: `Flask` / `Flask-RestX` / **SQLite**
- **DB Layer**: `SqlAlchemyORM`, `SQLite` persistence
- **Auth**: JWT tokens managed via `Flask-jwt_extended`
- [API Definition](https://docs.appseed.us/boilerplate-code/api-unified-definition) - the unified API structure implemented by this server
## ✨ How to use it
Being a full-stack product, the backend and the frontend should be compiled and started separately.
Before starting to compile the product, make sure you have the following tools installed in the environment:
- [NodeJS](https://nodejs.org/en/) - version `14.x` or higher
- [GIT](https://git-scm.com/) - used to clone tjhe sources from Github
- [Python3](https://www.python.org/) - used in many tools
### 👉 Start the Frontend
> **Step 1** - Once the project is downloaded, change the directory to `react-ui`.
```bash
$ cd react-ui
```
> **Step 2** - Install dependencies via NPM or yarn
```bash
$ npm i
// OR
$ yarn
```
> **Step 3** - Start in development mode
```bash
$ npm run start
// OR
$ yarn start
```
At this point, the app is available in the browser `localhost:3000` (the default address).
### 👉 Start the Backend Server
> **Step 1** - Change the directory to `api-server-flask`
```bash
$ cd api-server-flask
```
> **Step 2** - Install dependencies using a `virtual environment`
```bash
$ # Virtualenv modules installation (Unix based systems)
$ virtualenv env
$ source env/bin/activate
$
$ # Virtualenv modules installation (Windows based systems)
$ # virtualenv env
$ # .\env\Scripts\activate
$
$ pip install -r requirements.txt
```
> **Step 3** - Setup the `Flask` environment
```bash
$ export FLASK_APP=run.py
$ export FLASK_ENV=development
// OR
$ (Windows CMD) set FLASK_APP=run.py
$ (Windows CMD) set FLASK_ENV=development
$
$ (Powershell) $env:FLASK_APP = ".\run.py"
$ (Powershell) $env:FLASK_ENV = "development"
```
> **Step 4** - Start the API server (development mode)
```bash
$ flask run
```
Use the API via `POSTMAN` or `Swagger Dashboard` at `localhost:5000`.
### 👉 Start API using `Docker`
> **Step 1** - Change the directory to `api-server-flask`
```bash
$ cd api-server-flask
```
> **Step 2** - Start API using `docker-compose` command
```bash
$ docker-compose up --build
```
## 👉 Codebase Structure
```bash
< ROOT >
|
api-server-flask/
├── api
│ ├── config.py
│ ├── __init__.py
│ ├── models.py
│ └── routes.py
├── requirements.txt
├── run.py
└── tests.py
```
## [React Argon Design PRO](https://appseed.us/product/argon-design-system-pro/full-stack/)
> For more components, pages and priority on support, feel free to take a look at this amazing starter:
`Argon Design React PRO` is built with over 100 frontend individual elements, like buttons, inputs, navbars, alerts or cards, giving you the freedom of choosing and combining. The product comes with a simple JWT authentication flow: login/register/logout.
- 👉 [React Argon Design PRO](https://appseed.us/product/argon-design-system-pro/full-stack/) - Product Page
- ✅ `Enhanced UI` - more pages and components
- ✅ `Priority` on support
---
[Flask & React](https://github.com/app-generator/flask-react-argon-design) `Argon Design` - `Full-Stack` Seed project generated by **[AppSeed](https://appseed.us)**.