managarten/docs/DEVELOPMENT_SCRIPTS.md
Till JS 22a73943e1 chore: complete ManaCore → Mana rename (docs, go modules, plists, images)
Final cleanup of references missed in previous rename commits:

- Dockerfiles: PUBLIC_MANA_CORE_AUTH_URL → PUBLIC_MANA_AUTH_URL
- Go modules: github.com/manacore/* → github.com/mana/* (7 go.mod files)
- launchd plists: com.manacore.* → com.mana.* (14 files renamed + content)
- Image assets: *_Manacore_AI_Credits* → *_Mana_AI_Credits* (11 files)
- .env.example files: ManaCore brand strings → Mana
- .prettierignore: stale apps/manacore/* paths → apps/mana/*
- Markdown docs (CLAUDE.md, /docs/*): mana-core-auth → mana-auth, etc.

Excluded from rename: .claude/, devlog/, manascore/ (historical content),
client testimonials, blueprints, npm package refs (@mana-core/*).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 12:26:10 +02:00

109 lines
4.6 KiB
Markdown

# Development Scripts
Diese Dokumentation beschreibt die verfügbaren Entwicklungsbefehle im Mana Monorepo.
## Übersicht
Das Monorepo nutzt [Turborepo](https://turbo.build/) für parallele Builds und intelligentes Caching. Alle Befehle werden über `pnpm` ausgeführt.
## Globale Befehle
| Befehl | Beschreibung |
| ------------------- | ------------------------------------------------- |
| `pnpm dev` | Startet alle Apps (Web, Mobile, Landing, Backend) |
| `pnpm build` | Baut alle Packages und Apps |
| `pnpm test` | Führt alle Tests aus |
| `pnpm lint` | Führt Linting für alle Packages aus |
| `pnpm type-check` | TypeScript-Typprüfung für alle Packages |
| `pnpm clean` | Bereinigt Build-Artefakte |
| `pnpm format` | Formatiert alle Dateien mit Prettier |
| `pnpm format:check` | Prüft Formatierung ohne Änderungen |
## App-Typ Befehle
Diese Befehle starten alle Apps eines bestimmten Typs gleichzeitig:
| Befehl | Beschreibung | Apps |
| ------------------ | -------------------------- | ------------------------------------------ |
| `pnpm dev:web` | Startet alle Web-Apps | maerchenzauber, mana, cards, memoro |
| `pnpm dev:landing` | Startet alle Landing Pages | maerchenzauber, mana, cards, memoro |
| `pnpm dev:mobile` | Startet alle Mobile-Apps | maerchenzauber, mana, cards, memoro |
### Beispiel
```bash
# Alle Web-Apps starten (SvelteKit)
pnpm dev:web
# Alle Landing Pages starten (Astro)
pnpm dev:landing
# Alle Mobile-Apps starten (Expo)
pnpm dev:mobile
```
## Projekt-spezifische Befehle
Diese Befehle starten ein komplettes Projekt mit allen zugehörigen Apps und Dependencies:
| Befehl | Beschreibung |
| ------------------------- | ------------------------------------------------------ |
| `pnpm maerchenzauber:dev` | Startet Maerchenzauber (Backend, Web, Mobile, Landing) |
| `pnpm mana:dev` | Startet Mana (Web, Mobile, Landing) |
| `pnpm cards:dev` | Startet Cards (Web, Mobile, Landing) |
| `pnpm memoro:dev` | Startet Memoro (Web, Mobile, Landing) |
## Turbo Filter
Für erweiterte Kontrolle kannst du Turbo-Filter direkt verwenden:
```bash
# Einzelne App starten
pnpm turbo run dev --filter=@storyteller/web
# Mehrere Apps kombinieren
pnpm turbo run dev --filter=mana-web --filter=memoro-web
```
### Package-Namen Referenz
Da die Package-Namen im Monorepo unterschiedlich sind, hier eine Übersicht:
| Projekt | Web | Landing | Mobile | Backend |
| -------------- | ------------------ | ---------------------- | --------------------- | ---------------------- |
| maerchenzauber | `@storyteller/web` | `@storyteller/landing` | `@storyteller/mobile` | `@storyteller/backend` |
| mana | `mana-web` | `mana-landing` | `mana` | - |
| cards | `web` | `landing` | `cards` | - |
| memoro | `memoro-web` | `memoro-landing` | `memoro` | - |
### Filter-Syntax
| Pattern | Beschreibung |
| --------------------- | ------------------------------ |
| `--filter=name` | Exakte Package-Übereinstimmung |
| `--filter=name...` | Package und alle Dependencies |
| `--filter='@scope/*'` | Alle Packages im Scope |
## Port-Zuweisungen
Wenn mehrere Apps gleichzeitig laufen, verwenden sie unterschiedliche Ports:
| App-Typ | Projekt | Standard-Port |
| ------- | -------------- | ------------- |
| Web | maerchenzauber | 5173 |
| Web | mana | 5174 |
| Web | cards | 5175 |
| Web | memoro | 5176 |
| Landing | maerchenzauber | 4321 |
| Landing | mana | 4322 |
| Landing | cards | 4323 |
| Landing | memoro | 4324 |
| Backend | maerchenzauber | 3000 |
_Hinweis: Die tatsächlichen Ports können je nach Konfiguration variieren._
## Tipps
1. **Schnelleres Starten**: Nutze `dev:web` statt `dev` wenn du nur an Web-Apps arbeitest
2. **Parallele Entwicklung**: Turbo führt alle Tasks parallel aus und nutzt Caching
3. **Selektives Bauen**: Nutze Filter um nur relevante Packages zu bauen