SvelteKit Application Template

Full-stack SvelteKit template with authentication, i18n, and database integration. Designed for rapid startup of authenticated multi-tenant applications.

Stack: SvelteKit + Svelte 5 | Better Auth (passkeys + magic links) | Paraglide i18n | PostgreSQL | Vitest + Playwright

Quickstart

Requirements: Node 20+, pnpm, Docker

pnpm install
cp .env.example .env.local     # edit secrets (BETTER_AUTH_SECRET, etc.)
pnpm db:up
pnpm db:migrate
pnpm dev

Verify: curl localhost:5173/api/health

Customizing for Your App

This template provides infrastructure. To build your app:

1. Remove stubs: Delete src/routes/[[locale]]/(app)/dashboard/ and create your own pages
2. Update branding: Edit src/lib/components/brand/, static/favicon.svg
3. Configure auth: Update rpName in src/lib/server/auth/index.ts
4. Add your domain logic: Create modules in src/lib/domain/
5. Choose deployment target: Swap adapter in svelte.config.js if needed

See docs/usage.md for deployment and configuration details.

Documentation

• Architecture - system overview and structure
• Environment - environment configuration
• Runbook - operational commands
• Testing - test strategy and conventions
• Quick Start - detailed setup guide

Feature Docs

• Auth - authentication system
• Database - database operations
• i18n - internationalization
• Routing - SvelteKit routing patterns

Style Guides

• Code Style - coding conventions
• UI Style - design system
• Build - build configuration

Project Structure

src/
├── lib/
│   ├── server/       # server-only: db, env, auth
│   ├── components/   # UI components
│   ├── stores/       # runes-based state
│   └── i18n/         # paraglide helpers
├── routes/           # SvelteKit routes
└── app.html

db/migrations/        # SQL migrations
scripts/              # CLI scripts
docs/                 # documentation

License

MIT