Ecosyste.ms: Awesome

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

https://github.com/tiangolo/full-stack-fastapi-template

Full stack, modern web application template. Using FastAPI, React, SQLModel, PostgreSQL, Docker, GitHub Actions, automatic HTTPS and more.
https://github.com/tiangolo/full-stack-fastapi-template

backend chakra-ui docker fastapi frontend json json-schema jwt letsencrypt openapi postgresql python react sqlmodel swagger tanstack-query tanstack-router traefik typescript

Last synced: 3 months ago
JSON representation

Full stack, modern web application template. Using FastAPI, React, SQLModel, PostgreSQL, Docker, GitHub Actions, automatic HTTPS and more.

Lists

README 

        
# Full Stack FastAPI Template



Test

Coverage



### Dashboard - Dark Mode



[![API docs](img/dashboard-dark.png)](https://github.com/tiangolo/full-stack-fastapi-postgresql)



## Technology Stack and Features



- ⚡ [**FastAPI**](https://fastapi.tiangolo.com) for the Python backend API.

    - 🧰 [SQLModel](https://sqlmodel.tiangolo.com) for the Python SQL database interactions (ORM).

    - 🔍 [Pydantic](https://docs.pydantic.dev), used by FastAPI, for the data validation and settings management.

    - 💾 [PostgreSQL](https://www.postgresql.org) as the SQL database.

- 🚀 [React](https://react.dev) for the frontend.

    - 💃 Using TypeScript, hooks, Vite, and other parts of a modern frontend stack.

    - 🎨 [Chakra UI](https://chakra-ui.com) for the frontend components.

    - 🤖 An automatically generated frontend client.

    - 🦇 Dark mode support.

- 🐋 [Docker Compose](https://www.docker.com) for development and production.

- 🔒 Secure password hashing by default.

- 🔑 JWT token authentication.

- 📫 Email based password recovery.

- ✅ Tests with [Pytest](https://pytest.org).

- 📞 [Traefik](https://traefik.io) as a reverse proxy / load balancer.

- 🚢 Deployment instructions using Docker Compose, including how to set up a frontend Traefik proxy to handle automatic HTTPS certificates.

- 🏭 CI (continuous integration) and CD (continuous deployment) based on GitHub Actions.



### Dashboard Login



[![API docs](img/login.png)](https://github.com/tiangolo/full-stack-fastapi-template)



### Dashboard - Admin



[![API docs](img/dashboard.png)](https://github.com/tiangolo/full-stack-fastapi-template)



### Dashboard - Create User



[![API docs](img/dashboard-create.png)](https://github.com/tiangolo/full-stack-fastapi-template)



### Dashboard - Items



[![API docs](img/dashboard-items.png)](https://github.com/tiangolo/full-stack-fastapi-template)



### Dashboard - User Settings



[![API docs](img/dashboard-user-settings.png)](https://github.com/tiangolo/full-stack-fastapi-template)



### Interactive API documentation



[![API docs](img/docs.png)](https://github.com/tiangolo/full-stack-fastapi-template)



## How to use it



You can **just fork or clone** this repository and use it as is.



✨ It just works. ✨



### Configure



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



Before deploying it, make sure you change at least the values for:



- `SECRET_KEY`

- `FIRST_SUPERUSER_PASSWORD`

- `POSTGRES_PASSWORD`



### Generate secret keys



Some environment variables in the `.env` file have a default value of `changethis`.



You have to change them with a secret key, to generate secret keys you can run the following command:



```bash

python -c "import secrets; print(secrets.token_urlsafe(32))"

```



Copy the content and use that as password / secret key. And run that again to generate another secure key.



## How to use it - alternative with Copier



This repository also supports generating a new project using [Copier](https://copier.readthedocs.io).



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



### Install Copier



You can install Copier with:



```bash

pip install copier

```



Or better, if you have [`pipx`](https://pipx.pypa.io/), you can run it with:



```bash

pipx install copier

```



**Note**: If you have `pipx`, installing copier is optional, you could run it directly.



### Generate a Project with Copier



Decide a name for your new project's directory, you will use it below. For example, `my-awesome-project`.



Go to the directory that will be the parent of your project, and run the command with your project's name:



```bash

copier copy https://github.com/tiangolo/full-stack-fastapi-template my-awesome-project --trust

```



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



```bash

pipx run copier copy https://github.com/tiangolo/full-stack-fastapi-template my-awesome-project --trust

```



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



### Input variables



Copier will ask you for some data, you might want to have at hand before generating the project.



But don't worry, you can just update any of that in the `.env` files afterwards.



The input variables, with their default values (some auto generated) are:



- `project_name`: (default: `"FastAPI Project"`) The name of the project, shown to API users (in .env).

- `stack_name`: (default: `"fastapi-project"`) The name of the stack used for Docker Compose labels (no spaces) (in .env).

- `secret_key`: (default: `"changethis"`) The secret key for the project, used for security, stored in .env, you can generate one with the method above.

- `first_superuser`: (default: `"[email protected]"`) The email of the first superuser (in .env).

- `first_superuser_password`: (default: `"changethis"`) The password of the first superuser (in .env).

- `smtp_host`: (default: "") The SMTP server host to send emails, you can set it later in .env.

- `smtp_user`: (default: "") The SMTP server user to send emails, you can set it later in .env.

- `smtp_password`: (default: "") The SMTP server password to send emails, you can set it later in .env.

- `emails_from_email`: (default: `"[email protected]"`) The email account to send emails from, you can set it later in .env.

- `postgres_password`: (default: `"changethis"`) The password for the PostgreSQL database, stored in .env, you can generate one with the method above.

- `sentry_dsn`: (default: "") The DSN for Sentry, if you are using it, you can set it later in .env.



## Backend Development



Backend docs: [backend/README.md](./backend/README.md).



## Frontend Development



Frontend docs: [frontend/README.md](./frontend/README.md).



## Deployment



Deployment docs: [deployment.md](./deployment.md).



## Development



General development docs: [development.md](./development.md).



This includes using Docker Compose, custom local domains, `.env` configurations, etc.



## Release Notes



Check the file [release-notes.md](./release-notes.md).



## License



The Full Stack FastAPI Template is licensed under the terms of the MIT license.