till/managarten
1
0
Fork 0
mirror of https://github.com/Memo-2023/mana-monorepo.git synced 2026-05-17 19:29:40 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 5
managarten/apps-archived/mukke/CLAUDE.md
Till JS 7a56699d45 feat(mukke): rename LightWrite to Mukke and add music library, player, playlists 
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>
2026-03-19 09:55:56 +01:00

2.3 KiB
Raw Blame History

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

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