Project		Status
CI/CD
Quality
Community
Meta

Litestar Fullstack Reference Application

This is a reference application that you can use to get your next Litestar application running quickly.

It contains most of the boilerplate required for a production web API with features like:

• Latest Litestar configured with best practices
• Integration with SQLAlchemy 2.0, SAQ (Simple Asynchronous Queue), Structlog, and Granian
• Frontend integrated with Vite in SPA mode and React Email templates compiled to static HTML
• JWT auth with refresh tokens, MFA, OAuth, and admin surfaces
• Multi-stage Docker build using a minimal Python 3.13 runtime image (including a distroless variant)
• Team and role management with service/repository patterns and Advanced Alchemy filters

Take what you need and adapt it to your own projects

Quick Start

To quickly get a development environment running, run the following:

make install
. .venv/bin/activate

Local Development

cp .env.local.example .env
. .venv/bin/activate
make start-infra
app database upgrade
app run

Docker

If you want to run the entire development environment containerized, you can run the following:

docker compose up