Tutorial: Build a SaaS app from zero to deployed¶
This tutorial walks you through building Taskflow — a project management tool — from an empty directory to a production deployment. Each chapter introduces one Bluefox package in context, so you learn the stack by using it.
What you'll build¶
A multi-tenant project management app with:
- User registration and authentication
- Project boards with tasks and assignments
- Background email notifications
- File attachments on tasks
- Stripe-powered team billing
- Deployed to your own server with
bfx release
Chapters¶
| Chapter | Package | What you'll add |
|---|---|---|
| 1. Project Setup | bluefox-cli |
Scaffold project, database migrations, dev server |
| 2. Testing | bluefox-test |
Test fixtures, real database tests, factories |
| 3. Authentication | bluefox-auth |
Users, JWT tokens, permissions, email verification |
| 4. UI Components | bluefox-components |
Jinja2 templates, pre-styled forms, navigation |
| 5. Background Tasks | bluefox-tasks |
Email notifications, scheduled cleanup jobs |
| 6. File Storage | bluefox-storage |
Task attachments, S3 uploads, signed URLs |
| 7. Payments | bluefox-payments |
Stripe subscriptions, webhooks, billing page |
| 8. Deploy | bfx release |
Bootstrap a server, deploy to production |
Prerequisites¶
- Python 3.12+
- uv and bluefox-cli installed
- PostgreSQL (or Docker for testcontainers)
- Basic FastAPI knowledge
Time estimate¶
Each chapter takes 15–30 minutes. You can stop after any chapter and have a working app.
Ready? Start with Chapter 1: Project Setup.