# ndgiang02/sonix-music-app architecture

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

- Interactive diagram: https://gitdiagram.com/ndgiang02/sonix-music-app
- Repository: https://github.com/ndgiang02/sonix-music-app

## Overview

Sonix appears to be a Flutter music app: users enter through the app shell, browse or search music, and use a player; the tree also shows authentication, profiles, and upload. The README only says “A project,” and no Dart source was excerpted, so these product capabilities are inferred from filenames. Dashed, uncited edges indicate likely navigation or coordination, not verified calls; external services and persistence are omitted because their use is not evidenced.

Main entry points: [`lib/main.dart`](https://github.com/ndgiang02/sonix-music-app/blob/main/lib/main.dart) (App Entry), [`lib/features/presentation/main/main_screen.dart`](https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/presentation/main/main_screen.dart) (Main Screen), [`lib/features/presentation/home/home_screen.dart`](https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/presentation/home/home_screen.dart) (Home), [`lib/features/presentation/player/play_screen.dart`](https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/presentation/player/play_screen.dart) (Player Screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App Shell"]
  node_entry["App Entry<br/>[main.dart]"]
  node_main["Main Screen<br/>[main_screen.dart]"]
  node_navigation["Routes<br/>[routes.dart]"]
end

subgraph group_discovery["Music Discovery"]
  node_home["Home<br/>[home_screen.dart]"]
  node_search["Search<br/>[search_page.dart]"]
  node_song["Song View<br/>[song_widget.dart]"]
  node_playlist["Playlist View"]
end

subgraph group_playback["Music Playback"]
  node_player["Player Screen<br/>[play_screen.dart]"]
  node_player_controls["Player Controls"]
  node_mini_player["Mini Player"]
end

subgraph group_account["Account Features"]
  node_login["Login<br/>[login_screen.dart]"]
  node_signup["Sign Up<br/>[signup_screen.dart]"]
  node_profile["Profile"]
  node_upload["Upload<br/>[upload_page.dart]"]
end

subgraph group_shared["Shared State"]
  node_app_state["App State<br/>[app_cubit.dart]"]
  node_session["Session Storage"]
  node_user_model["User Model<br/>[user_model.dart]"]
end

node_user(("User"))

node_user -.->|"opens"| node_entry
node_entry -.->|"starts"| node_main
node_main -.->|"routes"| node_navigation
node_main -.->|"shows"| node_home
node_user -.->|"searches"| node_search
node_home -.->|"presents"| node_song
node_home -.->|"presents"| node_playlist
node_song -.->|"opens"| node_player
node_player -.->|"renders"| node_player_controls
node_player -.->|"minimizes to"| node_mini_player
node_user -.->|"signs in"| node_login
node_user -.->|"registers"| node_signup
node_user -.->|"views"| node_profile
node_user -.->|"uploads"| node_upload
node_login -.->|"uses"| node_session
node_profile -.->|"shows"| node_user_model
node_entry -.->|"initializes"| node_app_state

click node_entry "https://github.com/ndgiang02/sonix-music-app/blob/main/lib/main.dart"
click node_main "https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/presentation/main/main_screen.dart"
click node_navigation "https://github.com/ndgiang02/sonix-music-app/blob/main/lib/core/routing/routes.dart"
click node_home "https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/presentation/home/home_screen.dart"
click node_search "https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/presentation/search/search_page.dart"
click node_song "https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/presentation/home/widget/song_widget.dart"
click node_playlist "https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/presentation/home/widget/playlist_widget.dart"
click node_player "https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/presentation/player/play_screen.dart"
click node_player_controls "https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/presentation/player/widget/control_button.dart"
click node_mini_player "https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/presentation/miniplayer/miniplayer_page.dart"
click node_login "https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/presentation/auth/login/login_screen.dart"
click node_signup "https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/presentation/auth/signup/signup_screen.dart"
click node_profile "https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/presentation/profile/profile_screen.dart"
click node_upload "https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/presentation/upload/upload_page.dart"
click node_app_state "https://github.com/ndgiang02/sonix-music-app/blob/main/lib/core/state/cubit/app_cubit.dart"
click node_session "https://github.com/ndgiang02/sonix-music-app/blob/main/lib/core/storage/session_controller.dart"
click node_user_model "https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/data/models/user/user_model.dart"

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_main,node_navigation,node_user toneBlue
class node_home,node_search,node_song,node_playlist toneAmber
class node_player,node_player_controls,node_mini_player toneMint
class node_login,node_signup,node_profile,node_upload toneRose
class node_app_state,node_session,node_user_model toneIndigo
```

## Components

### App Shell

- [App Entry](https://github.com/ndgiang02/sonix-music-app/blob/main/lib/main.dart): `lib/main.dart`
- [Main Screen](https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/presentation/main/main_screen.dart): `lib/features/presentation/main/main_screen.dart`
- [Routes](https://github.com/ndgiang02/sonix-music-app/blob/main/lib/core/routing/routes.dart): `lib/core/routing/routes.dart`

### Music Discovery

- [Home](https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/presentation/home/home_screen.dart): `lib/features/presentation/home/home_screen.dart`
- [Search](https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/presentation/search/search_page.dart): `lib/features/presentation/search/search_page.dart`
- [Song View](https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/presentation/home/widget/song_widget.dart): `lib/features/presentation/home/widget/song_widget.dart`
- [Playlist View](https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/presentation/home/widget/playlist_widget.dart): `lib/features/presentation/home/widget/playlist_widget.dart`

### Music Playback

- [Player Screen](https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/presentation/player/play_screen.dart): `lib/features/presentation/player/play_screen.dart`
- [Player Controls](https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/presentation/player/widget/control_button.dart): `lib/features/presentation/player/widget/control_button.dart`
- [Mini Player](https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/presentation/miniplayer/miniplayer_page.dart): `lib/features/presentation/miniplayer/miniplayer_page.dart`

### Account Features

- [Login](https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/presentation/auth/login/login_screen.dart): `lib/features/presentation/auth/login/login_screen.dart`
- [Sign Up](https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/presentation/auth/signup/signup_screen.dart): `lib/features/presentation/auth/signup/signup_screen.dart`
- [Profile](https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/presentation/profile/profile_screen.dart): `lib/features/presentation/profile/profile_screen.dart`
- [Upload](https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/presentation/upload/upload_page.dart): `lib/features/presentation/upload/upload_page.dart`

### Shared State

- [App State](https://github.com/ndgiang02/sonix-music-app/blob/main/lib/core/state/cubit/app_cubit.dart): `lib/core/state/cubit/app_cubit.dart`
- [Session Storage](https://github.com/ndgiang02/sonix-music-app/blob/main/lib/core/storage/session_controller.dart): `lib/core/storage/session_controller.dart`
- [User Model](https://github.com/ndgiang02/sonix-music-app/blob/main/lib/features/data/models/user/user_model.dart): `lib/features/data/models/user/user_model.dart`

### Other components

- **User**

## Connections

- User → App Entry: opens
- App Entry → Main Screen: starts
- Main Screen → Routes: routes
- Main Screen → Home: shows
- User → Search: searches
- Home → Song View: presents
- Home → Playlist View: presents
- Song View → Player Screen: opens
- Player Screen → Player Controls: renders
- Player Screen → Mini Player: minimizes to
- User → Login: signs in
- User → Sign Up: registers
- User → Profile: views
- User → Upload: uploads
- Login → Session Storage: uses
- Profile → User Model: shows
- App Entry → App State: initializes
