# Quick Start

[FastSvelte](https://fastsvelte.dev) is a fullstack SaaS starter kit built with **FastAPI** (Python) and **SvelteKit** (TypeScript). Get it running locally in a few minutes, then browse [Features](https://docs.fastsvelte.dev/features/authentication/index.md) 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:

```sh
# 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](https://docs.astral.sh/uv/#installation) to run `init.py` in the first place, plus **Node.js 22+** and **Docker** (running). `init.py` checks those two first and exits with install instructions if either is missing, so once `uv` is in place you can just run it and fix what it flags.

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

## Next steps

- **[Guides](https://docs.fastsvelte.dev/guides/project-setup/index.md)** — set up your project, develop, and ship
- **[Features](https://docs.fastsvelte.dev/features/authentication/index.md)** — auth, billing, AI, multi-tenancy, and more
- **[Architecture](https://docs.fastsvelte.dev/reference/architecture/index.md)** · **[Deployment](https://docs.fastsvelte.dev/deployment/index.md)**