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!