# piappstudio/biggboss architecture

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

- Interactive diagram: https://gitdiagram.com/piappstudio/biggboss
- Repository: https://github.com/piappstudio/biggboss

## Overview

Bigg Boss Tamil 7 Live Voting is a Compose Multiplatform app for browsing shows, episode details, contestant histories, voting information, trends, and charts. The main user flow starts at the shared app, loads the show list, opens a show, and fetches detail and trend data for its screens. Shared screens and view models sit above a repository that uses HTTP and local caching; platform entry points and native adapters support Android, desktop, and iOS. The README confirms home, contestant-list, and trending views. Some subsystem links are omitted where source was not sampled.

Main entry points: [`shared/src/commonMain/kotlin/network/PiRepository.kt`](https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/network/PiRepository.kt) (Pi repository), [`shared/src/commonMain/kotlin/App.kt`](https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/App.kt) (Shared app), [`shared/src/commonMain/kotlin/ui/home/HomeScreen.kt`](https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/ui/home/HomeScreen.kt) (Show browser), [`shared/src/commonMain/kotlin/ui/detail/ShowDetailScreen.kt`](https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/ui/detail/ShowDetailScreen.kt) (Episode detail)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry"]
  node_android["Android launcher<br/>[MainActivity.kt]"]
  node_desktop["Desktop launcher<br/>[main.kt]"]
  node_ios["iOS launcher<br/>[ContentView.swift]"]
  node_app["Shared app<br/>[App.kt]"]
end

subgraph group_experience["Show experience"]
  node_home["Show browser<br/>[HomeScreen.kt]"]
  node_homevm["Home state<br/>[HomeScreenModel.kt]"]
  node_detail["Episode detail"]
  node_detailvm["Episode state<br/>[ShowDetailModel.kt]"]
  node_participant["Contestant detail"]
  node_chart["Trend charts<br/>[ChartScreen.kt]"]
  node_chartdraw["Bar renderer<br/>[RenderBarChart.kt]"]
  node_voting["Voting options"]
  node_historygraph["Performance graph"]
end

subgraph group_data["Data and models"]
  node_repo["Pi repository<br/>[PiRepository.kt]"]
  node_models["Show data models<br/>[ShowDetail.kt]"]
  node_showlist["Show list model<br/>[ShowList.kt]"]
  node_votingmodel["Voting model<br/>[VotingOption.kt]"]
  node_resource["API result states<br/>[Resource.kt]"]
end

subgraph group_platform["Platform services"]
  node_analytics["Analytics contract<br/>[AnalyticLogger.kt]"]
  node_link["Link launcher<br/>[LinkLauncher.kt]"]
  node_cache["Platform cache<br/>[CacheUtil.kt]"]
end

node_api{{"Show data API"}}

node_android -->|"launches"| node_app
node_desktop -->|"launches"| node_app
node_ios -->|"hosts"| node_app
node_app -->|"starts at"| node_home
node_home -->|"loads state"| node_homevm
node_home -->|"opens show"| node_detail
node_homevm -->|"fetches shows"| node_repo
node_detail -->|"requests episode data"| node_detailvm
node_detailvm -->|"fetches details"| node_repo
node_detail -->|"shows chart tab"| node_chart
node_chart -->|"requests show data"| node_detailvm
node_chart -->|"renders bars"| node_chartdraw
node_participant -->|"renders voting"| node_voting
node_participant -->|"renders performance"| node_historygraph
node_repo -->|"requests data"| node_api
node_repo -->|"reads and writes"| node_cache
node_repo -->|"emits results"| node_resource
node_repo -->|"decodes details"| node_models
node_repo -->|"decodes shows"| node_showlist
node_models -->|"includes voting"| node_votingmodel

