# FastSvelte Documentation

> FastSvelte is a FastAPI (Python) + SvelteKit starter kit: auth, payments, and multi-tenancy, plus AI-ready usage metering, per-plan credit allowances, and top-ups. Self-hosted, full source code, no platform lock-in. Includes generated TypeScript API clients via Orval, admin and user dashboards, and Docker Compose for local development. Supports both B2C and B2B (multi-tenant with organizations, roles, and invitations) modes.

FastSvelte is a FastAPI (Python) + SvelteKit starter kit: auth, payments, and multi-tenancy, plus AI-ready usage metering, per-plan credit allowances, and top-ups. Self-hosted, full source code, no platform lock-in. Includes generated TypeScript API clients via Orval, admin and user dashboards, and Docker Compose for local development. Supports both B2C and B2B (multi-tenant with organizations, roles, and invitations) modes.

For the full documentation content concatenated into a single file, see [llms-full.txt](https://docs.fastsvelte.dev/llms-full.txt).


## Get Started

- [Quick Start](https://docs.fastsvelte.dev/index.md): Quick start — what's included, prerequisites, setup, and core configuration.

## Guides

- [Project Setup](https://docs.fastsvelte.dev/guides/project-setup/index.md): What init.py configured, the env files, and team onboarding.
- [Development Workflow](https://docs.fastsvelte.dev/guides/development-workflow/index.md): The DB to backend to frontend change loop and API client regen.
- [Adding a Feature](https://docs.fastsvelte.dev/guides/adding-a-feature/index.md): Add a new entity end-to-end (schema, repo, service, route, UI).
- [Metering a Custom Feature](https://docs.fastsvelte.dev/guides/metering-a-custom-feature/index.md): Put an action behind a per-plan limit; optional credit top-up.
- [Swapping the LLM Provider](https://docs.fastsvelte.dev/guides/swapping-llm-provider/index.md): Swap OpenAI for Claude, Gemini, or LiteLLM via the LLMClient seam.
- [Replacing the Demo](https://docs.fastsvelte.dev/guides/replacing-the-demo/index.md): Plan your app, build features, and remove the demo code.
- [Type-Safe API Client (Orval)](https://docs.fastsvelte.dev/guides/orval/index.md): Type-safe TypeScript API client generated from the OpenAPI spec.
- [Upgrading Dependencies](https://docs.fastsvelte.dev/guides/upgrading-dependencies/index.md): Dependabot policy and uv/npm upgrade workflows.
- [Getting Updates](https://docs.fastsvelte.dev/guides/getting-updates/index.md): How to pull FastSvelte updates into your fork.

## Features

- [Authentication](https://docs.fastsvelte.dev/features/authentication/index.md): Session auth, email verification, password reset, roles.
- [Google OAuth](https://docs.fastsvelte.dev/features/google-oauth/index.md): Google OAuth social login setup and flow.
- [Billing & Subscriptions](https://docs.fastsvelte.dev/features/billing/index.md): Stripe subscriptions, customer portal, and webhooks.
- [Plans & Usage](https://docs.fastsvelte.dev/features/plans-and-usage/index.md): Plan-defined per-feature limits and per-period usage metering.
- [AI Copilot](https://docs.fastsvelte.dev/features/ai/index.md): LLM client interface, OpenAI setup, the sample copilot, and streaming.
- [AI Usage & Credit Billing](https://docs.fastsvelte.dev/features/ai-billing/index.md): AI usage metering, token allotment, credit packs, and model pricing.
- [Multi-Tenancy (B2B)](https://docs.fastsvelte.dev/features/multi-tenancy/index.md): B2B mode — organizations, roles, invitations.
- [Database](https://docs.fastsvelte.dev/features/database/index.md): PostgreSQL schema, Sqitch migrations, and db_config.
- [Transactional Email](https://docs.fastsvelte.dev/features/email/index.md): Transactional email via Resend, SendGrid, or Azure.
- [Landing Page](https://docs.fastsvelte.dev/features/landing-page/index.md): The included SEO-optimized SvelteKit landing template.
- [SEO](https://docs.fastsvelte.dev/features/seo/index.md): SEO metadata, sitemaps, and robots.
- [Admin & User Dashboards](https://docs.fastsvelte.dev/features/admin-dashboards/index.md): Role-based admin and user dashboards.
- [Security](https://docs.fastsvelte.dev/features/security/index.md): Argon2 passwords, hashed sessions, RBAC, CSRF, AI spend caps.

## Deployment

- [Deployment](https://docs.fastsvelte.dev/deployment/index.md): Deployment overview — five common setups and what every setup needs.
- [Railway](https://docs.fastsvelte.dev/deployment/railway/index.md): All-in-one deploy on Railway (API + Postgres + static).
- [DigitalOcean](https://docs.fastsvelte.dev/deployment/digitalocean/index.md): DigitalOcean App Platform — container + managed Postgres + static.
- [Fly.io + Neon + Vercel](https://docs.fastsvelte.dev/deployment/fly-neon-vercel/index.md): Best-of-breed — API on Fly.io, Postgres on Neon, static on Vercel.
- [Azure](https://docs.fastsvelte.dev/deployment/azure/index.md): Azure — Container Apps + PostgreSQL Flexible Server + Static Web Apps.
- [Self-Hosting](https://docs.fastsvelte.dev/deployment/self-hosting/index.md): Self-host the whole stack with Docker Compose.

## Reference

- [Configuration](https://docs.fastsvelte.dev/reference/configuration/index.md): Backend FS_ environment variables, environments, CORS, and cron.
- [Architecture](https://docs.fastsvelte.dev/reference/architecture/index.md): Monorepo structure, layered backend, DI, request flow, frontend data loading.
- [Troubleshooting](https://docs.fastsvelte.dev/reference/troubleshooting/index.md): Common issues and fixes.