Moodlit Project Guide
Übersicht
Moodlit ist eine Ambient-Lighting-App, die es Benutzern ermöglicht, benutzerdefinierte Lichtstimmungen mit Farbverläufen und Animationen zu erstellen. Die App unterstützt sowohl bildschirmbasierte Beleuchtung als auch Geräte-Taschenlampensteuerung.
Project Structure
apps/moodlit/
├── apps/
│ ├── backend/ # NestJS API server (@moodlit/backend)
│ │ └── src/
│ │ ├── main.ts
│ │ ├── app.module.ts
│ │ ├── db/
│ │ │ ├── database.module.ts
│ │ │ ├── connection.ts
│ │ │ └── schema/
│ │ │ ├── moods.schema.ts
│ │ │ └── sequences.schema.ts
│ │ ├── moods/
│ │ │ ├── moods.module.ts
│ │ │ ├── moods.controller.ts
│ │ │ ├── moods.service.ts
│ │ │ └── dto/
│ │ ├── sequences/
│ │ │ ├── sequences.module.ts
│ │ │ ├── sequences.controller.ts
│ │ │ ├── sequences.service.ts
│ │ │ └── dto/
│ │ └── health/
│ │
│ ├── web/ # SvelteKit web app (@moodlit/web)
│ │ └── src/
│ │ ├── app.html
│ │ ├── app.css
│ │ └── routes/
│ │ ├── +layout.svelte
│ │ └── +page.svelte
│ │
│ ├── mobile/ # Expo React Native app (@moodlit/mobile)
│ │ ├── app/ # Expo Router routes
│ │ ├── components/
│ │ ├── hooks/
│ │ ├── store/
│ │ └── utils/
│ │
│ └── landing/ # Astro landing page (@moodlit/landing)
│
├── package.json
└── CLAUDE.md
Commands
Root Level (from monorepo root)
# Alle Apps starten
pnpm moodlit:dev # Run all moodlit apps
# Einzelne Apps starten
pnpm dev:moodlit:backend # Start backend server (port 3012)
pnpm dev:moodlit:web # Start web app (port 5182)
pnpm dev:moodlit:mobile # Start mobile app
pnpm dev:moodlit:landing # Start landing page (port 4332)
pnpm dev:moodlit:app # Start web + backend together
# Datenbank
pnpm moodlit:db:push # Push schema to database
pnpm moodlit:db:studio # Open Drizzle Studio
pnpm moodlit:db:seed # Seed initial data
# Deploy
pnpm deploy:landing:moodlit # Deploy landing to Cloudflare Pages
Backend (apps/moodlit/apps/backend)
pnpm dev # Start with hot reload
pnpm build # Build for production
pnpm start:prod # Start production server
pnpm db:push # Push schema to database
pnpm db:studio # Open Drizzle Studio
Web App (apps/moodlit/apps/web)
pnpm dev # Start dev server
pnpm build # Build for production
pnpm preview # Preview production build
Mobile App (apps/moodlit/apps/mobile)
pnpm dev # Start Expo dev server
pnpm ios # Build and run iOS simulator
pnpm android # Build and run Android emulator
pnpm build:dev # EAS development build
Landing Page (apps/moodlit/apps/landing)
pnpm dev # Start dev server (port 4332)
pnpm build # Build for production
pnpm preview # Preview build
Technology Stack
| Layer |
Technology |
| Backend |
NestJS 10, Drizzle ORM, PostgreSQL |
| Web |
SvelteKit 2.x, Svelte 5 (runes), Tailwind CSS 4 |
| Mobile |
Expo SDK 54, React Native 0.81, NativeWind, Zustand |
| Landing |
Astro 5.x, Tailwind CSS |
| Auth |
Mana Core Auth (JWT) |
Features
1. Mood Library
- Vorkonfigurierte Lichtstimmungen (Fire, Breath, Northern Lights, Thunder, etc.)
- Verschiedene Farbverläufe und Animationstypen
- Standard-Moods für jeden Benutzer
2. Custom Moods
- Erstelle eigene Lichtstimmungen
- Anpassbare Farben und Animationen
- Speichern und Wiederverwenden
3. Sequences
- Mehrere Moods zu einer Sequenz verketten
- Konfigurierbare Dauer und Übergänge
- Automatische Wiedergabe
4. Dual Output
- Bildschirmbasierte Beleuchtung
- Geräte-Taschenlampensteuerung
- Umschalten zwischen Modi
API Endpoints
Health
GET /api/v1/health # Health check
Moods
GET /api/v1/moods # List all moods
POST /api/v1/moods # Create mood
GET /api/v1/moods/:id # Get mood
PUT /api/v1/moods/:id # Update mood
DELETE /api/v1/moods/:id # Delete mood
Sequences
GET /api/v1/sequences # List all sequences
POST /api/v1/sequences # Create sequence
GET /api/v1/sequences/:id # Get sequence
PUT /api/v1/sequences/:id # Update sequence
DELETE /api/v1/sequences/:id # Delete sequence
Database Schema
moods
| Column |
Type |
Description |
id |
UUID |
Primary key |
user_id |
TEXT |
Owner |
name |
TEXT |
Mood name |
colors |
JSONB |
Array of color hex codes |
animation |
TEXT |
Animation type |
is_default |
BOOLEAN |
Default mood flag |
created_at |
TIMESTAMP |
Created date |
updated_at |
TIMESTAMP |
Updated date |
sequences
| Column |
Type |
Description |
id |
UUID |
Primary key |
user_id |
TEXT |
Owner |
name |
TEXT |
Sequence name |
mood_ids |
JSONB |
Array of mood IDs |
duration |
INTEGER |
Duration per mood (seconds) |
created_at |
TIMESTAMP |
Created date |
updated_at |
TIMESTAMP |
Updated date |
Environment Variables
Backend (.env)
NODE_ENV=development
PORT=3012
DATABASE_URL=postgresql://manacore:devpassword@localhost:5432/moods
MANA_CORE_AUTH_URL=http://localhost:3001
CORS_ORIGINS=http://localhost:5173,http://localhost:5182,http://localhost:8081
DEV_BYPASS_AUTH=true
DEV_USER_ID=your-test-user-id
Web (.env)
PUBLIC_BACKEND_URL=http://localhost:3012
PUBLIC_MANA_CORE_AUTH_URL=http://localhost:3001
Mobile (.env)
EXPO_PUBLIC_BACKEND_URL=http://localhost:3012
EXPO_PUBLIC_MANA_CORE_AUTH_URL=http://localhost:3001
Quick Start
1. Datenbank erstellen
# PostgreSQL Container muss laufen
docker compose -f docker-compose.dev.yml up -d postgres
# Datenbank erstellen
PGPASSWORD=devpassword psql -h localhost -U manacore -d postgres -c "CREATE DATABASE moods;"
# Schema pushen
pnpm moodlit:db:push
2. Apps starten
# Backend + Web zusammen
pnpm dev:moodlit:app
# Oder einzeln:
pnpm dev:moodlit:backend # Terminal 1
pnpm dev:moodlit:web # Terminal 2
pnpm dev:moodlit:mobile # Terminal 3
pnpm dev:moodlit:landing # Terminal 4 (optional)
3. URLs öffnen
Testing API (mit curl)
# Health Check
curl http://localhost:3012/api/v1/health
# Login (get token)
TOKEN=$(curl -s -X POST http://localhost:3001/api/v1/auth/login \
-H "Content-Type: application/json" \
-d '{"email": "test@example.com", "password": "password"}' | jq -r '.accessToken')
# Moods abrufen
curl http://localhost:3012/api/v1/moods \
-H "Authorization: Bearer $TOKEN"
# Neues Mood erstellen
curl -X POST http://localhost:3012/api/v1/moods \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"name": "Sunset", "colors": ["#ff6b6b", "#feca57", "#ff9ff3"], "animation": "gradient"}'
# Sequence erstellen
curl -X POST http://localhost:3012/api/v1/sequences \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"name": "Evening Flow", "moodIds": ["mood-id-1", "mood-id-2"], "duration": 30}'
Important Notes
- Authentication: Nutzt Mana Core Auth (JWT im Authorization Header)
- Database: PostgreSQL mit Drizzle ORM (Port 5432)
- Port: Backend läuft auf Port 3012, Web auf 5182, Landing auf 4332
- Mobile: Verwendet Expo Dev Client (nicht Expo Go) wegen nativer Dependencies
- Theme: Purple/Violet als Primärfarbe für die Mood-Thematik
ace7fa8f7f