Skip to content

Commit b32dea3

Browse files
authored
🚚 Rename project to Full Stack FastAPI Template (fastapi#699)
1 parent 964e605 commit b32dea3

File tree

5 files changed

+228
-252
lines changed

5 files changed

+228
-252
lines changed

.env

+2-2
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,8 @@ DOMAIN=localhost
55
# Environment: local, staging, production
66
ENVIRONMENT=local
77

8-
PROJECT_NAME="FastAPI Project"
9-
STACK_NAME=fastapi-project
8+
PROJECT_NAME="Full Stack FastAPI Project"
9+
STACK_NAME=full-stack-fastapi-project
1010

1111
# Backend
1212
BACKEND_CORS_ORIGINS="http://localhost,http://localhost:5173,https://localhost,https://localhost:5173,http://localhost.tiangolo.com"

README.md

+50-74
Original file line numberDiff line numberDiff line change
@@ -1,57 +1,7 @@
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
82

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>
555

566
## Technology Stack and Features
577

@@ -72,6 +22,32 @@ Some of the future new features and changes:
7222
- 🚢 Deployment instructions using Docker Compose, including how to set up a frontend Traefik proxy to handle automatic HTTPS certificates.
7323
- 🏭 CI (continuous integration) and CD (continuous deployment) based on GitHub Actions.
7424

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+
7551
## How to use it
7652

7753
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.
8258

8359
You can then update configs in the `.env` files to customize your configurations.
8460

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`
8666

8767
### Generate secret keys
8868

@@ -98,7 +78,7 @@ Copy the content and use that as password / secret key. And run that again to ge
9878

9979
## How to use it - alternative with Copier
10080

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).
10282

10383
It will copy all the files, ask you configuration questions, and update the `.env` files with your answers.
10484

@@ -125,16 +105,16 @@ Decide a name for your new project's directory, you will use it below. For examp
125105
Go to the directory that will be the parent of your project, and run the command with your project's name:
126106

127107
```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
129109
```
130110

131111
If you have `pipx` and you didn't install `copier`, you can run it directly:
132112

133113
```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
135115
```
136116

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.
138118

139119
### Input variables
140120

@@ -156,32 +136,28 @@ The input variables, with their default values (some auto generated) are:
156136
- `postgres_password`: (default: `"changethis"`) The password for the PostgreSQL database, stored in .env, you can generate one with the method above.
157137
- `sentry_dsn`: (default: "") The DSN for Sentry, if you are using it, you can set it later in .env.
158138

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-
171139
## Backend Development
172140

173-
See more instructions specific to backend development in [backend/README.md](./backend/README.md).
141+
Backend docs: [backend/README.md](./backend/README.md).
174142

175143
## Frontend Development
176144

177-
See more instructions specific to frontend development in [frontend/README.md](./frontend/README.md).
145+
Frontend docs: [frontend/README.md](./frontend/README.md).
178146

179147
## Deployment
180148

181-
See more instructions specific to deployment in [deployment.md](./deployment.md).
149+
Deployment docs: [deployment.md](./deployment.md).
182150

183151
## Development
184152

185-
See general development instructions in [development.md](./development.md).
153+
General development docs: [development.md](./development.md).
186154

187155
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.

backend/app/core/db.py

+1-1
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
99

1010
# make sure all SQLModel models are imported (app.models) before initializing DB
1111
# otherwise, SQLModel might fail to initialize relationships properly
12-
# for more details: https://github.com/tiangolo/full-stack-fastapi-postgresql/issues/28
12+
# for more details: https://github.com/tiangolo/full-stack-fastapi-template/issues/28
1313

1414

1515
def init_db(session: Session) -> None:

frontend/index.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<meta charset="UTF-8" />
55
<link rel="icon" type="image/svg+xml" href="/vite.svg" />
66
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
7-
<title>Full Stack Project Generator</title>
7+
<title>Full Stack FastAPI Project</title>
88
<link rel="icon" type="image/x-icon" href="./src/assets/images/favicon.png" />
99
</head>
1010
<body>

0 commit comments

Comments
 (0)