# ilker-binzet/tuikio architecture

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

- Interactive diagram: https://gitdiagram.com/ilker-binzet/tuikio
- Repository: https://github.com/ilker-binzet/tuikio

## Overview

Tuikio is an Android catalog, installer, and player for bundled terminal games, with optional online play and a community submission/review service. The main user path is Discover/search → game details and installation → Library → a real PTY-backed game session rendered by the terminal emulator with per-game controls. Community suggestions and publishing form a separate reviewed-submission flow. The graph preserves documented capabilities, but several app screens and data components were not sampled, so some relationships are omitted rather than inferred.

Main entry points: [`app/src/main/kotlin/dev/tuikio/app/game/GameActivity.kt`](https://github.com/ilker-binzet/tuikio/blob/main/app/src/main/kotlin/dev/tuikio/app/game/GameActivity.kt) (Game screen), [`backend/src/main/kotlin/dev/tuikio/backend/Server.kt`](https://github.com/ilker-binzet/tuikio/blob/main/backend/src/main/kotlin/dev/tuikio/backend/Server.kt) (Community API), [`app/src/main/kotlin/dev/tuikio/app/MainActivity.kt`](https://github.com/ilker-binzet/tuikio/blob/main/app/src/main/kotlin/dev/tuikio/app/MainActivity.kt) (App navigation), [`app/src/main/kotlin/dev/tuikio/app/screens/DiscoverScreen.kt`](https://github.com/ilker-binzet/tuikio/blob/main/app/src/main/kotlin/dev/tuikio/app/screens/DiscoverScreen.kt) (Discover and search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Android app"]
  node_entry["App navigation<br/>[MainActivity.kt]"]
  node_discover["Discover and search<br/>[DiscoverScreen.kt]"]
  node_details["Game details<br/>[DetailsScreen.kt]"]
  node_catalogrepo["Catalog data<br/>[Catalog.kt]"]
  node_installer["Game installation<br/>[Library.kt]"]
  node_library["Installed library<br/>[LibraryScreen.kt]"]
  node_brand["Brand studio<br/>[BrandManager.kt]"]
  node_sources[("Saved sources<br/>[Sources.kt]")]
end

subgraph group_game["Game runtime"]
  node_session["Game session<br/>[GameSession.kt]"]
  node_gameui["Game screen<br/>[GameActivity.kt]"]
  node_terminalview["Terminal view<br/>[TerminalView.kt]"]
  node_emulator["Terminal emulator"]
end

subgraph group_shared["Catalog and controls"]
  node_controls["Game controls<br/>[ControlProfile.kt]"]
  node_manifest["Game manifests<br/>[GameManifest.kt]"]
end

subgraph group_community["Community review"]
  node_create["Suggest or publish<br/>[CreateScreen.kt]"]
  node_publish["Publish flow<br/>[PublishScreen.kt]"]
  node_api["Community API<br/>[Server.kt]"]
  node_reviewbot["Review bot<br/>[ReviewBot.kt]"]
  node_store[("Submission records<br/>[Store.kt]")]
  node_communityclient["Community client<br/>[GitHubRest.kt]"]
end

node_player(("Player"))
node_github["GitHub"]
node_terminalgames["Bundled games"]
node_online["Public game servers"]

node_player -->|"opens"| node_entry
node_entry -->|"navigates to"| node_discover
node_discover -.->|"browses"| node_catalogrepo
node_discover -->|"opens game"| node_details
node_details -->|"installs"| node_installer
node_installer -->|"adds game"| node_library
node_library -->|"launches"| node_gameui
node_gameui -->|"starts session"| node_session
node_session -->|"runs via PTY"| node_terminalgames
node_session -->|"feeds output"| node_emulator
node_gameui -->|"renders terminal"| node_terminalview
node_terminalview -->|"renders screen"| node_emulator
node_gameui -->|"dispatches input"| node_controls
node_gameui -->|"loads game"| node_manifest
node_player -->|"customizes look"| node_brand
node_player -->|"suggests source"| node_create
node_player -->|"publishes game"| node_publish
node_create -->|"saves source"| node_sources
node_create -.->|"submits"| node_api
node_publish -.->|"submits"| node_api
node_api -->|"records submissions"| node_store
node_api -->|"starts bot"| node_reviewbot
node_reviewbot -->|"uses GitHub API"| node_communityclient
node_communityclient -->|"opens reviewed PRs"| node_github
node_player -.->|"plays optionally"| node_online
node_entry -->|"initializes"| node_catalogrepo

click node_entry "https://github.com/ilker-binzet/tuikio/blob/main/app/src/main/kotlin/dev/tuikio/app/MainActivity.kt"
click node_discover "https://github.com/ilker-binzet/tuikio/blob/main/app/src/main/kotlin/dev/tuikio/app/screens/DiscoverScreen.kt"
click node_details "https://github.com/ilker-binzet/tuikio/blob/main/app/src/main/kotlin/dev/tuikio/app/screens/DetailsScreen.kt"
click node_catalogrepo "https://github.com/ilker-binzet/tuikio/blob/main/app/src/main/kotlin/dev/tuikio/app/data/Catalog.kt"
click node_installer "https://github.com/ilker-binzet/tuikio/blob/main/app/src/main/kotlin/dev/tuikio/app/data/Library.kt"
click node_library "https://github.com/ilker-binzet/tuikio/blob/main/app/src/main/kotlin/dev/tuikio/app/screens/LibraryScreen.kt"
click node_brand "https://github.com/ilker-binzet/tuikio/blob/main/app/src/main/kotlin/dev/tuikio/app/brand/BrandManager.kt"
click node_session "https://github.com/ilker-binzet/tuikio/blob/main/core/runtime/src/main/kotlin/dev/tuikio/runtime/GameSession.kt"
click node_gameui "https://github.com/ilker-binzet/tuikio/blob/main/app/src/main/kotlin/dev/tuikio/app/game/GameActivity.kt"
click node_terminalview "https://github.com/ilker-binzet/tuikio/blob/main/app/src/main/kotlin/dev/tuikio/app/game/TerminalView.kt"
click node_emulator "https://github.com/ilker-binzet/tuikio/blob/main/core/terminal/src/main/kotlin/dev/tuikio/terminal/TerminalEmulator.kt"
click node_controls "https://github.com/ilker-binzet/tuikio/blob/main/core/controls/src/main/kotlin/dev/tuikio/controls/ControlProfile.kt"
click node_manifest "https://github.com/ilker-binzet/tuikio/blob/main/core/catalog/src/main/kotlin/dev/tuikio/catalog/GameManifest.kt"
click node_sources "https://github.com/ilker-binzet/tuikio/blob/main/app/src/main/kotlin/dev/tuikio/app/data/Sources.kt"
click node_create "https://github.com/ilker-binzet/tuikio/blob/main/app/src/main/kotlin/dev/tuikio/app/screens/CreateScreen.kt"
click node_publish "https://github.com/ilker-binzet/tuikio/blob/main/app/src/main/kotlin/dev/tuikio/app/screens/PublishScreen.kt"
click node_api "https://github.com/ilker-binzet/tuikio/blob/main/backend/src/main/kotlin/dev/tuikio/backend/Server.kt"
click node_reviewbot "https://github.com/ilker-binzet/tuikio/blob/main/backend/src/main/kotlin/dev/tuikio/backend/ReviewBot.kt"
click node_store "https://github.com/ilker-binzet/tuikio/blob/main/backend/src/main/kotlin/dev/tuikio/backend/Store.kt"
click node_communityclient "https://github.com/ilker-binzet/tuikio/blob/main/core/community/src/main/kotlin/dev/tuikio/community/GitHubRest.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_discover,node_details,node_catalogrepo,node_installer,node_library,node_brand,node_sources toneBlue
class node_session,node_gameui,node_terminalview,node_emulator toneAmber
class node_controls,node_manifest,node_online toneMint
class node_create,node_publish,node_api,node_reviewbot,node_store,node_communityclient toneRose
class node_player,node_github,node_terminalgames toneIndigo
```

## Components

### Android app

- [App navigation](https://github.com/ilker-binzet/tuikio/blob/main/app/src/main/kotlin/dev/tuikio/app/MainActivity.kt): `app/src/main/kotlin/dev/tuikio/app/MainActivity.kt`
- [Discover and search](https://github.com/ilker-binzet/tuikio/blob/main/app/src/main/kotlin/dev/tuikio/app/screens/DiscoverScreen.kt): `app/src/main/kotlin/dev/tuikio/app/screens/DiscoverScreen.kt`
- [Game details](https://github.com/ilker-binzet/tuikio/blob/main/app/src/main/kotlin/dev/tuikio/app/screens/DetailsScreen.kt): `app/src/main/kotlin/dev/tuikio/app/screens/DetailsScreen.kt`
- [Catalog data](https://github.com/ilker-binzet/tuikio/blob/main/app/src/main/kotlin/dev/tuikio/app/data/Catalog.kt): `app/src/main/kotlin/dev/tuikio/app/data/Catalog.kt`
- [Game installation](https://github.com/ilker-binzet/tuikio/blob/main/app/src/main/kotlin/dev/tuikio/app/data/Library.kt): `app/src/main/kotlin/dev/tuikio/app/data/Library.kt`
- [Installed library](https://github.com/ilker-binzet/tuikio/blob/main/app/src/main/kotlin/dev/tuikio/app/screens/LibraryScreen.kt): `app/src/main/kotlin/dev/tuikio/app/screens/LibraryScreen.kt`
- [Brand studio](https://github.com/ilker-binzet/tuikio/blob/main/app/src/main/kotlin/dev/tuikio/app/brand/BrandManager.kt): `app/src/main/kotlin/dev/tuikio/app/brand/BrandManager.kt`
- [Saved sources](https://github.com/ilker-binzet/tuikio/blob/main/app/src/main/kotlin/dev/tuikio/app/data/Sources.kt): `app/src/main/kotlin/dev/tuikio/app/data/Sources.kt`

### Game runtime

- [Game session](https://github.com/ilker-binzet/tuikio/blob/main/core/runtime/src/main/kotlin/dev/tuikio/runtime/GameSession.kt): `core/runtime/src/main/kotlin/dev/tuikio/runtime/GameSession.kt`
- [Game screen](https://github.com/ilker-binzet/tuikio/blob/main/app/src/main/kotlin/dev/tuikio/app/game/GameActivity.kt): `app/src/main/kotlin/dev/tuikio/app/game/GameActivity.kt`
- [Terminal view](https://github.com/ilker-binzet/tuikio/blob/main/app/src/main/kotlin/dev/tuikio/app/game/TerminalView.kt): `app/src/main/kotlin/dev/tuikio/app/game/TerminalView.kt`
- [Terminal emulator](https://github.com/ilker-binzet/tuikio/blob/main/core/terminal/src/main/kotlin/dev/tuikio/terminal/TerminalEmulator.kt): `core/terminal/src/main/kotlin/dev/tuikio/terminal/TerminalEmulator.kt`

### Catalog and controls

- [Game controls](https://github.com/ilker-binzet/tuikio/blob/main/core/controls/src/main/kotlin/dev/tuikio/controls/ControlProfile.kt): `core/controls/src/main/kotlin/dev/tuikio/controls/ControlProfile.kt`
- [Game manifests](https://github.com/ilker-binzet/tuikio/blob/main/core/catalog/src/main/kotlin/dev/tuikio/catalog/GameManifest.kt): `core/catalog/src/main/kotlin/dev/tuikio/catalog/GameManifest.kt`

### Community review

- [Suggest or publish](https://github.com/ilker-binzet/tuikio/blob/main/app/src/main/kotlin/dev/tuikio/app/screens/CreateScreen.kt): `app/src/main/kotlin/dev/tuikio/app/screens/CreateScreen.kt`
- [Publish flow](https://github.com/ilker-binzet/tuikio/blob/main/app/src/main/kotlin/dev/tuikio/app/screens/PublishScreen.kt): `app/src/main/kotlin/dev/tuikio/app/screens/PublishScreen.kt`
- [Community API](https://github.com/ilker-binzet/tuikio/blob/main/backend/src/main/kotlin/dev/tuikio/backend/Server.kt): `backend/src/main/kotlin/dev/tuikio/backend/Server.kt`
- [Review bot](https://github.com/ilker-binzet/tuikio/blob/main/backend/src/main/kotlin/dev/tuikio/backend/ReviewBot.kt): `backend/src/main/kotlin/dev/tuikio/backend/ReviewBot.kt`
- [Submission records](https://github.com/ilker-binzet/tuikio/blob/main/backend/src/main/kotlin/dev/tuikio/backend/Store.kt): `backend/src/main/kotlin/dev/tuikio/backend/Store.kt`
- [Community client](https://github.com/ilker-binzet/tuikio/blob/main/core/community/src/main/kotlin/dev/tuikio/community/GitHubRest.kt): `core/community/src/main/kotlin/dev/tuikio/community/GitHubRest.kt`

### Other components

- **Player**
- **GitHub**
- **Bundled games**
- **Public game servers**

## Connections

- Player → App navigation: opens (evidence: `README.md`)
- App navigation → Discover and search: navigates to (evidence: `app/src/main/kotlin/dev/tuikio/app/MainActivity.kt`)
- Discover and search → Catalog data: browses
- Discover and search → Game details: opens game (evidence: `README.md`)
- Game details → Game installation: installs (evidence: `README.md`)
- Game installation → Installed library: adds game (evidence: `README.md`)
- Installed library → Game screen: launches (evidence: `README.md`)
- Game screen → Game session: starts session (evidence: `app/src/main/kotlin/dev/tuikio/app/game/GameActivity.kt`)
- Game session → Bundled games: runs via PTY (evidence: `README.md`)
- Game session → Terminal emulator: feeds output (evidence: `core/runtime/src/main/kotlin/dev/tuikio/runtime/GameSession.kt`)
- Game screen → Terminal view: renders terminal (evidence: `app/src/main/kotlin/dev/tuikio/app/game/GameActivity.kt`)
- Terminal view → Terminal emulator: renders screen (evidence: `app/src/main/kotlin/dev/tuikio/app/game/TerminalView.kt`)
- Game screen → Game controls: dispatches input (evidence: `app/src/main/kotlin/dev/tuikio/app/game/GameActivity.kt`)
- Game screen → Game manifests: loads game (evidence: `app/src/main/kotlin/dev/tuikio/app/game/GameActivity.kt`)
- Player → Brand studio: customizes look (evidence: `README.md`)
- Player → Suggest or publish: suggests source (evidence: `README.md`)
- Player → Publish flow: publishes game (evidence: `README.md`)
- Suggest or publish → Saved sources: saves source (evidence: `app/src/main/kotlin/dev/tuikio/app/screens/CreateScreen.kt`)
- Suggest or publish → Community API: submits
- Publish flow → Community API: submits
- Community API → Submission records: records submissions (evidence: `backend/src/main/kotlin/dev/tuikio/backend/Server.kt`)
- Community API → Review bot: starts bot (evidence: `backend/src/main/kotlin/dev/tuikio/backend/Server.kt`)
- Review bot → Community client: uses GitHub API (evidence: `backend/src/main/kotlin/dev/tuikio/backend/ReviewBot.kt`)
- Community client → GitHub: opens reviewed PRs (evidence: `README.md`)
- Player → Public game servers: plays optionally (evidence: `README.md`)
- App navigation → Catalog data: initializes
