A lean, modern full-stack boilerplate for building real products fast — without overengineering or heavy infrastructure.
Built for solo developers, freelancers, and small teams who want a codebase that is easy to understand, easy to change, and fast to ship.
- ⚡ Minimal-infra FastAPI + React setup
- 🧠 Opinionated, but not rigid
- 🛠 Optimized for MVPs, client work, and early-stage products
- 🔧 Built to be modified, not worshipped
If you usually delete half a boilerplate on day one — this starts closer to what you actually need.
- ⚙️ FastAPI — async, explicit, readable
- 🐘 PostgreSQL — SQLAlchemy 2.0 + Alembic
- ⚡ Redis — caching, rate limiting, async job queues (ARQ)
- 🔐 JWT Auth — simple, replaceable
- 🤖 CI Ready — Ruff, Mypy, Pytest (GitHub Actions)
-
⚛️ React — clean setup, no framework lock-in
-
🧪 Testing Included
- 🎭 Playwright — end-to-end tests
- 🧩 React Testing Library — component tests
-
🧹 Tests are easy to write — and easy to remove
- 🪶 Low infrastructure cost
- 🧱 Few moving parts
- 📖 Readable over clever
- 🚀 Fast local development
- 🚫 No enterprise cosplay
Kubernetes, service meshes, and over-abstraction are intentionally excluded.
- 🚀 MVP builders
- 🧑💻 Freelancers shipping client projects
- 🧠 Founders validating ideas
- 👥 Small teams that want control
MIT — use it, fork it, strip it down, or build on top of it.
In short: This boilerplate stays small so your product doesn’t have to fight it.