click node_android "https://github.com/piappstudio/biggboss/blob/main/androidApp/src/androidMain/kotlin/com/biggboss/MainActivity.kt"
click node_desktop "https://github.com/piappstudio/biggboss/blob/main/desktopApp/src/jvmMain/kotlin/main.kt"
click node_ios "https://github.com/piappstudio/biggboss/blob/main/iosApp/iosApp/ContentView.swift"
click node_app "https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/App.kt"
click node_home "https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/ui/home/HomeScreen.kt"
click node_homevm "https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/ui/home/HomeScreenModel.kt"
click node_detail "https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/ui/detail/ShowDetailScreen.kt"
click node_detailvm "https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/ui/detail/ShowDetailModel.kt"
click node_participant "https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/ui/participant/ParticipantDetailScreen.kt"
click node_chart "https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/ui/chart/ChartScreen.kt"
click node_chartdraw "https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/ui/chart/RenderBarChart.kt"
click node_voting "https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/ui/participant/RenderVotingOption.kt"
click node_historygraph "https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/ui/participant/RenderPerformanceGraph.kt"
click node_repo "https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/network/PiRepository.kt"
click node_models "https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/model/ShowDetail.kt"
click node_showlist "https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/model/ShowList.kt"
click node_votingmodel "https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/model/VotingOption.kt"
click node_resource "https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/network/Resource.kt"
click node_analytics "https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/analytics/AnalyticLogger.kt"
click node_link "https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/ui/native/LinkLauncher.kt"
click node_cache "https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/ui/native/CacheUtil.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_android,node_desktop,node_ios,node_app toneBlue
class node_home,node_homevm,node_detail,node_detailvm,node_participant,node_chart,node_chartdraw,node_voting,node_historygraph toneAmber
class node_repo,node_models,node_showlist,node_votingmodel,node_resource,node_api toneMint
class node_analytics,node_link,node_cache toneRose
```

## Components

### App entry

- [Android launcher](https://github.com/piappstudio/biggboss/blob/main/androidApp/src/androidMain/kotlin/com/biggboss/MainActivity.kt): `androidApp/src/androidMain/kotlin/com/biggboss/MainActivity.kt`
- [Desktop launcher](https://github.com/piappstudio/biggboss/blob/main/desktopApp/src/jvmMain/kotlin/main.kt): `desktopApp/src/jvmMain/kotlin/main.kt`
- [iOS launcher](https://github.com/piappstudio/biggboss/blob/main/iosApp/iosApp/ContentView.swift): `iosApp/iosApp/ContentView.swift`
- [Shared app](https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/App.kt): `shared/src/commonMain/kotlin/App.kt`

### Show experience

- [Show browser](https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/ui/home/HomeScreen.kt): `shared/src/commonMain/kotlin/ui/home/HomeScreen.kt`
- [Home state](https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/ui/home/HomeScreenModel.kt): `shared/src/commonMain/kotlin/ui/home/HomeScreenModel.kt`
- [Episode detail](https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/ui/detail/ShowDetailScreen.kt): `shared/src/commonMain/kotlin/ui/detail/ShowDetailScreen.kt`
- [Episode state](https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/ui/detail/ShowDetailModel.kt): `shared/src/commonMain/kotlin/ui/detail/ShowDetailModel.kt`
- [Contestant detail](https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/ui/participant/ParticipantDetailScreen.kt): `shared/src/commonMain/kotlin/ui/participant/ParticipantDetailScreen.kt`
- [Trend charts](https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/ui/chart/ChartScreen.kt): `shared/src/commonMain/kotlin/ui/chart/ChartScreen.kt`
- [Bar renderer](https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/ui/chart/RenderBarChart.kt): `shared/src/commonMain/kotlin/ui/chart/RenderBarChart.kt`
- [Voting options](https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/ui/participant/RenderVotingOption.kt): `shared/src/commonMain/kotlin/ui/participant/RenderVotingOption.kt`
- [Performance graph](https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/ui/participant/RenderPerformanceGraph.kt): `shared/src/commonMain/kotlin/ui/participant/RenderPerformanceGraph.kt`

### Data and models

- [Pi repository](https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/network/PiRepository.kt): `shared/src/commonMain/kotlin/network/PiRepository.kt`
- [Show data models](https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/model/ShowDetail.kt): `shared/src/commonMain/kotlin/model/ShowDetail.kt`
- [Show list model](https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/model/ShowList.kt): `shared/src/commonMain/kotlin/model/ShowList.kt`
- [Voting model](https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/model/VotingOption.kt): `shared/src/commonMain/kotlin/model/VotingOption.kt`
- [API result states](https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/network/Resource.kt): `shared/src/commonMain/kotlin/network/Resource.kt`

### Platform services

- [Analytics contract](https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/analytics/AnalyticLogger.kt): `shared/src/commonMain/kotlin/analytics/AnalyticLogger.kt`
- [Link launcher](https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/ui/native/LinkLauncher.kt): `shared/src/commonMain/kotlin/ui/native/LinkLauncher.kt`
- [Platform cache](https://github.com/piappstudio/biggboss/blob/main/shared/src/commonMain/kotlin/ui/native/CacheUtil.kt): `shared/src/commonMain/kotlin/ui/native/CacheUtil.kt`

### Other components

- **Show data API**

## Connections

- Android launcher → Shared app: launches
- Desktop launcher → Shared app: launches
- iOS launcher → Shared app: hosts
- Shared app → Show browser: starts at (evidence: `shared/src/commonMain/kotlin/App.kt`)
- Show browser → Home state: loads state (evidence: `shared/src/commonMain/kotlin/ui/home/HomeScreen.kt`)
- Show browser → Episode detail: opens show (evidence: `shared/src/commonMain/kotlin/ui/home/HomeScreen.kt`)
- Home state → Pi repository: fetches shows (evidence: `shared/src/commonMain/kotlin/ui/home/HomeScreenModel.kt`)
- Episode detail → Episode state: requests episode data (evidence: `shared/src/commonMain/kotlin/ui/detail/ShowDetailScreen.kt`)
- Episode state → Pi repository: fetches details (evidence: `shared/src/commonMain/kotlin/ui/detail/ShowDetailModel.kt`)
- Episode detail → Trend charts: shows chart tab (evidence: `shared/src/commonMain/kotlin/ui/detail/ShowDetailScreen.kt`)
- Trend charts → Episode state: requests show data (evidence: `shared/src/commonMain/kotlin/ui/chart/ChartScreen.kt`)
- Trend charts → Bar renderer: renders bars (evidence: `shared/src/commonMain/kotlin/ui/chart/ChartScreen.kt`)
- Contestant detail → Voting options: renders voting (evidence: `shared/src/commonMain/kotlin/ui/participant/ParticipantDetailScreen.kt`)
- Contestant detail → Performance graph: renders performance (evidence: `shared/src/commonMain/kotlin/ui/participant/ParticipantDetailScreen.kt`)
- Pi repository → Show data API: requests data (evidence: `shared/src/commonMain/kotlin/network/PiRepository.kt`)
- Pi repository → Platform cache: reads and writes (evidence: `shared/src/commonMain/kotlin/network/PiRepository.kt`)
- Pi repository → API result states: emits results (evidence: `shared/src/commonMain/kotlin/network/PiRepository.kt`)
- Pi repository → Show data models: decodes details (evidence: `shared/src/commonMain/kotlin/network/PiRepository.kt`)
- Pi repository → Show list model: decodes shows (evidence: `shared/src/commonMain/kotlin/network/PiRepository.kt`)
- Show data models → Voting model: includes voting (evidence: `shared/src/commonMain/kotlin/model/ShowDetail.kt`)
