mirror of
https://github.com/Memo-2023/mana-monorepo.git
synced 2026-05-20 08:53:39 +02:00
7a56699d45
Combines LightWrite (beat/lyrics editor) and Mukke (iOS music player) into a single web-based music workspace app. Archives the old Mukke mobile app. - Rename: @lightwrite/* → @mukke/*, all branding, configs, Dockerfiles - New DB schemas: songs, playlists, playlist_songs + songId FK on projects - New backend modules: SongModule, PlaylistModule, LibraryModule - New web: app shell with sidebar, library (songs/albums/artists/genres), web player (queue/shuffle/repeat/MediaSession), playlists, search, upload, dashboard, album/artist/genre detail pages - Auth: add forgot-password + reset-password pages, extend auth store - Tests: 40 backend unit tests (song, playlist, library services) - Config: env generation, MinIO bucket, docker-compose prod, cloudflare - Docs: update CLAUDE.md, auth guidelines with SvelteKit checklist Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
60 lines
2.3 KiB
Markdown
60 lines
2.3 KiB
Markdown
# CLAUDE.md - Mukke
|
|
|
|
Offline-first iOS Music Player. Songs aus iCloud/lokalen Dateien importieren, lokal auf dem Gerät speichern, abspielen.
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
apps/mukke/
|
|
├── package.json # Orchestrator (name: mukke)
|
|
├── apps/
|
|
│ └── mobile/ # @mukke/mobile (Expo SDK 54)
|
|
│ ├── app/ # Expo Router screens
|
|
│ │ ├── (tabs)/ # 4 Tab-Screens (Bibliothek, Playlists, Suche, Settings)
|
|
│ │ ├── player.tsx # Full-Screen Player (modal)
|
|
│ │ ├── queue.tsx # Queue Ansicht (modal)
|
|
│ │ ├── album/[id] # Album Detail
|
|
│ │ ├── artist/[id] # Artist Detail
|
|
│ │ └── playlist/ # Playlist Detail + New
|
|
│ ├── components/ # UI components
|
|
│ ├── contexts/ # AudioContext (expo-audio)
|
|
│ ├── stores/ # Zustand stores (player, library, playlist)
|
|
│ ├── services/ # Business logic (DB, import, audio, library, playlist)
|
|
│ └── utils/ # Theme system
|
|
└── packages/
|
|
└── mukke-types/ # @mukke/types (shared interfaces)
|
|
```
|
|
|
|
## Commands
|
|
|
|
```bash
|
|
pnpm dev:mukke:mobile # Start Expo app
|
|
```
|
|
|
|
## Tech Stack
|
|
|
|
- **Audio**: expo-audio (background via UIBackgroundModes: ["audio"])
|
|
- **Import**: expo-document-picker (iCloud + lokale Dateien)
|
|
- **Storage**: expo-file-system (documentDirectory)
|
|
- **Metadata**: @missingcore/audio-metadata (ID3v2.3/v2.4)
|
|
- **DB**: expo-sqlite (SQLite für Songs, Playlists)
|
|
- **State**: Zustand
|
|
- **Navigation**: Expo Router + NativeTabs
|
|
- **Styling**: NativeWind / Tailwind
|
|
|
|
## Architecture
|
|
|
|
- **No backend** - pure offline, local-only app
|
|
- **SQLite** for structured data (songs, playlists, playlist_songs)
|
|
- **Albums/Artists/Genres** derived from songs table via queries (no separate tables)
|
|
- **File storage**: documentDirectory/music/ + documentDirectory/artwork/
|
|
- **Audio playback**: expo-audio with background mode
|
|
- **MiniPlayer**: persistent above tab bar
|
|
|
|
## Import Flow
|
|
|
|
1. User taps Import → expo-document-picker opens (iCloud + local)
|
|
2. Files copied to documentDirectory/music/{uuid}.ext
|
|
3. Metadata extracted via @missingcore/audio-metadata
|
|
4. Cover art saved to documentDirectory/artwork/{uuid}.jpg
|
|
5. Song entry created in SQLite
|