This is a preview of FastSaas.

This repository shows the architecture, file structure and main features of the template. Start your SaaS today and get the full version at www.fast-saas.com.

Get your FastSaaS development environment running in minutes!

For new developers, just run:

make setup

This single command will:

• ✅ Check all prerequisites are installed
• 📝 Set up environment files from templates
• 📦 Install Python and Node.js dependencies
• 🚀 Start the development environment
• 🎉 Show you all the URLs to access your app

Make sure you have these installed:

• Docker & Docker Compose - For containerized development
• uv - Python package manager (install guide)
• Node.js - For the React frontend

For a complete setup with secure secrets:

make setup-full

This includes everything from make setup plus:

• 🔐 Generates secure secrets for your .env file
• 🗄️ Runs database migrations

Once setup is complete, access your app at:

After running make setup:

1. Configure Services (Optional):

   # Generate secure secrets for production make setup-secrets # Copy the generated values to your .env file # Update Stripe keys and email settings

2. Start Development:

   # Start development environment make dev # View logs from all services make logs # Run tests make tests # Format code make format

3. Database Operations:

   # Run migrations make migrate # Create new migration make migrate-create msg="add new feature" # Connect to database make db-shell

4. Test the application:

Login using the credentials defined in your FIRST_SUPERUSER and FIRST_SUPERUSER_PASSWORD environment variables

# Start development environment make dev # Stop development environment make dev-down # Restart everything make dev-restart # View help for all available commands make help # Clean up containers and caches make clean

Command not found?

• Make sure make is installed on your system
• On macOS: brew install make or use Xcode Command Line Tools

Docker issues?

• Ensure Docker is running: docker --version
• Check Docker Compose: docker compose version

Python/Node issues?

• Install uv: curl -LsSf https://astral.sh/uv/install.sh | sh
• Install Node.js: https://nodejs.org/

Need help?

• Run make help to see all available commands
• Contact us at admin@fast-saas.com, we'll be happy to assist!

fastapi-saas/ ├── app/ # Python backend (FastAPI) ├── frontend/ # React frontend ├── scripts/ # Development scripts ├── .env.example # Environment template ├── Makefile # Development commands └── docker-compose.yml # Container configuration 

That's it! 🎉

Your FastSaaS development environment should now be running. Visit http://localhost:5173 to see your application!