Litestar Fullstack Reference Application

A production-ready fullstack web application built on Litestar, React 19, and Vite.

Features

• SPA Frontend — React 19 + Vite + TailwindCSS (SPA mode via litestar-vite)
• JWT Auth — Refresh tokens, MFA (TOTP), OAuth, and admin tooling
• Service/Repository Pattern — UUIDv7 primary keys with Advanced Alchemy
• Background Jobs — SAQ workers with structured logging via structlog
• Docker Ready — Dockerized development and production workflows (distroless)

Quick Start

make install
cp .env.local.example .env
make start-infra
uv run app database upgrade
uv run app run

Or run everything in Docker:

docker compose up

Documentation

Document	Description
API Reference	OpenAPI endpoints & conventions
Contributing	Dev setup, Git strategy, versioning, testing
Changelog	Release history
Roadmap	Product planning

License

This is a proprietary project. See Third-Party Licenses for open-source dependencies.