- ⚡ FastAPI for the Python backend API.
- 🧰 SQLModel for the Python SQL database interactions (ORM).
- 🔍 Pydantic, used by FastAPI, for the data validation and settings management.
- 💾 PostgreSQL as the SQL database.
- 🚀 React for the frontend.
- 🧩 Built into the backend application and served by FastAPI on the same domain as the API.
- 💃 Using TypeScript, hooks, Vite, and other parts of a modern frontend stack.
- 🎨 Tailwind CSS and shadcn/ui for the frontend components.
- 🤖 An automatically generated frontend client.
- 🧪 Playwright for end-to-end testing.
- 🦇 Dark mode support.
- ☁️ FastAPI Cloud for deployment.
- 🐋 Docker Compose for local services and self-hosted deployment.
- 📞 Traefik as a reverse proxy with automatic HTTPS.
- WorkOS AuthKit React for browser sessions and organization selection.
- Native PyJWT/JWKS resource-server verification with exact issuer/client binding.
- Canonical product identity crosswalks, tenant-scoped administration and PostgreSQL RLS.
- ✉️ React Email for email templates.
- 📬 Mailpit for local email testing during development.
- ✅ Tests with Pytest.
- 🏭 CI (continuous integration) and CD (continuous deployment) based on GitHub Actions.
The screenshots below are historical template illustrations, not the current WorkOS sign-in UI or evidence of a deployed authentication flow.
Click the Use this template button at the top of this page to create a new repository.
This branch requires an existing canonical product database and explicit WorkOS
application settings; it does not seed a global superuser or accept local
passwords. See backend configuration and isolated tests.
Production remains gated by recovery, schema/grant review, real provider settings
and tenant-conformance evidence. The manual deployment workflows select a
production environment, whose required reviewers/protection must be verified
through the GitHub owner before use; its name is not itself an approval.
Backend docs: backend/README.md.
Frontend docs: frontend/README.md.
FastAPI Cloud deployment: deployment.md.
Self-hosted deployment with Docker Compose: deployment-docker-compose.md.
General development docs: development.md.
This includes the local FastAPI and Vite workflow, Docker Compose services, .env configuration, and more.
This repository declares .pre-commit-config.yaml for prek, not Lefthook.
The estate's install-git-hooks <absolute-checkout> [install|validate] owner
validates that versioned declaration before changing Git configuration. The
validate mode installs nothing. Linked worktrees retain private hooks and
installation failures restore their previous worktree-local core.hooksPath.
Setup and check-in bind a primary submodule or separate-metadata repository to
Git's actual checkout root when its private/common Git directories match;
the metadata directory reported by worktree list is not a checkout.
Use the existing estate api-sync owner to provision this project's locked
Python workspace in the separate .venv-api environment. For native checks,
explicitly select that absolute path with UV_PROJECT_ENVIRONMENT; check-in
preserves it after direnv loading and checks the existing frozen profile
without resolution or synchronization. It never substitutes the estate's
Python environment or creates a checkout-local one. JavaScript dependencies
belong to the versioned bun.lock: use bun install --frozen-lockfile.
From this checkout, run the check-only hook contract with:
prek run --config .pre-commit-config.yaml --all-files --hook-stage pre-commitBiome, Ruff lint/format checks, mypy, ty, spelling and workflow checks do not rewrite sources. EOF/trailing-whitespace fixers, SDK generation and release-date updates are manual-only. Select one deliberately, for example:
prek run --config .pre-commit-config.yaml --all-files --hook-stage manual generate-frontend-sdkManual generation is not a freshness check: regenerate from the application's
own exporter, review the resulting client, and commit it before admission.
Neither --dry-run nor selecting the manual stage proves the generated files
are current.
git-branch-check-in uses this native all-file contract rather than inherited
parent Mise checks. It requires a clean committed branch and the verified
mutation lease, refuses hook skip selectors, and refuses to publish/unlock if
checks fail, move HEAD or leave any tracked/untracked changes. New linked
project bootstrap remains blocked until its environment and direnv ownership
are separately admitted; setup does not copy environments or invent .envrc.
Protected CI/merge admission still needs the isolated fixture and explicitly
provisioned CI inputs; local hook success does not waive that boundary.
Vendor contracts: prek's pinned CLI reference and the pinned whitespace hook manifest.
Check the file release-notes.md.
The Full Stack FastAPI Template is licensed under the terms of the MIT license.






