vikingowl
a05ff346f1
- Add Rust API scaffold (axum + PostgreSQL + MinIO)
- Add SvelteKit frontend scaffold (Tailwind CSS)
- Add docker-compose for local development
- Include models, routes, services, WebSocket structure
🤖 Generated with Claude Code
1.4 KiB
1.4 KiB
Owlibou TTRPG
Collaborative TTRPG platform with session notes, campaign management, and character tools.
Quick Start
# Start all services (API, frontend, database, MinIO)
docker-compose up -d
# Or run individually for development:
# API (Rust)
cd api && cargo run
# Frontend (SvelteKit)
cd suite && pnpm install && pnpm dev
Architecture
owlibou-ttrpg/
├── api/ # Rust backend (axum + PostgreSQL)
├── suite/ # SvelteKit frontend (Tailwind)
└── docs/ # Architecture documentation
Tech Stack
| Layer | Technology |
|---|---|
| Backend | Rust + axum + tokio |
| Database | PostgreSQL + pgcrypto |
| Real-time | WebSockets |
| Auth | JWT + OAuth2 |
| File Storage | MinIO (S3-compatible) |
| Frontend | SvelteKit + Tailwind |
Development
Prerequisites
- Rust 1.75+
- Node.js 20+ & pnpm
- Docker & Docker Compose
- PostgreSQL 16 (or use Docker)
Environment Setup
# Copy environment files
cp .env.example .env
cp api/.env.example api/.env
cp suite/.env.example suite/.env
# Start database and MinIO
docker-compose up -d db minio
# Run migrations
cd api && sqlx migrate run
# Start API
cd api && cargo watch -x run
# Start frontend (new terminal)
cd suite && pnpm dev
URLs
- Frontend: http://localhost:5173
- API: http://localhost:3000
- MinIO Console: http://localhost:9001
License
AGPLv3