Skip to content

Quick Start

FastSvelte is a fullstack SaaS starter kit built with FastAPI (Python) and SvelteKit (TypeScript). Get it running locally in a few minutes, then browse Features for everything that's included.

The interactive init.py script handles setup end to end. Clone the repo, run init.py, then create an admin account and start the servers:

# 1. Clone, then drop the template remote
git clone https://github.com/harunzafer/fastsvelte.git my-project
cd my-project && git remote remove origin

# 2. Interactive setup — sets up your project for you (--dry-run to preview)
uv run init.py

# 3. Create a system admin, then start the backend
cd backend
uv run scripts/create_admin.py
uv run uvicorn app.main:app --reload

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

Prerequisites

You'll need uv to run init.py in the first place, plus Node.js 22+, Sqitch, and Docker (running). init.py checks those last three first and exits with install instructions if any are missing — so once uv is in place you can just run it and fix what it flags.

Open localhost:5173 and log in with the admin you created. The backend and interactive API docs are at localhost:8000/docs; the landing template runs at localhost:5174.

Next steps