Skip to content

Commit 7f29867

Browse files
committed
API Servers - UPD (all products)
1 parent 388e1f0 commit 7f29867

File tree

4 files changed

+165
-68
lines changed

4 files changed

+165
-68
lines changed

docs/boilerplate-code/api-server/api-unified-definition.mdx

Lines changed: 4 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -17,18 +17,10 @@ This page describes the **unified definition** used by all API servers provided
1717
- [API Server Django](django.mdx) - free product
1818
- [API Server Flask](flask.mdx) - free product
1919
- [API Server Node JS](node-js.mdx) - free product
20-
- [API Server Node JS PRO](https://github.com/app-generator/api-server-nodejs-pro) - commercial product
20+
- [API Server Node JS Mongo](https://github.com/app-generator/api-server-nodejs-mongo) - free product
2121

22-
> UI Products aligned to use it:
2322

24-
- [React Berry Dashboard](https://appseed.us/product/berry-dashboard/api-server-nodejs/react/) - free product
25-
- [React Datta Able](https://appseed.us/product/datta-able/api-server-nodejs/react/) - free product
26-
- [React Datta Able PRO](https://appseed.us/product/datta-able-pro/full-stack/react/) - commercial product
27-
:::tip
28-
For more information or support please access the [AppSeed](https://appseed.us) platform or chat directly with support team on [Discord](https://appseed.us/support).
29-
:::
30-
31-
## ✨ API Information
23+
## API Information
3224

3325
> Interface descriptor - [POSTMAN collection format](https://github.com/app-generator/api-unified-definition/blob/main/api.postman_collection.json)
3426
@@ -39,7 +31,8 @@ This page describes the **unified definition** used by all API servers provided
3931
- `/api/users/checkSession`: check an existing JWT Token for validity
4032
- `/api/users/edit` - edit the information associated with a registered user
4133

42-
## ✨ API Samples
34+
35+
## API Samples
4336

4437
> 👉 **Register** - `api/users/register`
4538

docs/boilerplate-code/api-server/django.mdx

Lines changed: 54 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,7 @@ import SubHeading from "@site/src/components/SubHeading";
1111

1212
Simple starter built with Python / Django Rest / Sqlite3 and JWT Auth. The authentication flow is based on **json web tokens**. The product comes with a simple, intuitive codebase, DRF integration, SQLite for persistence JWT Authentication API, Docker, and unitary tests.
1313

14-
:::info Version
15-
16-
[**v1.0.2**](https://github.com/app-generator/api-server-django/releases), release date `2022-06-07`
14+
:::info [**v1.0.6**](https://github.com/app-generator/api-server-django/releases) - release date `Dec 8, 2022`
1715
:::
1816

1917
- [API Definition](api-unified-definition.mdx) - the unified API structure implemented by this server
@@ -22,7 +20,9 @@ Simple starter built with Python / Django Rest / Sqlite3 and JWT Auth. The authe
2220
- [React Berry Dashboard](https://github.com/app-generator/react-berry-admin-template) - open-source sample
2321
- [React Datta Dashboard](https://github.com/app-generator/react-datta-able-dashboard) - open-source sample
2422

25-
> API Methods - for full description please access [API Unified Definition](api-unified-definition.mdx)
23+
<br />
24+
25+
> **API Interface** - for full description please access [API Unified Definition](api-unified-definition.mdx)
2626
2727
- USERS API:
2828
- `/api/users/register`: create a new user
@@ -31,18 +31,20 @@ Simple starter built with Python / Django Rest / Sqlite3 and JWT Auth. The authe
3131
- `/api/users/checkSession`: check an existing JWT Token for validity
3232
- `/api/users/edit` - edit the information associated with a registered user
3333

34-
![Django API Server - Open-source Product.](../../../static/assets/api-cover-django-xs.jpg)
34+
[![Django API - Open-Source Project by AppSeed](https://user-images.githubusercontent.com/51070104/226166757-f0d7ebba-5e08-497b-b96c-b8e520618a85.png)](https://docs.appseed.us/boilerplate-code/api-server/django/)
35+
3536

36-
## Requirements
37+
## Requirements
3738

38-
- **Python3** (Python2 is not supported)
39-
- **Django**==3.2.13
40-
- **djangorestframework**==3.13.1
41-
- **PyJWT**==2.4.0
42-
- **django-cors-headers**==3.13.0
43-
- **gunicorn**==20.1.0 (used by the Docker set up)
39+
- `Python3` (Python2 is not supported)
40+
- `Django`==3.2.13
41+
- `djangorestframework`==3.13.1
42+
- `PyJWT`==2.4.0
43+
- `django-cors-headers`==3.13.0
44+
- `gunicorn`==20.1.0 (used by the Docker set up)
4445

45-
## ✨ How to use the code
46+
47+
## How to use the code
4648

4749
> 👉 **Step 1** - Clone the sources
4850
@@ -73,7 +75,8 @@ $ python manage.py runserver
7375

7476
The API server will start using the default port `8000`.
7577

76-
## **Docker execution**
78+
79+
## **Docker execution**
7780

7881
> 👉 **Step 1** - Get the code
7982
@@ -90,11 +93,43 @@ $ docker-compose up -d --build
9093

9194
Visit `http://localhost:5000` in your browser. The API server will be running
9295

93-
## ✨ Compatible Fullstack Products
9496

95-
The product can be used as a standalone server but also as an authentication server for React, Vue products. Such a product already configured with Django API Server is [**React Datta Able**](https://appseed.us/product/datta-able/api-server-nodejs/react/)**,** an open-source React Dashboard.
97+
## Compatible Fullstack Products
98+
99+
### [React Soft Dashboard](https://github.com/app-generator/react-soft-ui-dashboard)
100+
101+
`React Soft Dashboard` is built with over 70 frontend individual elements, like buttons, inputs, navbars, nav tabs, cards, or alerts, giving you the freedom of choosing and combining.
102+
The product comes with a simple JWT authentication flow: login/register/logout.
103+
The **React** Design is crafted by [Creative-Tim](https://www.creative-tim.com/?AFFILIATE=128200) on top of `MUI` Library.
104+
105+
![React Soft Dashboard](https://user-images.githubusercontent.com/51070104/226167634-88e666e5-025a-4c02-bb2d-21b917b75e9f.png)
106+
107+
<br />
108+
109+
### [React Purity Dashboard](https://github.com/app-generator/react-purity-dashboard)
110+
111+
Start your Development with an Innovative Admin Template for **Chakra UI** and **React**.
112+
113+
- ✅ Innovative Chakra Design - `Designed` by [Creative-Tim](https://www.creative-tim.com/?AFFILIATE=128200)
114+
- ✅ React, Redux, Redux-persist
115+
- ✅ Authentication: JWT Login/Register/Logout
116+
117+
![React Purity Dashboard](https://user-images.githubusercontent.com/51070104/226167639-1d327f61-0e13-4e0d-a8e0-156613cdf0c3.png)
118+
119+
<br />
120+
121+
### [Django React Berry](https://appseed.us/product/berry-dashboard/api-server-django/react/)
122+
123+
`Full-Stack` Seed project generated by [React App Generator](https://appseed.us/generator/react/) top of **[Berry Dashboard](https://appseed.us/product/berry-dashboard/api-server-django/react/)** design.
124+
125+
- 👉 [Django React Berry](https://appseed.us/product/berry-dashboard/api-server-django/react/) - product page
126+
- 👉 [Django React Berry](https://django-react-berry-dashboard.appseed-srv1.com/) - LIVE Demo
127+
128+
![Django React Berry, open-source starter crafted by AppSeed.](https://user-images.githubusercontent.com/51070104/226168312-19a27b20-e6a6-4d6f-9a32-ef066e4202a6.png)
129+
130+
<br />
96131

97-
- [React Datta Able](https://appseed.us/product/datta-able/api-server-nodejs/react/) - product page
98-
- [React Datta Able](https://github.com/app-generator/react-datta-able-dashboard) - source code
132+
## Resources
99133

100-
![React Datta Able - Open-Source Dashboard](../../../static/assets/react-datta-able-cover.jpg)
134+
- 👉 More [Free Starters](https://appseed.us/admin-dashboards/open-source/) - crafted by AppSeed
135+
- 👉 Free [Support](https://appseed.us/support/) via Email & Discord

docs/boilerplate-code/api-server/flask.mdx

Lines changed: 52 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,7 @@ description: Open-source API Server crafted in Flask using JWT Authentication an
1010

1111
Simple [Flask API Boilerplate](https://appseed.us/boilerplate-code/flask-api-boilerplate) enhanced with JWT authentication, SqlAlchemy, **SQLite** persistence and deployment scripts via Docker. It has all the ready-to-use bare minimum essentials.
1212

13-
:::info Version
14-
15-
[**v1.0.2**](https://github.com/app-generator/api-server-flask/releases), release date `2022-06-07`
13+
:::info [**v1.0.7**](https://github.com/app-generator/api-server-flask/releases) - release date `Feb 11, 2023`
1614
:::
1715

1816
- [API Definition](api-unified-definition.mdx) - the unified API structure implemented by this server
@@ -21,7 +19,9 @@ Simple [Flask API Boilerplate](https://appseed.us/boilerplate-code/flask-api-boi
2119
- [React Berry Dashboard](https://github.com/app-generator/react-berry-admin-template) - open-source sample
2220
- [React Datta Dashboard](https://github.com/app-generator/react-datta-able-dashboard) - open-source sample
2321

24-
> API Methods - for full description please access [API Unified Definition](api-unified-definition.mdx)
22+
<br />
23+
24+
> **API Interface** - for full description please access [API Unified Definition](api-unified-definition.mdx)
2525
2626
- USERS API:
2727
- `/api/users/register`: create a new user
@@ -30,17 +30,19 @@ Simple [Flask API Boilerplate](https://appseed.us/boilerplate-code/flask-api-boi
3030
- `/api/users/checkSession`: check an existing JWT Token for validity
3131
- `/api/users/edit` - edit the information associated with a registered user
3232

33-
![Flask API Server - Open-source Product.](../../../static/assets/api-cover-flask-xs.jpg)
33+
[![Flask API - Open-Source Project by AppSeed](https://user-images.githubusercontent.com/51070104/226168494-5a662a13-0e57-47b3-bd99-71d57d243260.png)](https://docs.appseed.us/boilerplate-code/api-server/flask/)
34+
3435

35-
## Requirements
36+
## Requirements
3637

37-
- **Python3** (Python2 is not supported)
38-
- **Flask**==2.1.2
39-
- **flask-restx**==0.5.1
40-
- **Flask-JWT-Extended**==4.4.1
41-
- pytest
38+
- `Python3` (Python2 is not supported)
39+
- `Flask`==2.1.2
40+
- `flask-restx`==0.5.1
41+
- `Flask-JWT-Extended`==4.4.1
42+
- `pytest`
4243

43-
## ✨ Getting Started
44+
45+
## Getting Started
4446

4547
> 👉 **Step 1** - clone the project using GIT
4648
@@ -97,7 +99,8 @@ $ flask run
9799

98100
Visit `http://localhost:5000` in your browser. The API server will be running.
99101

100-
## ✨ Project Structure
102+
103+
## Project Structure
101104

102105
The codebase has a simple, intuitive structure where `run.py` is responsible to bundle and start the API Server using the setup coded by the `api` folder:
103106

@@ -115,11 +118,42 @@ api-server-flask/
115118
└── tests.py
116119
```
117120

118-
## ✨ Compatible Fullstack Products
121+
## Compatible Fullstack Products
122+
123+
### [React Purity Dashboard](https://github.com/app-generator/react-purity-dashboard)
124+
125+
Start your Development with an Innovative Admin Template for **Chakra UI** and **React**.
126+
127+
- ✅ Innovative Chakra Design - `Designed` by [Creative-Tim](https://www.creative-tim.com/?AFFILIATE=128200)
128+
- ✅ React, Redux, Redux-persist
129+
- ✅ Authentication: JWT Login/Register/Logout
130+
131+
![React Purity Dashboard](https://user-images.githubusercontent.com/51070104/226167639-1d327f61-0e13-4e0d-a8e0-156613cdf0c3.png)
132+
133+
<br />
134+
135+
### [Django React Berry](https://appseed.us/product/berry-dashboard/api-server-django/react/)
136+
137+
`Full-Stack` Seed project generated by [React App Generator](https://appseed.us/generator/react/) top of **[Berry Dashboard](https://appseed.us/product/berry-dashboard/api-server-django/react/)** design.
138+
139+
- 👉 [Django React Berry](https://appseed.us/product/berry-dashboard/api-server-django/react/) - product page
140+
- 👉 [Django React Berry](https://django-react-berry-dashboard.appseed-srv1.com/) - LIVE Demo
141+
142+
![Django React Berry, open-source starter crafted by AppSeed.](https://user-images.githubusercontent.com/51070104/226168312-19a27b20-e6a6-4d6f-9a32-ef066e4202a6.png)
143+
144+
<br />
145+
146+
### [React Soft Dashboard](https://github.com/app-generator/react-soft-ui-dashboard)
147+
148+
`React Soft Dashboard` is built with over 70 frontend individual elements, like buttons, inputs, navbars, nav tabs, cards, or alerts, giving you the freedom of choosing and combining.
149+
The product comes with a simple JWT authentication flow: login/register/logout.
150+
The **React** Design is crafted by [Creative-Tim](https://www.creative-tim.com/?AFFILIATE=128200) on top of `MUI` Library.
151+
152+
![React Soft Dashboard](https://user-images.githubusercontent.com/51070104/226167634-88e666e5-025a-4c02-bb2d-21b917b75e9f.png)
119153

120-
The product can be used as a standalone server but also as an authentication server for React, Vue products. Such a product already configured with Django API Server is [**React Datta Able**](https://appseed.us/product/datta-able/api-server-nodejs/react/)**,** an open-source React Dashboard.
154+
<br />
121155

122-
- [React Datta Able](https://appseed.us/product/datta-able/api-server-nodejs/react/) - product page
123-
- 👉 ​[React Datta Able](https://github.com/app-generator/react-datta-able-dashboard) - source code
156+
## Resources
124157

125-
![React Datta Able - Open-Source Dashboard.](https://gblobscdn.gitbook.com/assets%2F-MYVW6MKCi9iujNc3SK_%2F-Memyr3wdOIsonokJPUQ%2F-Men-RiulajMsyVGTEgy%2Freact-datta-able-cover.jpg?alt=media&token=c87fbe5e-44b0-4d3d-9bb3-c41495fbb567)
158+
- 👉 More [Free Starters](https://appseed.us/admin-dashboards/open-source/) - crafted by AppSeed
159+
- 👉 Free [Support](https://appseed.us/support/) via Email & Discord

docs/boilerplate-code/api-server/node-js.mdx

Lines changed: 55 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,7 @@ description: >-
1111

1212
Free API Server coded on top of Express / Node JS with **SQLite** persistence and JWT authentication via Passport library - `passport-jwt` strategy.
1313

14-
:::info Version
15-
16-
[**v1.0.1**](https://github.com/app-generator/api-server-nodejs/releases), release date `2022-06-02`
14+
:::info [**v1.0.6**](https://github.com/app-generator/api-server-nodejs/releases) - release date `Dec 2, 2022`
1715
:::
1816

1917
- [API Definition](api-unified-definition.mdx) - the unified API structure implemented by this server
@@ -22,7 +20,9 @@ Free API Server coded on top of Express / Node JS with **SQLite** persistence an
2220
- [React Berry Dashboard](https://github.com/app-generator/react-berry-admin-template) - open-source sample
2321
- [React Datta Dashboard](https://github.com/app-generator/react-datta-able-dashboard) - open-source sample
2422

25-
> API Methods - for full description please access [API Unified Definition](api-unified-definition.mdx)
23+
<br />
24+
25+
> **API Interface** - for full description please access [API Unified Definition](api-unified-definition.mdx)
2626
2727
- USERS API:
2828
- `/api/users/register`: create a new user
@@ -31,17 +31,19 @@ Free API Server coded on top of Express / Node JS with **SQLite** persistence an
3131
- `/api/users/checkSession`: check an existing JWT Token for validity
3232
- `/api/users/edit` - edit the information associated with a registered user
3333

34-
![Node JS API Server - Open-source Product.](../../../static/assets/api-cover-nodejs-xs.jpg)
34+
[![Node API - Open-Source Project by AppSeed](https://user-images.githubusercontent.com/51070104/226168670-14e5b0fd-cf07-4209-ab19-016414b61bdc.png)](https://docs.appseed.us/boilerplate-code/api-server/node-js/)
35+
3536

36-
## ✨ Tests Matrix
37+
> Tested with:
3738
38-
| NodeJS | NPM | YARN | Status |
39-
| ---------- | --------- | ---------- | ------ |
40-
| `v17.0.0` | `v8.11.0` | `v1.22.18` | ✔️ |
41-
| `v16.15.1` | `v8.11.0` | `v1.22.18` | ✔️ |
42-
| `v16.13.0` | `v8.1.0` | `v1.22.5` | ✔️ |
39+
| NodeJS | NPM | YARN |
40+
| --- | --- | --- |
41+
| `v18.0.0` | | |
42+
| `v16.10.0` | | |
43+
| `v14.15.0` | ||
4344

44-
## ✨ How to use the code
45+
46+
## How to use the code
4547

4648
> 👉 **Step 1** - Clone the sources
4749
@@ -88,9 +90,10 @@ $ npm start
8890
$ yarn start
8991
```
9092

91-
The API server will start using the `PORT` specified in `.env` file (default 5000)\\
93+
The API server will start using the `PORT` specified in `.env` file (default 5000)
94+
9295

93-
## Codebase Structure
96+
## Codebase Structure
9497

9598
```
9699
< ROOT / src >
@@ -116,7 +119,8 @@ The API server will start using the `PORT` specified in `.env` file (default 500
116119
|-- ************************************************************************
117120
```
118121

119-
### ✨ SQLite Path
122+
123+
### SQLite Path
120124

121125
The SQLite Path is set in `.env`, as `SQLITE_PATH`
122126

@@ -134,11 +138,42 @@ $ yarn typeorm migration:generate -n your_migration_name
134138
$ yarn typeorm migration:run
135139
```
136140

137-
## ✨ Compatible Fullstack Products
141+
## Compatible Fullstack Products
142+
143+
### [React Soft Dashboard](https://github.com/app-generator/react-soft-ui-dashboard)
144+
145+
`React Soft Dashboard` is built with over 70 frontend individual elements, like buttons, inputs, navbars, nav tabs, cards, or alerts, giving you the freedom of choosing and combining.
146+
The product comes with a simple JWT authentication flow: login/register/logout.
147+
The **React** Design is crafted by [Creative-Tim](https://www.creative-tim.com/?AFFILIATE=128200) on top of `MUI` Library.
148+
149+
![React Soft Dashboard](https://user-images.githubusercontent.com/51070104/226167634-88e666e5-025a-4c02-bb2d-21b917b75e9f.png)
150+
151+
<br />
152+
153+
### [React Purity Dashboard](https://github.com/app-generator/react-purity-dashboard)
154+
155+
Start your Development with an Innovative Admin Template for **Chakra UI** and **React**.
156+
157+
- ✅ Innovative Chakra Design - `Designed` by [Creative-Tim](https://www.creative-tim.com/?AFFILIATE=128200)
158+
- ✅ React, Redux, Redux-persist
159+
- ✅ Authentication: JWT Login/Register/Logout
160+
161+
![React Purity Dashboard](https://user-images.githubusercontent.com/51070104/226167639-1d327f61-0e13-4e0d-a8e0-156613cdf0c3.png)
162+
163+
<br />
164+
165+
### [Django React Berry](https://appseed.us/product/berry-dashboard/api-server-django/react/)
166+
167+
`Full-Stack` Seed project generated by [React App Generator](https://appseed.us/generator/react/) top of **[Berry Dashboard](https://appseed.us/product/berry-dashboard/api-server-django/react/)** design.
168+
169+
- 👉 [Django React Berry](https://appseed.us/product/berry-dashboard/api-server-django/react/) - product page
170+
- 👉 [Django React Berry](https://django-react-berry-dashboard.appseed-srv1.com/) - LIVE Demo
171+
172+
![Django React Berry, open-source starter crafted by AppSeed.](https://user-images.githubusercontent.com/51070104/226168312-19a27b20-e6a6-4d6f-9a32-ef066e4202a6.png)
138173

139-
The product can be used as a standalone server but also as an authentication server for React, Vue products. Such a product already configured with Django API Server is [**React Datta Able**](https://appseed.us/product/datta-able/api-server-nodejs/react/)**,** an open-source React Dashboard.
174+
<br />
140175

141-
- [React Datta Able](https://appseed.us/product/datta-able/api-server-nodejs/react/) - product page
142-
-[React Datta Able](https://github.com/app-generator/react-datta-able-dashboard) - source code
176+
## Resources
143177

144-
![React Datta Able - Open-Source Dashboard.](https://gblobscdn.gitbook.com/assets%2F-MYVW6MKCi9iujNc3SK_%2F-Memyr3wdOIsonokJPUQ%2F-Men-RiulajMsyVGTEgy%2Freact-datta-able-cover.jpg?alt=media&token=c87fbe5e-44b0-4d3d-9bb3-c41495fbb567)
178+
- 👉 More [Free Starters](https://appseed.us/admin-dashboards/open-source/) - crafted by AppSeed
179+
- 👉 Free [Support](https://appseed.us/support/) via Email & Discord

0 commit comments

Comments
 (0)