1
- <p align =" center " >
2
- <a href =" https://github.com/tiangolo/full-stack-fastapi-postgresql/actions?query=workflow%3ATest " target =" _blank " >
3
- <img src="https://github.com/tiangolo/full-stack-fastapi-postgresql/workflows/Test/badge.svg" alt="Test">
4
- </a >
5
- <a href =" https://coverage-badge.samuelcolvin.workers.dev/redirect/tiangolo/full-stack-fastapi-postgresql " target =" _blank " >
6
- <img src="https://coverage-badge.samuelcolvin.workers.dev/tiangolo/full-stack-fastapi-postgresql.svg" alt="Coverage">
7
- </p >
1
+ # Full Stack FastAPI Template
8
2
9
- # FastAPI Project Template
10
-
11
- ## 🚨 Warning: in (re) construction 😎 🏗️
12
-
13
- This project is currently being restructured, don't use it right now, hold for a bit.
14
-
15
- In the next couple of weeks it will be ready. 😎 🚀
16
-
17
- Some of the future new features and changes:
18
-
19
- - [x] Upgrade to the latest FastAPI.
20
- - [x] Migration from SQLAlchemy to SQLModel.
21
- - [x] Upgrade to Pydantic v2.
22
- - [x] Refactor and simplification of most of the code, a lot of the complexity won't be necessary anymore.
23
- - [x] Automatic TypeScript frontend client generated from the FastAPI API (OpenAPI).
24
- - [x] Migrate from Vue.js 2 to React 18 with TypeScript.
25
- - [x] Make the project work as is, allowing to clone and use (not requiring to generate a project with Cookiecutter or Copier)
26
- - [x] Migrate from Cookiecutter to Copier
27
- - [x] Move from Docker Swarm Model to Docker Compose for a simple deployment.
28
- - [x] GitHub Actions for CI.
29
-
30
- ---
31
-
32
- ### Interactive API documentation
33
-
34
- [ ![ API docs] ( img/docs.png )] ( https://github.com/tiangolo/full-stack-fastapi-postgresql )
35
-
36
- ### Dashboard Login
37
-
38
- [ ![ API docs] ( img/login.png )] ( https://github.com/tiangolo/full-stack-fastapi-postgresql )
39
-
40
- ### Dashboard - Admin
41
-
42
- [ ![ API docs] ( img/dashboard.png )] ( https://github.com/tiangolo/full-stack-fastapi-postgresql )
43
-
44
- ### Dashboard - Create User
45
-
46
- [ ![ API docs] ( img/dashboard-create.png )] ( https://github.com/tiangolo/full-stack-fastapi-postgresql )
47
-
48
- ### Dashboard - Items
49
-
50
- [ ![ API docs] ( img/dashboard-items.png )] ( https://github.com/tiangolo/full-stack-fastapi-postgresql )
51
-
52
- ### Dashboard - User Settings
53
-
54
- [ ![ API docs] ( img/dashboard-user-settings.png )] ( https://github.com/tiangolo/full-stack-fastapi-postgresql )
3
+ <a href =" https://github.com/tiangolo/full-stack-fastapi-template/actions?query=workflow%3ATest " target =" _blank " ><img src =" https://github.com/tiangolo/full-stack-fastapi-template/workflows/Test/badge.svg " alt =" Test " ></a >
4
+ <a href =" https://coverage-badge.samuelcolvin.workers.dev/redirect/tiangolo/full-stack-fastapi-template " target =" _blank " ><img src =" https://coverage-badge.samuelcolvin.workers.dev/tiangolo/full-stack-fastapi-template.svg " alt =" Coverage " ></a >
55
5
56
6
## Technology Stack and Features
57
7
@@ -72,6 +22,32 @@ Some of the future new features and changes:
72
22
- 🚢 Deployment instructions using Docker Compose, including how to set up a frontend Traefik proxy to handle automatic HTTPS certificates.
73
23
- 🏭 CI (continuous integration) and CD (continuous deployment) based on GitHub Actions.
74
24
25
+ ### Dashboard Login
26
+
27
+ [ ![ API docs] ( img/login.png )] ( https://github.com/tiangolo/full-stack-fastapi-template )
28
+
29
+ ### Dashboard - Admin
30
+
31
+ [ ![ API docs] ( img/dashboard.png )] ( https://github.com/tiangolo/full-stack-fastapi-template )
32
+
33
+ ### Dashboard - Create User
34
+
35
+ [ ![ API docs] ( img/dashboard-create.png )] ( https://github.com/tiangolo/full-stack-fastapi-template )
36
+
37
+ ### Dashboard - Items
38
+
39
+ [ ![ API docs] ( img/dashboard-items.png )] ( https://github.com/tiangolo/full-stack-fastapi-template )
40
+
41
+ ### Dashboard - User Settings
42
+
43
+ [ ![ API docs] ( img/dashboard-user-settings.png )] ( https://github.com/tiangolo/full-stack-fastapi-template )
44
+
45
+ ### Interactive API documentation
46
+
47
+ [ ![ API docs] ( img/docs.png )] ( https://github.com/tiangolo/full-stack-fastapi-template )
48
+
49
+
50
+
75
51
## How to use it
76
52
77
53
You can ** just fork or clone** this repository and use it as is.
@@ -82,7 +58,11 @@ You can **just fork or clone** this repository and use it as is.
82
58
83
59
You can then update configs in the ` .env ` files to customize your configurations.
84
60
85
- Make sure you at least change the value for ` SECRET_KEY ` in the main ` .env ` file before deploying to production.
61
+ Before deploying it, make sure you change at least the values for:
62
+
63
+ - ` SECRET_KEY `
64
+ - ` FIRST_SUPERUSER_PASSWORD `
65
+ - ` POSTGRES_PASSWORD `
86
66
87
67
### Generate secret keys
88
68
@@ -98,7 +78,7 @@ Copy the content and use that as password / secret key. And run that again to ge
98
78
99
79
## How to use it - alternative with Copier
100
80
101
- This project template also supports generating a new project using [ Copier] ( https://copier.readthedocs.io ) .
81
+ This repository also supports generating a new project using [ Copier] ( https://copier.readthedocs.io ) .
102
82
103
83
It will copy all the files, ask you configuration questions, and update the ` .env ` files with your answers.
104
84
@@ -125,16 +105,16 @@ Decide a name for your new project's directory, you will use it below. For examp
125
105
Go to the directory that will be the parent of your project, and run the command with your project's name:
126
106
127
107
``` bash
128
- copier copy https://github.com/tiangolo/full-stack-fastapi-postgresql my-awesome-project --trust
108
+ copier copy https://github.com/tiangolo/full-stack-fastapi-template my-awesome-project --trust
129
109
```
130
110
131
111
If you have ` pipx ` and you didn't install ` copier ` , you can run it directly:
132
112
133
113
``` bash
134
- pipx run copier copy https://github.com/tiangolo/full-stack-fastapi-postgresql my-awesome-project --trust
114
+ pipx run copier copy https://github.com/tiangolo/full-stack-fastapi-template my-awesome-project --trust
135
115
```
136
116
137
- ** Note** the ` --trust ` option is necessary to be able to execute a [ post-creation script] ( https://github.com/tiangolo/full-stack-fastapi-postgresql /blob/master/.copier/update_dotenv.py ) that updates your ` .env ` files.
117
+ ** Note** the ` --trust ` option is necessary to be able to execute a [ post-creation script] ( https://github.com/tiangolo/full-stack-fastapi-template /blob/master/.copier/update_dotenv.py ) that updates your ` .env ` files.
138
118
139
119
### Input variables
140
120
@@ -156,32 +136,28 @@ The input variables, with their default values (some auto generated) are:
156
136
- ` postgres_password ` : (default: ` "changethis" ` ) The password for the PostgreSQL database, stored in .env, you can generate one with the method above.
157
137
- ` sentry_dsn ` : (default: "") The DSN for Sentry, if you are using it, you can set it later in .env.
158
138
159
- ## Release Notes
160
-
161
- Check the file [ release-notes.md] ( ./release-notes.md ) .
162
-
163
- ## License
164
-
165
- The FastAPI Project Template is licensed under the terms of the MIT license.
166
-
167
- ---
168
-
169
- The documentation below is for ** your own project** , not the Project Template. 👇
170
-
171
139
## Backend Development
172
140
173
- See more instructions specific to backend development in [ backend/README.md] ( ./backend/README.md ) .
141
+ Backend docs: [ backend/README.md] ( ./backend/README.md ) .
174
142
175
143
## Frontend Development
176
144
177
- See more instructions specific to frontend development in [ frontend/README.md] ( ./frontend/README.md ) .
145
+ Frontend docs: [ frontend/README.md] ( ./frontend/README.md ) .
178
146
179
147
## Deployment
180
148
181
- See more instructions specific to deployment in [ deployment.md] ( ./deployment.md ) .
149
+ Deployment docs: [ deployment.md] ( ./deployment.md ) .
182
150
183
151
## Development
184
152
185
- See general development instructions in [ development.md] ( ./development.md ) .
153
+ General development docs: [ development.md] ( ./development.md ) .
186
154
187
155
This includes using Docker Compose, custom local domains, ` .env ` configurations, etc.
156
+
157
+ ## Release Notes
158
+
159
+ Check the file [ release-notes.md] ( ./release-notes.md ) .
160
+
161
+ ## License
162
+
163
+ The Full Stack FastAPI Template is licensed under the terms of the MIT license.
0 commit comments