How ilker-binzet/tuikio works
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: GameActivity.kt Game screen · Server.kt Community API · MainActivity.kt App navigation · DiscoverScreen.kt Discover and search
Components 24
Android app
- App navigation
app/src/main/kotlin/dev/tuikio/app/MainActivity.kt - Discover and search
app/src/main/kotlin/dev/tuikio/app/screens/DiscoverScreen.kt - Game details
app/src/main/kotlin/dev/tuikio/app/screens/DetailsScreen.kt - Catalog data
app/src/main/kotlin/dev/tuikio/app/data/Catalog.kt - Game installation
app/src/main/kotlin/dev/tuikio/app/data/Library.kt - Installed library
app/src/main/kotlin/dev/tuikio/app/screens/LibraryScreen.kt - Brand studio
app/src/main/kotlin/dev/tuikio/app/brand/BrandManager.kt - Saved sources
app/src/main/kotlin/dev/tuikio/app/data/Sources.kt
Game runtime
- Game session
core/runtime/src/main/kotlin/dev/tuikio/runtime/GameSession.kt - Game screen
app/src/main/kotlin/dev/tuikio/app/game/GameActivity.kt - Terminal view
app/src/main/kotlin/dev/tuikio/app/game/TerminalView.kt - Terminal emulator
core/terminal/src/main/kotlin/dev/tuikio/terminal/TerminalEmulator.kt
Catalog and controls
- Game controls
core/controls/src/main/kotlin/dev/tuikio/controls/ControlProfile.kt - Game manifests
core/catalog/src/main/kotlin/dev/tuikio/catalog/GameManifest.kt
Community review
- Suggest or publish
app/src/main/kotlin/dev/tuikio/app/screens/CreateScreen.kt - Publish flow
app/src/main/kotlin/dev/tuikio/app/screens/PublishScreen.kt - Community API
backend/src/main/kotlin/dev/tuikio/backend/Server.kt - Review bot
backend/src/main/kotlin/dev/tuikio/backend/ReviewBot.kt - Submission records
backend/src/main/kotlin/dev/tuikio/backend/Store.kt - Community client
core/community/src/main/kotlin/dev/tuikio/community/GitHubRest.kt
Other components
- Player
- GitHub
- Bundled games
- Public game servers
Connections 26
- Player → App navigation: opens
README.md - App navigation → Discover and search: navigates to
app/src/main/kotlin/dev/tuikio/app/MainActivity.kt - Discover and search → Catalog data: browses
- Discover and search → Game details: opens game
README.md - Game details → Game installation: installs
README.md - Game installation → Installed library: adds game
README.md - Installed library → Game screen: launches
README.md - Game screen → Game session: starts session
app/src/main/kotlin/dev/tuikio/app/game/GameActivity.kt - Game session → Bundled games: runs via PTY
README.md - Game session → Terminal emulator: feeds output
core/runtime/src/main/kotlin/dev/tuikio/runtime/GameSession.kt - Game screen → Terminal view: renders terminal
app/src/main/kotlin/dev/tuikio/app/game/GameActivity.kt - Terminal view → Terminal emulator: renders screen
app/src/main/kotlin/dev/tuikio/app/game/TerminalView.kt - Game screen → Game controls: dispatches input
app/src/main/kotlin/dev/tuikio/app/game/GameActivity.kt - Game screen → Game manifests: loads game
app/src/main/kotlin/dev/tuikio/app/game/GameActivity.kt - Player → Brand studio: customizes look
README.md - Player → Suggest or publish: suggests source
README.md - Player → Publish flow: publishes game
README.md - Suggest or publish → Saved sources: saves source
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
backend/src/main/kotlin/dev/tuikio/backend/Server.kt - Community API → Review bot: starts bot
backend/src/main/kotlin/dev/tuikio/backend/Server.kt - Review bot → Community client: uses GitHub API
backend/src/main/kotlin/dev/tuikio/backend/ReviewBot.kt - Community client → GitHub: opens reviewed PRs
README.md - Player → Public game servers: plays optionally
README.md - App navigation → Catalog data: initializes