SvelteKit Starter
A full-stack SvelteKit starter with PostgreSQL, Drizzle ORM, Tailwind CSS, and OpenTelemetry observability. Deployable as a Node.js Docker container.
Prerequisites
- Node.js (LTS recommended)
- pnpm
>= 10 - Docker (for local Postgres and the Aspire observability dashboard)
Dev container — a
.devcontainerconfiguration is included. Opening the project in VS Code (or any Dev Containers-compatible tool) will provision a container with Node.js, pnpm, and Docker already set up, so no local installation is needed.
Getting started
# 1. Start Postgres and the Aspire dashboard
docker compose up -d
# 2. Install dependencies
pnpm install
# 3. Run database migrations
pnpm db:migrate
# 4. Start the dev server
pnpm dev
The app will be available at http://localhost:5173.
The Aspire observability dashboard is at http://localhost:18888.
Environment variables for local development are in .env.development (committed, no real secrets).
Commands
| Command | Description |
|---|---|
pnpm dev |
Start the dev server |
pnpm build |
Build for production |
pnpm preview |
Preview the production build locally |
pnpm check |
Type-check with svelte-check |
pnpm lint |
Lint with ESLint |
pnpm format |
Format with Prettier |
pnpm test:unit |
Run unit tests (Vitest) |
pnpm test:e2e |
Run end-to-end tests (Playwright) |
pnpm test |
Run all tests |
pnpm db:generate |
Generate a migration from schema changes |
pnpm db:migrate |
Apply pending migrations |
pnpm db:push |
Push schema directly to DB (no migration file) |
pnpm db:studio |
Open Drizzle Studio to browse the database |
Deploy with Docker
# 1. Create a production env file and fill in real credentials
cp .env.example .env
# 2. Build and start
docker compose -f docker/docker-compose.prod.yml up -d --build
The app runs on port 3000 (override with the PORT env var). Health check endpoint: GET /api/health.
Key libraries
| Library | Purpose |
|---|---|
| SvelteKit | Full-stack web framework |
| Drizzle ORM | Type-safe SQL ORM for PostgreSQL |
| Tailwind CSS | Utility-first CSS framework |
| DaisyUI | Component library for Tailwind |
| Zod | Schema validation |
| OpenTelemetry | Distributed tracing and structured logs |
| Vitest + Testing Library | Unit testing |
| Playwright | End-to-end testing |
| Husky + lint-staged | Pre-commit hooks (lint + format) |
| nosecone | Security headers and CSP |
