This project is a minimal FastAPI app, Dockerized and ready to be used as a base for your next project, or as a guide to Dockerize your existing FastAPI app.

It wires up a lot of real-world components without overloading the project with too many personal preferences.

⚡ Stack:

• FastAPI 0.111.0
• Python 3.13.2

• Tech Stack
• Running the App
  • Clone the Repo
  • Build and Start
  • Set Up the Database
  • Visit in Browser
• Development Commands
  • Linting
  • Formatting
  • Testing
• Managing Dependencies
• Front-end Choices
• Notable Opinions and Extensions
• Additional Resources
• About the Author

• FastAPI
• PostgreSQL
• SQLAlchemy
• Redis
• Celery

• esbuild
• TailwindCSS
• Heroicons

git clone https://github.com/your-username/your-repo.git hellofastapi
cd hellofastapi

docker compose up --build

Note:

• First build will take 5–10 minutes.
• Ensure Docker Compose v2.20.2+.
• Change DOCKER_WEB_PORT_FORWARD in .env if port 8000 is in use.
• Adjust UID and GID if permission errors on Linux.

In another terminal:

./run fastapi db reset --with-testdb

http://localhost:8000

./run lint

./run format

./run test

./run quality

• List outdated:

./run uv:outdated
./run yarn:outdated

• Install new packages:

1. Edit pyproject.toml or assets/package.json.
2. Run:

./run deps:install

1. CLI Add:

./run uv add mypackage --no-sync
./run yarn add mypackage --no-lockfile

2. Then install:

./run deps:install

Choose any depending on your app:

• Hotwire
• HTMX
• AlpineJS
• Vue.js
• React.js
• jQuery

• Docker Official Docs
• FastAPI Official Docs

• FastAPI with Docker
• Docker Compose Production Guide

Thanks for checking out this project. Feel free to fork, clone, or suggest improvements!