FastAPI Supabase Template

Environment

Python

uv is an extremely fast Python package and project manager, written in Rust.

bashCopy
cd backend
uv sync --all-groups --dev

Supabase

install supabase-cli

bashCopy
# brew in linux https://brew.sh/
brew install supabase/tap/supabase

launch supabase docker containers

bashCopy
# under repo root
supabase start

[!NOTE]

bashCopy
# Update `.env`
bash scripts/update-env.sh

modify the .env from the output of supabase start or run supabase status manually.

Test

bashCopy
cd backend
# test connection of db and migration
scripts/pre-start.sh
# unit test
scripts/test.sh
# test connection of db and test code
scripts/tests-start.sh

Docker

[!note]
atticux/fastapi_supabase_template is your image tag name, remember replace it with yours

build

bashCopy
cd backend
docker build -t atticux/fastapi_supabase_template .

test

bashCopy
bash scripts/update-env.sh
supabase start
cd backend
docker run --network host \
  --env-file ../.env \
  -it atticux/fastapi_supabase_template:latest \
  bash -c "sh scripts/pre-start.sh && sh scripts/tests-start.sh"