Lokale Entwicklung

Infra starten, Apps im Dev-Modus, Datenbank-Migrationen und typische Stolperfallen.

#Voraussetzungen

Node 22, pnpm 10, Docker. Abhängigkeiten einmal installieren:

bash
pnpm install

#Infra starten

bash
pnpm infra:up      # Postgres, Redis, MinIO, Gotenberg …
pnpm infra:down

#Apps

bash
pnpm --filter @repo/medusa dev        # :9000
pnpm --filter @repo/storefront dev    # :3000
pnpm --filter @repo/shop-admin dev    # :3001
pnpm --filter @repo/platform dev      # :3002

Jede App liest ihre .env (Vorlage .env.example). Werte wie API-Schlüssel und Passwörter gehören nur dorthin.

#Migrationen

bash
# Medusa: Migration für ein Modul erzeugen und ausführen
cd apps/medusa
npx medusa db:generate giftCard
npx medusa db:migrate

# Payload (shop-admin)
pnpm --filter @repo/shop-admin payload migrate:create <name>

Medusa führt Migrationen beim Start aus. Migrationen sind nur vorwärts gerichtet – ein Rollback auf ein Release mit älterem Schema braucht ein Backup.

#Prüfen

bash
pnpm typecheck
pnpm lint

Tipp

Zeigt Turbopack nach größeren Änderungen veraltete Module („… is not a function“), den Dev-Server neu starten. Hängt die Plattform in einer Reload-Schleife, apps/platform/.next/dev löschen und neu starten.

Zuletzt aktualisiert am 21. Oktober 2026

ZurückArchitekturWeiter E-Mail-Versand (SMTP, Brevo)