# mayopi/spotif-ish architecture

> Architecture diagram of the GitHub repository mayopi/spotif-ish, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mayopi/spotif-ish
- Repository: https://github.com/mayopi/spotif-ish

## Overview

Spotifish is a bare-bones Android music player. The user-facing flow spans Compose screens and ViewModels, domain use cases and repository contracts, data sources/repositories, and Media3 playback. The README also documents local MediaStore scanning, favorites/playlists persistence, settings, and a deliberately stubbed Drive integration. Source excerpts contain no application code, so arrows beyond documented module responsibilities are marked unverified rather than presented as inspected call paths.

Main entry points: [`app/src/main/java/com/example/spotifish/ui/SpotifishApp.kt`](https://github.com/mayopi/spotif-ish/blob/main/app/src/main/java/com/example/spotifish/ui/SpotifishApp.kt) (App navigation), [`app/src/main/java/com/example/spotifish/MainViewModel.kt`](https://github.com/mayopi/spotif-ish/blob/main/app/src/main/java/com/example/spotifish/MainViewModel.kt) (Screen state), [`domain/src/main/java/com/example/spotifish/domain/repository`](https://github.com/mayopi/spotif-ish/tree/main/domain/src/main/java/com/example/spotifish/domain/repository) (Repository contracts), [`app/src/main/java/com/example/spotifish/MainActivity.kt`](https://github.com/mayopi/spotif-ish/blob/main/app/src/main/java/com/example/spotifish/MainActivity.kt) (App entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Android app"]
  node_entry["App entry<br/>[MainActivity.kt]"]
  node_navigation["App navigation<br/>[SpotifishApp.kt]"]
  node_screens["Music screens<br/>[HomeScreens.kt]"]
  node_search["Search screen<br/>[SearchScreen.kt]"]
  node_library["Library screen<br/>[LibraryScreen.kt]"]
  node_settings["Settings screen<br/>[SettingsScreen.kt]"]
  node_playerui["Player screen<br/>[PlayerScreen.kt]"]
  node_viewmodels["Screen state<br/>[MainViewModel.kt]"]
  node_playerui_vm["Player state<br/>[PlayerViewModel.kt]"]
end

subgraph group_domain["Domain logic"]
  node_usecases["Music use cases"]
  node_contracts["Repository contracts"]
end

subgraph group_data["Music and data"]
  node_local["Local music scan"]
  node_musicdata["Music repositories"]
  node_librarydata["Favorites and playlists"]
  node_settingsdata["Settings storage"]
  node_drive["Drive stub"]
end

subgraph group_playback["Playback"]
  node_controller["Playback controller"]
  node_service["Playback service<br/>[PlaybackService.kt]"]
end

node_user(("Listener"))

node_user -.->|"opens app"| node_entry
node_entry -.->|"starts navigation"| node_navigation
node_navigation -.->|"shows screens"| node_screens
node_navigation -.->|"shows screens"| node_search
node_navigation -.->|"shows screens"| node_library
node_navigation -.->|"shows screens"| node_settings
node_navigation -.->|"shows screens"| node_playerui
node_screens -.->|"observes state"| node_viewmodels
node_search -.->|"observes state"| node_viewmodels
node_library -.->|"observes state"| node_viewmodels
node_settings -.->|"observes state"| node_viewmodels
node_viewmodels -.->|"invokes"| node_usecases
node_usecases -.->|"uses contracts"| node_contracts
node_local -.->|"provides local tracks"| node_musicdata
node_musicdata -.->|"implements contracts"| node_contracts
node_librarydata -.->|"implements contracts"| node_contracts
node_settingsdata -.->|"implements contracts"| node_contracts
node_drive -.->|"implements contract"| node_contracts
node_playerui -.->|"observes state"| node_playerui_vm
node_playerui_vm -.->|"controls playback"| node_controller
node_controller -.->|"uses service"| node_service

click node_entry "https://github.com/mayopi/spotif-ish/blob/main/app/src/main/java/com/example/spotifish/MainActivity.kt"
click node_navigation "https://github.com/mayopi/spotif-ish/blob/main/app/src/main/java/com/example/spotifish/ui/SpotifishApp.kt"
click node_screens "https://github.com/mayopi/spotif-ish/blob/main/app/src/main/java/com/example/spotifish/ui/HomeScreens.kt"
click node_search "https://github.com/mayopi/spotif-ish/blob/main/app/src/main/java/com/example/spotifish/ui/SearchScreen.kt"
click node_library "https://github.com/mayopi/spotif-ish/blob/main/app/src/main/java/com/example/spotifish/ui/LibraryScreen.kt"
click node_settings "https://github.com/mayopi/spotif-ish/blob/main/app/src/main/java/com/example/spotifish/ui/SettingsScreen.kt"
click node_playerui "https://github.com/mayopi/spotif-ish/blob/main/app/src/main/java/com/example/spotifish/ui/PlayerScreen.kt"
click node_viewmodels "https://github.com/mayopi/spotif-ish/blob/main/app/src/main/java/com/example/spotifish/MainViewModel.kt"
click node_usecases "https://github.com/mayopi/spotif-ish/tree/main/domain/src/main/java/com/example/spotifish/domain/usecase"
click node_contracts "https://github.com/mayopi/spotif-ish/tree/main/domain/src/main/java/com/example/spotifish/domain/repository"
click node_local "https://github.com/mayopi/spotif-ish/blob/main/data/src/main/java/com/example/spotifish/data/local/MediaStoreLocalMusicDataSource.kt"
click node_musicdata "https://github.com/mayopi/spotif-ish/blob/main/data/src/main/java/com/example/spotifish/data/repository/RemoteMusicRepository.kt"
click node_librarydata "https://github.com/mayopi/spotif-ish/blob/main/data/src/main/java/com/example/spotifish/data/repository/RemoteFavoritesRepository.kt"
click node_settingsdata "https://github.com/mayopi/spotif-ish/blob/main/data/src/main/java/com/example/spotifish/data/repository/DefaultSettingsRepository.kt"
click node_drive "https://github.com/mayopi/spotif-ish/blob/main/data/src/main/java/com/example/spotifish/data/repository/RemoteDriveRepository.kt"
click node_playerui_vm "https://github.com/mayopi/spotif-ish/blob/main/app/src/main/java/com/example/spotifish/ui/player/PlayerViewModel.kt"
click node_controller "https://github.com/mayopi/spotif-ish/blob/main/player/src/main/java/com/example/spotifish/player/controller/Media3PlaybackController.kt"
click node_service "https://github.com/mayopi/spotif-ish/blob/main/player/src/main/java/com/example/spotifish/player/service/PlaybackService.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_navigation,node_screens,node_search,node_library,node_settings,node_playerui,node_viewmodels,node_playerui_vm toneBlue
class node_usecases,node_contracts toneAmber
class node_local,node_musicdata,node_librarydata,node_settingsdata,node_drive toneMint
class node_controller,node_service toneRose
class node_user toneIndigo
```

## Components

### Android app

- [App entry](https://github.com/mayopi/spotif-ish/blob/main/app/src/main/java/com/example/spotifish/MainActivity.kt): `app/src/main/java/com/example/spotifish/MainActivity.kt`
- [App navigation](https://github.com/mayopi/spotif-ish/blob/main/app/src/main/java/com/example/spotifish/ui/SpotifishApp.kt): `app/src/main/java/com/example/spotifish/ui/SpotifishApp.kt`
- [Music screens](https://github.com/mayopi/spotif-ish/blob/main/app/src/main/java/com/example/spotifish/ui/HomeScreens.kt): `app/src/main/java/com/example/spotifish/ui/HomeScreens.kt`
- [Search screen](https://github.com/mayopi/spotif-ish/blob/main/app/src/main/java/com/example/spotifish/ui/SearchScreen.kt): `app/src/main/java/com/example/spotifish/ui/SearchScreen.kt`
- [Library screen](https://github.com/mayopi/spotif-ish/blob/main/app/src/main/java/com/example/spotifish/ui/LibraryScreen.kt): `app/src/main/java/com/example/spotifish/ui/LibraryScreen.kt`
- [Settings screen](https://github.com/mayopi/spotif-ish/blob/main/app/src/main/java/com/example/spotifish/ui/SettingsScreen.kt): `app/src/main/java/com/example/spotifish/ui/SettingsScreen.kt`
- [Player screen](https://github.com/mayopi/spotif-ish/blob/main/app/src/main/java/com/example/spotifish/ui/PlayerScreen.kt): `app/src/main/java/com/example/spotifish/ui/PlayerScreen.kt`
- [Screen state](https://github.com/mayopi/spotif-ish/blob/main/app/src/main/java/com/example/spotifish/MainViewModel.kt): `app/src/main/java/com/example/spotifish/MainViewModel.kt`
- [Player state](https://github.com/mayopi/spotif-ish/blob/main/app/src/main/java/com/example/spotifish/ui/player/PlayerViewModel.kt): `app/src/main/java/com/example/spotifish/ui/player/PlayerViewModel.kt`

### Domain logic

- [Music use cases](https://github.com/mayopi/spotif-ish/tree/main/domain/src/main/java/com/example/spotifish/domain/usecase): `domain/src/main/java/com/example/spotifish/domain/usecase`
- [Repository contracts](https://github.com/mayopi/spotif-ish/tree/main/domain/src/main/java/com/example/spotifish/domain/repository): `domain/src/main/java/com/example/spotifish/domain/repository`

### Music and data

- [Local music scan](https://github.com/mayopi/spotif-ish/blob/main/data/src/main/java/com/example/spotifish/data/local/MediaStoreLocalMusicDataSource.kt): `data/src/main/java/com/example/spotifish/data/local/MediaStoreLocalMusicDataSource.kt`
- [Music repositories](https://github.com/mayopi/spotif-ish/blob/main/data/src/main/java/com/example/spotifish/data/repository/RemoteMusicRepository.kt): `data/src/main/java/com/example/spotifish/data/repository/RemoteMusicRepository.kt`
- [Favorites and playlists](https://github.com/mayopi/spotif-ish/blob/main/data/src/main/java/com/example/spotifish/data/repository/RemoteFavoritesRepository.kt): `data/src/main/java/com/example/spotifish/data/repository/RemoteFavoritesRepository.kt`
- [Settings storage](https://github.com/mayopi/spotif-ish/blob/main/data/src/main/java/com/example/spotifish/data/repository/DefaultSettingsRepository.kt): `data/src/main/java/com/example/spotifish/data/repository/DefaultSettingsRepository.kt`
- [Drive stub](https://github.com/mayopi/spotif-ish/blob/main/data/src/main/java/com/example/spotifish/data/repository/RemoteDriveRepository.kt): `data/src/main/java/com/example/spotifish/data/repository/RemoteDriveRepository.kt`

### Playback

- [Playback controller](https://github.com/mayopi/spotif-ish/blob/main/player/src/main/java/com/example/spotifish/player/controller/Media3PlaybackController.kt): `player/src/main/java/com/example/spotifish/player/controller/Media3PlaybackController.kt`
- [Playback service](https://github.com/mayopi/spotif-ish/blob/main/player/src/main/java/com/example/spotifish/player/service/PlaybackService.kt): `player/src/main/java/com/example/spotifish/player/service/PlaybackService.kt`

### Other components

- **Listener**

## Connections

- Listener → App entry: opens app
- App entry → App navigation: starts navigation
- App navigation → Music screens: shows screens
- App navigation → Search screen: shows screens
- App navigation → Library screen: shows screens
- App navigation → Settings screen: shows screens
- App navigation → Player screen: shows screens
- Music screens → Screen state: observes state
- Search screen → Screen state: observes state
- Library screen → Screen state: observes state
- Settings screen → Screen state: observes state
- Screen state → Music use cases: invokes
- Music use cases → Repository contracts: uses contracts
- Local music scan → Music repositories: provides local tracks
- Music repositories → Repository contracts: implements contracts
- Favorites and playlists → Repository contracts: implements contracts
- Settings storage → Repository contracts: implements contracts
- Drive stub → Repository contracts: implements contract
- Player screen → Player state: observes state
- Player state → Playback controller: controls playback
- Playback controller → Playback service: uses service
