# brl1ng1337/schlag-den-atzen-soundboard architecture

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

- Interactive diagram: https://gitdiagram.com/brl1ng1337/schlag-den-atzen-soundboard
- Repository: https://github.com/brl1ng1337/schlag-den-atzen-soundboard

## Overview

This Flutter Android app provides a soundboard for a private gameshow, plus several game modes. The principal workflow is selecting an audio clip surfaced as a button and playing it; the README explicitly documents automatic button discovery for supported audio files. Game screens and audio internals are represented from the source tree, but their call relationships could not be verified from the excerpts, so those links are dashed and unevidenced.

Main entry points: [`lib/features/games/games_overview.dart`](https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/features/games/games_overview.dart) (Games overview), [`lib/screens/soundboard_screen.dart`](https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/screens/soundboard_screen.dart) (Soundboard screen), [`lib/main.dart`](https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/main.dart) (Flutter entry), [`lib/services/audio_asset_service.dart`](https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/services/audio_asset_service.dart) (Audio asset service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App Shell"]
  node_entry["Flutter entry<br/>[main.dart]"]
  node_theme["App theme<br/>[app_theme.dart]"]
end

subgraph group_sound["Soundboard"]
  node_sound_screen["Soundboard screen"]
  node_asset_service["Audio asset service"]
  node_audio_assets["Audio files"]
  node_track["Audio track model<br/>[audio_track.dart]"]
  node_audio_controller["Audio controller"]
  node_audio_widget["Bottom audio player"]
  node_sound_button["Sound button<br/>[sound_button.dart]"]
end

subgraph group_games["Game Modes"]
  node_overview["Games overview"]
  node_blam_screen["Blamieren game"]
  node_estimate_screen["Estimation game"]
  node_memory_screen["Memory game"]
  node_stop_screen["Stop the time"]
  node_who_screen["Who is it"]
end

subgraph group_content["Game Content"]
  node_blam_repo["Blamieren questions"]
  node_blam_data["Blamieren questions data<br/>[questions.json]"]
  node_estimate_repo["Estimation questions"]
  node_estimate_data["Estimation data"]
  node_who_repo["People repository"]
  node_who_data["People data<br/>[people.json]"]
end

node_host["Android host<br/>[MainActivity.kt]"]
node_player(("Gameshow user"))

node_player -.->|"opens app"| node_entry
node_host -.->|"hosts Flutter"| node_entry
node_entry -.->|"opens"| node_sound_screen
node_entry -.->|"opens"| node_overview
node_entry -.->|"uses"| node_theme
node_player -.->|"selects sound"| node_sound_screen
node_sound_screen -.->|"loads sounds"| node_asset_service
node_asset_service -->|"discovers files"| node_audio_assets
node_sound_screen -->|"shows buttons"| node_sound_button
node_sound_screen -.->|"uses tracks"| node_track
node_sound_screen -.->|"shows player"| node_audio_widget
node_audio_widget -.->|"controls playback"| node_audio_controller
node_overview -.->|"opens game"| node_blam_screen
node_overview -.->|"opens game"| node_estimate_screen
node_overview -.->|"opens game"| node_memory_screen
node_overview -.->|"opens game"| node_stop_screen
node_overview -.->|"opens game"| node_who_screen
node_blam_screen -.->|"requests questions"| node_blam_repo
node_blam_repo -.->|"reads questions"| node_blam_data
node_estimate_screen -.->|"requests questions"| node_estimate_repo
node_estimate_repo -.->|"reads questions"| node_estimate_data
node_who_screen -.->|"requests entries"| node_who_repo
node_who_repo -.->|"reads people"| node_who_data

click node_host "https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/android/app/src/main/kotlin/de/privategameshow/soundboard/MainActivity.kt"
click node_entry "https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/main.dart"
click node_theme "https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/theme/app_theme.dart"
click node_overview "https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/features/games/games_overview.dart"
click node_sound_screen "https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/screens/soundboard_screen.dart"
click node_asset_service "https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/services/audio_asset_service.dart"
click node_audio_assets "https://github.com/brl1ng1337/schlag-den-atzen-soundboard/tree/master/assets/audio"
click node_track "https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/models/audio_track.dart"
click node_audio_controller "https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/controllers/audio_player_controller.dart"
click node_audio_widget "https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/widgets/bottom_audio_player.dart"
click node_sound_button "https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/widgets/sound_button.dart"
click node_blam_screen "https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/features/games/blamieren_oder_kassieren/blamieren_oder_kassieren_screen.dart"
click node_blam_repo "https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/features/games/blamieren_oder_kassieren/blamieren_questions_repository.dart"
click node_blam_data "https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/assets/games/blamieren_oder_kassieren/questions.json"
click node_estimate_screen "https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/features/games/estimation/estimation_game_screen.dart"
click node_estimate_repo "https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/features/games/estimation/estimate_questions_repository.dart"
click node_estimate_data "https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/assets/games/estimate_questions.json"
click node_memory_screen "https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/features/games/memory_items/memory_items_screen.dart"
click node_stop_screen "https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/features/games/stop_the_time/stop_the_time_screen.dart"
click node_who_screen "https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/features/games/who_is_it/who_is_it_screen.dart"
click node_who_repo "https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/features/games/who_is_it/who_is_it_repository.dart"
click node_who_data "https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/assets/games/who_is_it/people.json"

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_theme,node_player toneBlue
class node_sound_screen,node_asset_service,node_audio_assets,node_track,node_audio_controller,node_audio_widget,node_sound_button toneAmber
class node_overview,node_blam_screen,node_estimate_screen,node_memory_screen,node_stop_screen,node_who_screen toneMint
class node_blam_repo,node_blam_data,node_estimate_repo,node_estimate_data,node_who_repo,node_who_data toneRose
class node_host toneTeal
```

## Components

### App Shell

- [Flutter entry](https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/main.dart): `lib/main.dart`
- [App theme](https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/theme/app_theme.dart): `lib/theme/app_theme.dart`

### Soundboard

- [Soundboard screen](https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/screens/soundboard_screen.dart): `lib/screens/soundboard_screen.dart`
- [Audio asset service](https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/services/audio_asset_service.dart): `lib/services/audio_asset_service.dart`
- [Audio files](https://github.com/brl1ng1337/schlag-den-atzen-soundboard/tree/master/assets/audio): `assets/audio`
- [Audio track model](https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/models/audio_track.dart): `lib/models/audio_track.dart`
- [Audio controller](https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/controllers/audio_player_controller.dart): `lib/controllers/audio_player_controller.dart`
- [Bottom audio player](https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/widgets/bottom_audio_player.dart): `lib/widgets/bottom_audio_player.dart`
- [Sound button](https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/widgets/sound_button.dart): `lib/widgets/sound_button.dart`

### Game Modes

- [Games overview](https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/features/games/games_overview.dart): `lib/features/games/games_overview.dart`
- [Blamieren game](https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/features/games/blamieren_oder_kassieren/blamieren_oder_kassieren_screen.dart): `lib/features/games/blamieren_oder_kassieren/blamieren_oder_kassieren_screen.dart`
- [Estimation game](https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/features/games/estimation/estimation_game_screen.dart): `lib/features/games/estimation/estimation_game_screen.dart`
- [Memory game](https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/features/games/memory_items/memory_items_screen.dart): `lib/features/games/memory_items/memory_items_screen.dart`
- [Stop the time](https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/features/games/stop_the_time/stop_the_time_screen.dart): `lib/features/games/stop_the_time/stop_the_time_screen.dart`
- [Who is it](https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/features/games/who_is_it/who_is_it_screen.dart): `lib/features/games/who_is_it/who_is_it_screen.dart`

### Game Content

- [Blamieren questions](https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/features/games/blamieren_oder_kassieren/blamieren_questions_repository.dart): `lib/features/games/blamieren_oder_kassieren/blamieren_questions_repository.dart`
- [Blamieren questions data](https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/assets/games/blamieren_oder_kassieren/questions.json): `assets/games/blamieren_oder_kassieren/questions.json`
- [Estimation questions](https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/features/games/estimation/estimate_questions_repository.dart): `lib/features/games/estimation/estimate_questions_repository.dart`
- [Estimation data](https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/assets/games/estimate_questions.json): `assets/games/estimate_questions.json`
- [People repository](https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/lib/features/games/who_is_it/who_is_it_repository.dart): `lib/features/games/who_is_it/who_is_it_repository.dart`
- [People data](https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/assets/games/who_is_it/people.json): `assets/games/who_is_it/people.json`

### Other components

- [Android host](https://github.com/brl1ng1337/schlag-den-atzen-soundboard/blob/master/android/app/src/main/kotlin/de/privategameshow/soundboard/MainActivity.kt): `android/app/src/main/kotlin/de/privategameshow/soundboard/MainActivity.kt`
- **Gameshow user**

## Connections

- Gameshow user → Flutter entry: opens app
- Android host → Flutter entry: hosts Flutter
- Flutter entry → Soundboard screen: opens
- Flutter entry → Games overview: opens
- Flutter entry → App theme: uses
- Gameshow user → Soundboard screen: selects sound
- Soundboard screen → Audio asset service: loads sounds
- Audio asset service → Audio files: discovers files (evidence: `README.md`)
- Soundboard screen → Sound button: shows buttons (evidence: `README.md`)
- Soundboard screen → Audio track model: uses tracks
- Soundboard screen → Bottom audio player: shows player
- Bottom audio player → Audio controller: controls playback
- Games overview → Blamieren game: opens game
- Games overview → Estimation game: opens game
- Games overview → Memory game: opens game
- Games overview → Stop the time: opens game
- Games overview → Who is it: opens game
- Blamieren game → Blamieren questions: requests questions
- Blamieren questions → Blamieren questions data: reads questions
- Estimation game → Estimation questions: requests questions
- Estimation questions → Estimation data: reads questions
- Who is it → People repository: requests entries
- People repository → People data: reads people
