Skip to content

FastSvelte

A fullstack SaaS starter kit built with FastAPI (Python) and SvelteKit (TypeScript). Get authentication, multi-tenancy, and payments out of the box.

Quick Start

Get up and running in minutes:

# Clone the repository
git clone https://github.com/harunzafer/fastsvelte.git my-project
cd my-project

# Run the interactive setup
python3 init.py

# Create admin user
cd backend
source .venv/bin/activate
python scripts/create_admin.py

# Start the backend
uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload

# In a new terminal, start the frontend
cd frontend
npm run dev

Visit http://localhost:5173 and login with your admin credentials.

→ Complete Setup Guide for detailed configuration and troubleshooting.

Why FastSvelte?

  • Skip months of setup work - Authentication, payments, and multi-tenancy are already built and tested.
  • Type-safe from API to UI - Auto-generated TypeScript client means fewer bugs and better DX.
  • Built for B2B and B2C - Organization-based architecture adapts to your business model.
  • Production-ready from day one - Session auth, migrations, Docker deployment all configured.
  • Clean, maintainable code - Dependency injection and repository patterns make scaling easy.

Technology Stack

  • Backend: FastAPI with PostgreSQL and Sqitch migrations
  • Frontend: SvelteKit with TypeScript and TailwindCSS
  • Authentication: Session-based with HTTP-only cookies
  • Payments: Stripe integration with webhook handling
  • Deployment: Docker containers

What's Included

Four main components:

  • Backend API - FastAPI application with authentication, multi-tenancy, and payments
  • Frontend Dashboard - SvelteKit admin interface with user management
  • Landing Page - Marketing site template
  • Database Schema - PostgreSQL schema with migration system

Demo Application: AI Note Improver

FastSvelte includes a complete AI Note Improver demo application that showcases the kit's capabilities:

  • Full CRUD Operations - Create, read, update, and delete notes
  • AI Integration - OpenAI-powered note organization and improvement
  • Usage-Based Billing - Token consumption tracking with plan-based limits
  • Multi-tenant Architecture - Organization-level quotas and permissions

This demo application demonstrates how to build AI-powered SaaS features while maintaining proper authentication, authorization, and billing controls. Replace this demo with your own core functionality while keeping the underlying infrastructure.

Next Steps