Skip to content
flowgeist Kita — Dev Docs

Lokales Setup

1. Repository klonen

Section titled “1. Repository klonen”
Terminal window
git clone <repository-url> flowgeist-kita
cd flowgeist-kita

2. Dependencies installieren

Section titled “2. Dependencies installieren”
Terminal window
pnpm install

pnpm richtet alle Workspace-Pakete (api, web, shared, e2e, mobile) gemeinsam ein.

3. Umgebungsvariablen

Section titled “3. Umgebungsvariablen”

Die API benötigt eine .env-Datei im Verzeichnis api/. Orientieren Sie sich an api/.env.example (falls vorhanden). Mindestens erforderlich sind:

Variable Zweck
DATABASE_URL PostgreSQL-Verbindungsstring
REDIS_URL Redis-Verbindungsstring
JWT_SECRET Secret für Access-Tokens
JWT_REFRESH_SECRET Secret für Refresh-Tokens
FIELD_ENCRYPTION_KEY Schlüssel für Feld-Level-Encryption

4. Datenbank und Cache starten

Section titled “4. Datenbank und Cache starten”
Terminal window
docker compose up -d db redis

Das startet PostgreSQL 16 und Redis 7 als lokale Container.

5. Prisma Client generieren und migrieren

Section titled “5. Prisma Client generieren und migrieren”
Terminal window
pnpm db:generate
pnpm db:migrate

db:generate muss nach jeder Installation und jeder Schema-Änderung ausgeführt werden.

6. Entwicklungsserver starten

Section titled “6. Entwicklungsserver starten”
Terminal window
pnpm dev          # alle Workspaces parallel
pnpm dev:api      # nur die API (Port 3001)
pnpm dev:web      # nur das Web-Frontend (Port 3000)

Die API ist anschließend unter http://localhost:3001, das Web-Frontend unter http://localhost:3000 erreichbar.