create-fastapi-react-saas

A zero-compromise, production-grade SaaS CLI generator. Instantly scaffold a Domain-Driven FastAPI + React stack designed around deterministic dependencies, sub-30s builds, and robust Feature Module Architecture.

🚀 Why this boilerplate?

Most SaaS templates bloat your system with complex custom scripts, Redis instances you don't need yet, and horrible local configurations where you have to manually map Python and Node environments.

This boilerplate does exactly one thing perfectly: It gives you a pristine, ultra-fast Docker-Native foundation where the backend and frontend are guaranteed to communicate over a seamless Vite proxy on port ::5173.

• Backend: FastAPI, SQLAlchemy, Alembic, PostgreSQL
• Frontend: React, Vite, TypeScript
• DX: Sub-30s container boots via Docker BuildKit caching
• Architecture: Strict Domain-Driven feature modules (Router -> Service -> Repository)

🛠 Usage

You don't need to clone any repositories. Just run the generator directly via npx:

npx create-fastapi-react-saas my-new-saas-project

The generator will intelligently scaffold the repository, rewrite all internal variables/titles/npm configurations to match my-new-saas-project, and initialize a fresh Git repository for you.

📋 Prerequisites

To run the generated template, you only need:

• Docker & Docker Compose
• Git

Note: You do NOT need Python or Node installed locally to run the actual SaaS!

🏃 Next Steps

Once generated, simply enter the folder and boot:

cd my-new-saas-project
cp .env.example .env
docker compose up --build

Then visit http://localhost:5173 to see the React Demo securely proxy a live PostgreSQL Database connection response from the internal FastAPI network.

📄 License

MIT