# mateusrodcosta/vidya_music architecture

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

- Interactive diagram: https://gitdiagram.com/mateusrodcosta/vidya_music
- Repository: https://github.com/mateusrodcosta/vidya_music

## Overview

Vidya Music is a Flutter music player for the Vidya Intarweb Playlist. The user-facing workflow is to open the app, browse playlist/roster content, and use playback controls; settings and cross-platform hosting are supporting capabilities. The README identifies the playlist, while the sampled source does not include Dart feature implementations, so feature-level connections are left unverified. Native host relationships are shown only where the excerpts or source index support them.

Main entry points: [`lib/features/audio_player/presentation/bloc/audio_player_cubit.dart`](https://github.com/mateusrodcosta/vidya_music/blob/main/lib/features/audio_player/presentation/bloc/audio_player_cubit.dart) (Player state), [`lib/features/playlist/presentation/bloc/playlist_cubit.dart`](https://github.com/mateusrodcosta/vidya_music/blob/main/lib/features/playlist/presentation/bloc/playlist_cubit.dart) (Playlist state), [`lib/shared/presentation/pages/main_page.dart`](https://github.com/mateusrodcosta/vidya_music/blob/main/lib/shared/presentation/pages/main_page.dart) (Main page), [`lib/features/playlist/data/repositories`](https://github.com/mateusrodcosta/vidya_music/tree/main/lib/features/playlist/data/repositories) (Playlist repositories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App interface"]
  node_main["App entry<br/>[main.dart]"]
  node_main_page["Main page<br/>[main_page.dart]"]
  node_drawer["App drawer<br/>[app_drawer.dart]"]
  node_settings["Settings<br/>[settings_page.dart]"]
  node_settings_provider["Settings provider"]
end

subgraph group_content["Playlist content"]
  node_playlist["Playlist state"]
  node_roster["Roster list<br/>[roster_list.dart]"]
  node_track_item["Track item<br/>[track_item.dart]"]
  node_playlist_load["Roster loading"]
  node_playlist_config_load["Config and roster"]
  node_playlist_repo["Playlist repositories"]
  node_vip(("Vidya playlist"))
end

subgraph group_playback["Audio playback"]
  node_audio_cubit["Player state"]
  node_audio_service["Audio service"]
  node_player["Player controls<br/>[player.dart]"]
  node_miniplayer["Mini player<br/>[miniplayer.dart]"]
  node_progress["Playback progress"]
end

subgraph group_hosts["Platform hosts"]
  node_windows_entry["Windows entry<br/>[main.cpp]"]
  node_flutter_window["Flutter window<br/>[flutter_window.cpp]"]
  node_win32_window["Win32 window<br/>[win32_window.cpp]"]
  node_win_plugins["Windows plugins"]
  node_linux_entry["Linux entry<br/>[main.cc]"]
  node_linux_application["Linux application<br/>[my_application.cc]"]
  node_linux_plugins["Linux plugins"]
  node_ios_app["iOS app delegate<br/>[AppDelegate.swift]"]
  node_mac_plugins["macOS plugins"]
end

node_user(("Listener"))

node_user -.->|"opens"| node_main
node_main -.->|"starts"| node_main_page
node_main_page -.->|"shows"| node_drawer
node_drawer -.->|"opens"| node_settings
node_settings -.->|"uses"| node_settings_provider
node_main_page -.->|"presents"| node_playlist
node_playlist -.->|"renders"| node_roster
node_roster -.->|"renders"| node_track_item
node_playlist -.->|"loads"| node_playlist_load
node_playlist_load -.->|"uses"| node_playlist_repo
node_playlist -.->|"loads config"| node_playlist_config_load
node_playlist_config_load -.->|"uses"| node_playlist_repo
node_vip -.->|"provides playlist"| node_playlist_repo
node_track_item -.->|"selects track"| node_audio_cubit
node_audio_cubit -.->|"controls"| node_audio_service
node_player -.->|"controls"| node_audio_cubit
node_miniplayer -.->|"controls"| node_audio_cubit
node_progress -.->|"shows progress"| node_audio_cubit
node_windows_entry -->|"creates"| node_flutter_window
node_windows_entry -->|"configures"| node_win32_window
node_flutter_window -->|"inherits"| node_win32_window
node_linux_entry -->|"runs"| node_linux_application
node_linux_application -->|"registers plugins"| node_linux_plugins
node_ios_app -->|"registers plugins"| node_mac_plugins

click node_main "https://github.com/mateusrodcosta/vidya_music/blob/main/lib/main.dart"
click node_main_page "https://github.com/mateusrodcosta/vidya_music/blob/main/lib/shared/presentation/pages/main_page.dart"
click node_drawer "https://github.com/mateusrodcosta/vidya_music/blob/main/lib/shared/presentation/widgets/app_drawer.dart"
click node_settings "https://github.com/mateusrodcosta/vidya_music/blob/main/lib/features/settings/presentation/pages/settings_page.dart"
click node_settings_provider "https://github.com/mateusrodcosta/vidya_music/blob/main/lib/features/settings/presentation/provider/settings_provider.dart"
click node_playlist "https://github.com/mateusrodcosta/vidya_music/blob/main/lib/features/playlist/presentation/bloc/playlist_cubit.dart"
click node_roster "https://github.com/mateusrodcosta/vidya_music/blob/main/lib/features/playlist/presentation/widgets/roster_list.dart"
click node_track_item "https://github.com/mateusrodcosta/vidya_music/blob/main/lib/features/playlist/presentation/widgets/track_item.dart"
click node_playlist_load "https://github.com/mateusrodcosta/vidya_music/blob/main/lib/features/playlist/domain/usecases/load_roster_usecase.dart"
click node_playlist_config_load "https://github.com/mateusrodcosta/vidya_music/blob/main/lib/features/playlist/domain/usecases/get_config_and_load_roster_usecase.dart"
click node_playlist_repo "https://github.com/mateusrodcosta/vidya_music/tree/main/lib/features/playlist/data/repositories"
click node_audio_cubit "https://github.com/mateusrodcosta/vidya_music/blob/main/lib/features/audio_player/presentation/bloc/audio_player_cubit.dart"
click node_audio_service "https://github.com/mateusrodcosta/vidya_music/blob/main/lib/features/audio_player/data/datasources/audio_player_service.dart"
click node_player "https://github.com/mateusrodcosta/vidya_music/blob/main/lib/features/audio_player/presentation/widgets/player.dart"
click node_miniplayer "https://github.com/mateusrodcosta/vidya_music/blob/main/lib/features/audio_player/presentation/widgets/miniplayer.dart"
click node_progress "https://github.com/mateusrodcosta/vidya_music/blob/main/lib/features/audio_player/presentation/widgets/player_progress_bar.dart"
click node_windows_entry "https://github.com/mateusrodcosta/vidya_music/blob/main/windows/runner/main.cpp"
click node_flutter_window "https://github.com/mateusrodcosta/vidya_music/blob/main/windows/runner/flutter_window.cpp"
click node_win32_window "https://github.com/mateusrodcosta/vidya_music/blob/main/windows/runner/win32_window.cpp"
click node_win_plugins "https://github.com/mateusrodcosta/vidya_music/blob/main/windows/flutter/generated_plugin_registrant.h"
click node_linux_entry "https://github.com/mateusrodcosta/vidya_music/blob/main/linux/runner/main.cc"
click node_linux_application "https://github.com/mateusrodcosta/vidya_music/blob/main/linux/runner/my_application.cc"
click node_linux_plugins "https://github.com/mateusrodcosta/vidya_music/blob/main/linux/flutter/generated_plugin_registrant.h"
click node_ios_app "https://github.com/mateusrodcosta/vidya_music/blob/main/ios/Runner/AppDelegate.swift"
click node_mac_plugins "https://github.com/mateusrodcosta/vidya_music/blob/main/macos/Flutter/GeneratedPluginRegistrant.swift"

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_main,node_main_page,node_drawer,node_settings,node_settings_provider toneBlue
class node_playlist,node_roster,node_track_item,node_playlist_load,node_playlist_config_load,node_playlist_repo,node_vip toneAmber
class node_audio_cubit,node_audio_service,node_player,node_miniplayer,node_progress toneMint
class node_windows_entry,node_flutter_window,node_win32_window,node_win_plugins,node_linux_entry,node_linux_application,node_linux_plugins,node_ios_app,node_mac_plugins toneRose
class node_user toneIndigo
```

## Components

### App interface

- [App entry](https://github.com/mateusrodcosta/vidya_music/blob/main/lib/main.dart): `lib/main.dart`
- [Main page](https://github.com/mateusrodcosta/vidya_music/blob/main/lib/shared/presentation/pages/main_page.dart): `lib/shared/presentation/pages/main_page.dart`
- [App drawer](https://github.com/mateusrodcosta/vidya_music/blob/main/lib/shared/presentation/widgets/app_drawer.dart): `lib/shared/presentation/widgets/app_drawer.dart`
- [Settings](https://github.com/mateusrodcosta/vidya_music/blob/main/lib/features/settings/presentation/pages/settings_page.dart): `lib/features/settings/presentation/pages/settings_page.dart`
- [Settings provider](https://github.com/mateusrodcosta/vidya_music/blob/main/lib/features/settings/presentation/provider/settings_provider.dart): `lib/features/settings/presentation/provider/settings_provider.dart`

### Playlist content

- [Playlist state](https://github.com/mateusrodcosta/vidya_music/blob/main/lib/features/playlist/presentation/bloc/playlist_cubit.dart): `lib/features/playlist/presentation/bloc/playlist_cubit.dart`
- [Roster list](https://github.com/mateusrodcosta/vidya_music/blob/main/lib/features/playlist/presentation/widgets/roster_list.dart): `lib/features/playlist/presentation/widgets/roster_list.dart`
- [Track item](https://github.com/mateusrodcosta/vidya_music/blob/main/lib/features/playlist/presentation/widgets/track_item.dart): `lib/features/playlist/presentation/widgets/track_item.dart`
- [Roster loading](https://github.com/mateusrodcosta/vidya_music/blob/main/lib/features/playlist/domain/usecases/load_roster_usecase.dart): `lib/features/playlist/domain/usecases/load_roster_usecase.dart`
- [Config and roster](https://github.com/mateusrodcosta/vidya_music/blob/main/lib/features/playlist/domain/usecases/get_config_and_load_roster_usecase.dart): `lib/features/playlist/domain/usecases/get_config_and_load_roster_usecase.dart`
- [Playlist repositories](https://github.com/mateusrodcosta/vidya_music/tree/main/lib/features/playlist/data/repositories): `lib/features/playlist/data/repositories`
- **Vidya playlist**

### Audio playback

- [Player state](https://github.com/mateusrodcosta/vidya_music/blob/main/lib/features/audio_player/presentation/bloc/audio_player_cubit.dart): `lib/features/audio_player/presentation/bloc/audio_player_cubit.dart`
- [Audio service](https://github.com/mateusrodcosta/vidya_music/blob/main/lib/features/audio_player/data/datasources/audio_player_service.dart): `lib/features/audio_player/data/datasources/audio_player_service.dart`
- [Player controls](https://github.com/mateusrodcosta/vidya_music/blob/main/lib/features/audio_player/presentation/widgets/player.dart): `lib/features/audio_player/presentation/widgets/player.dart`
- [Mini player](https://github.com/mateusrodcosta/vidya_music/blob/main/lib/features/audio_player/presentation/widgets/miniplayer.dart): `lib/features/audio_player/presentation/widgets/miniplayer.dart`
- [Playback progress](https://github.com/mateusrodcosta/vidya_music/blob/main/lib/features/audio_player/presentation/widgets/player_progress_bar.dart): `lib/features/audio_player/presentation/widgets/player_progress_bar.dart`

### Platform hosts

- [Windows entry](https://github.com/mateusrodcosta/vidya_music/blob/main/windows/runner/main.cpp): `windows/runner/main.cpp`
- [Flutter window](https://github.com/mateusrodcosta/vidya_music/blob/main/windows/runner/flutter_window.cpp): `windows/runner/flutter_window.cpp`
- [Win32 window](https://github.com/mateusrodcosta/vidya_music/blob/main/windows/runner/win32_window.cpp): `windows/runner/win32_window.cpp`
- [Windows plugins](https://github.com/mateusrodcosta/vidya_music/blob/main/windows/flutter/generated_plugin_registrant.h): `windows/flutter/generated_plugin_registrant.h`
- [Linux entry](https://github.com/mateusrodcosta/vidya_music/blob/main/linux/runner/main.cc): `linux/runner/main.cc`
- [Linux application](https://github.com/mateusrodcosta/vidya_music/blob/main/linux/runner/my_application.cc): `linux/runner/my_application.cc`
- [Linux plugins](https://github.com/mateusrodcosta/vidya_music/blob/main/linux/flutter/generated_plugin_registrant.h): `linux/flutter/generated_plugin_registrant.h`
- [iOS app delegate](https://github.com/mateusrodcosta/vidya_music/blob/main/ios/Runner/AppDelegate.swift): `ios/Runner/AppDelegate.swift`
- [macOS plugins](https://github.com/mateusrodcosta/vidya_music/blob/main/macos/Flutter/GeneratedPluginRegistrant.swift): `macos/Flutter/GeneratedPluginRegistrant.swift`

### Other components

- **Listener**

## Connections

- Listener → App entry: opens
- App entry → Main page: starts
- Main page → App drawer: shows
- App drawer → Settings: opens
- Settings → Settings provider: uses
- Main page → Playlist state: presents
- Playlist state → Roster list: renders
- Roster list → Track item: renders
- Playlist state → Roster loading: loads
- Roster loading → Playlist repositories: uses
- Playlist state → Config and roster: loads config
- Config and roster → Playlist repositories: uses
- Vidya playlist → Playlist repositories: provides playlist (evidence: `README.md`)
- Track item → Player state: selects track
- Player state → Audio service: controls
- Player controls → Player state: controls
- Mini player → Player state: controls
- Playback progress → Player state: shows progress
- Windows entry → Flutter window: creates (evidence: `windows/runner/main.cpp`)
- Windows entry → Win32 window: configures (evidence: `windows/runner/main.cpp`)
- Flutter window → Win32 window: inherits
- Linux entry → Linux application: runs (evidence: `linux/runner/main.cc`)
- Linux application → Linux plugins: registers plugins (evidence: `linux/runner/my_application.cc`)
- iOS app delegate → macOS plugins: registers plugins (evidence: `ios/Runner/AppDelegate.swift`)
