SvelteKit Travel Log

🇧🇷 Leia em português: README.pt-BR.md

A full-stack travel journal. Add the places you've visited on an interactive map, log trips to each one with dates and notes, and attach photos to every log entry.

This is a SvelteKit adaptation of the "Travel Log" project taught by CJ on Syntax — see Credits below. The original is built with Nuxt; this repo reimplements the same product with SvelteKit, better-auth, Drizzle/Turso, and SeaweedFS for image storage.

Table of contents

• Screenshots
• Features
• Tech stack
• Project structure
• Getting started
  • Prerequisites
  • 1. Clone and install
  • 2. Environment variables
  • 3. Database
  • 4. Image storage (SeaweedFS via Docker Compose)
  • 5. Run the app
• Available scripts
• Database & migrations
• Authentication
• Building for production
• Credits

Screenshots

Add your own screenshots/videos to docs/media and they'll show up here.

Home / sign-in

Dashboard & map

Add a location

Location detail

Add a log entry

Image gallery

Uploading images

Features

• Interactive map (MapLibre GL) for browsing and adding locations
• Add locations by dragging a marker or searching an address via Nominatim (OpenStreetMap)
• Log individual trips per location, with start/end dates and notes
• Upload, view, and delete photos on a log entry, with a lightbox gallery (PhotoSwipe)
• GitHub OAuth sign-in via better-auth

Tech stack

Layer	Choice
Framework	SvelteKit (Svelte 5, runes)
Auth	better-auth — GitHub OAuth
Database	Turso (libSQL/SQLite) + Drizzle ORM
Validation	valibot + TanStack Form
Maps	MapLibre GL + svelte-maplibre-gl
Client data fetching	TanStack Query + ky
UI	Skeleton UI + Tailwind CSS v4
Image storage	SeaweedFS (S3-compatible), via @aws-sdk/client-s3 presigned uploads
Image gallery	PhotoSwipe

Project structure

src/
├── lib/
│   ├── schema/            # Drizzle table definitions + valibot insert/select schemas
│   ├── server/
│   │   ├── db/            # DB client + Drizzle migrations
│   │   └── utils/          # Result type, auth request handler, etc.
│   └── auth-client.ts      # Client-side better-auth helper
└── routes/
    ├── dashboard/          # Location list + map, add/edit location, location detail
    ├── api/
    │   ├── locations/      # REST endpoints for locations and their logs/images
    │   └── search/         # Nominatim geocoder proxy
    └── sign-out/

See CLAUDE.md for a deeper architectural walkthrough (auth flow, state management, routing).

Getting started

Prerequisites

• Node.js 20+
• pnpm 9+ (corepack enable will pick up the version pinned in package.json)
• Docker (for the SeaweedFS image storage container)
• Turso CLI (turso dev powers the local database — installed as part of pnpm install/available via pnpm dev:db)
• A GitHub OAuth App for sign-in (callback URL: http://localhost:5173/api/auth/callback/github for local dev)

1. Clone and install

git clone <this-repo-url>
cd sveltekit-travel-log
pnpm install

2. Environment variables

Copy the example file and fill in the values:

cp .env.example .env

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