# aswina1636/neomatchup architecture

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

- Interactive diagram: https://gitdiagram.com/aswina1636/neomatchup
- Repository: https://github.com/aswina1636/neomatchup

## Overview

NeoMatchup is a Tkinter multi-game hub. Players launch games from the hub, play locally or online, and build profiles, achievements and NeoCoins that can be spent in the shop. The graph preserves the ten-game roster and documented profile, settings, shop and achievement capabilities. Source visibility is incomplete: the hub's principal implementation is loaded from bytecode, and several page and game internals are unsampled; those subsystems are shown without guessed call paths.

Main entry points: [`games/base_game.py`](https://github.com/aswina1636/neomatchup/blob/main/games/base_game.py) (Game framework), [`multiplayer/client.py`](https://github.com/aswina1636/neomatchup/blob/main/multiplayer/client.py) (Relay client), [`core/storage.py`](https://github.com/aswina1636/neomatchup/blob/main/core/storage.py) (JSON storage), [`games/chess.py`](https://github.com/aswina1636/neomatchup/blob/main/games/chess.py) (Chess)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Hub and UI"]
  node_entry["Application entry<br/>[main.py]"]
  node_hub["Game hub<br/>[hub.py]"]
  node_theme["Theme engine<br/>[theme.py]"]
  node_animations["Canvas animations<br/>[animations.py]"]
  node_sounds["Sound effects<br/>[sounds.py]"]
end

subgraph group_games["Game Play"]
  node_base["Game framework<br/>[base_game.py]"]
  node_roster["Game roster"]
  node_chess["Chess<br/>[chess.py]"]
  node_connect4["Connect Four<br/>[connect_four.py]"]
  node_game2048["2048<br/>[game2048.py]"]
  node_memory["Memory Match<br/>[memory_match.py]"]
  node_minesweeper["Minesweeper<br/>[minesweeper.py]"]
  node_roulette["Roulette<br/>[roulette.py]"]
  node_snake["Snake<br/>[snake.py]"]
  node_sudoku["Sudoku<br/>[sudoku.py]"]
  node_tictactoe["Tic-Tac-Toe<br/>[tictactoe.py]"]
  node_wordle["Wordle<br/>[wordle.py]"]
end

subgraph group_player["Player Progress"]
  node_profile["Player profile<br/>[profile.py]"]
  node_shop["NeoCoin shop<br/>[bank_shop.py]"]
  node_achievements_page["Achievements page"]
  node_settings["Settings<br/>[settings.py]"]
  node_storage[("JSON storage<br/>[storage.py]")]
  node_bankroll["NeoCoin economy<br/>[bankroll.py]"]
  node_achievements["Achievement rules<br/>[achievements.py]"]
end

subgraph group_network["Online Play"]
  node_client["Relay client<br/>[client.py]"]
  node_server["Relay server<br/>[server.py]"]
  node_connect_codes["Connect codes<br/>[utils.py]"]
  node_roulette_patch["Online roulette extension<br/>[roulette_patch.py]"]
end

node_player_actor(("Player"))
node_friend(("Remote player"))

node_player_actor -->|"launches"| node_entry
node_entry -->|"loads hub"| node_hub
node_hub -.->|"offers games"| node_roster
node_roster -.->|"shares framework"| node_base
node_base -.->|"uses"| node_theme
node_base -->|"accesses"| node_storage
node_base -->|"accesses"| node_bankroll
node_base -->|"checks"| node_achievements
node_base -->|"accesses"| node_sounds
node_chess -->|"inherits"| node_base
node_connect4 -.->|"inherits"| node_base
node_game2048 -.->|"inherits"| node_base
node_memory -.->|"inherits"| node_base
node_minesweeper -.->|"inherits"| node_base
node_roulette -->|"inherits"| node_base
node_snake -.->|"inherits"| node_base
node_sudoku -.->|"inherits"| node_base
node_tictactoe -.->|"inherits"| node_base
node_wordle -.->|"inherits"| node_base
node_profile -->|"reads and saves"| node_storage
node_shop -.->|"spends coins"| node_bankroll
node_achievements_page -.->|"shows progress"| node_achievements
node_settings -.->|"persists settings"| node_storage
node_player_actor -.->|"navigates"| node_hub
node_friend -.->|"connects online"| node_client
node_client -.->|"sends messages"| node_server
node_server -->|"relays messages"| node_friend
node_client -.->|"uses codes"| node_connect_codes
node_chess -->|"sends moves"| node_client
node_chess -->|"displays code"| node_connect_codes
node_roulette -->|"wagers coins"| node_bankroll
node_roulette_patch -->|"extends"| node_roulette
node_roulette_patch -->|"syncs rounds"| node_client
node_base -->|"records stats"| node_storage
node_profile -.->|"styles page"| node_theme
node_roster -.->|"animates play"| node_animations

click node_entry "https://github.com/aswina1636/neomatchup/blob/main/main.py"
click node_hub "https://github.com/aswina1636/neomatchup/blob/main/hub.py"
click node_base "https://github.com/aswina1636/neomatchup/blob/main/games/base_game.py"
click node_roster "https://github.com/aswina1636/neomatchup/tree/main/games"
click node_chess "https://github.com/aswina1636/neomatchup/blob/main/games/chess.py"
click node_connect4 "https://github.com/aswina1636/neomatchup/blob/main/games/connect_four.py"
click node_game2048 "https://github.com/aswina1636/neomatchup/blob/main/games/game2048.py"
click node_memory "https://github.com/aswina1636/neomatchup/blob/main/games/memory_match.py"
click node_minesweeper "https://github.com/aswina1636/neomatchup/blob/main/games/minesweeper.py"
click node_roulette "https://github.com/aswina1636/neomatchup/blob/main/games/roulette.py"
click node_snake "https://github.com/aswina1636/neomatchup/blob/main/games/snake.py"
click node_sudoku "https://github.com/aswina1636/neomatchup/blob/main/games/sudoku.py"
click node_tictactoe "https://github.com/aswina1636/neomatchup/blob/main/games/tictactoe.py"
click node_wordle "https://github.com/aswina1636/neomatchup/blob/main/games/wordle.py"
click node_profile "https://github.com/aswina1636/neomatchup/blob/main/pages/profile.py"
click node_shop "https://github.com/aswina1636/neomatchup/blob/main/pages/bank_shop.py"
click node_achievements_page "https://github.com/aswina1636/neomatchup/blob/main/pages/achievements_page.py"
click node_settings "https://github.com/aswina1636/neomatchup/blob/main/pages/settings.py"
click node_storage "https://github.com/aswina1636/neomatchup/blob/main/core/storage.py"
click node_bankroll "https://github.com/aswina1636/neomatchup/blob/main/core/bankroll.py"
click node_achievements "https://github.com/aswina1636/neomatchup/blob/main/core/achievements.py"
click node_theme "https://github.com/aswina1636/neomatchup/blob/main/core/theme.py"
click node_animations "https://github.com/aswina1636/neomatchup/blob/main/core/animations.py"
click node_sounds "https://github.com/aswina1636/neomatchup/blob/main/core/sounds.py"
click node_client "https://github.com/aswina1636/neomatchup/blob/main/multiplayer/client.py"
click node_server "https://github.com/aswina1636/neomatchup/blob/main/multiplayer/server.py"
click node_connect_codes "https://github.com/aswina1636/neomatchup/blob/main/multiplayer/utils.py"
click node_roulette_patch "https://github.com/aswina1636/neomatchup/blob/main/roulette_patch.py"

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_hub,node_theme,node_animations,node_sounds toneBlue
class node_base,node_roster,node_chess,node_connect4,node_game2048,node_memory,node_minesweeper,node_roulette,node_snake,node_sudoku,node_tictactoe,node_wordle toneAmber
class node_profile,node_shop,node_achievements_page,node_settings,node_storage,node_bankroll,node_achievements toneMint
class node_client,node_server,node_connect_codes,node_roulette_patch toneRose
class node_player_actor,node_friend toneIndigo
```

## Components

### Hub and UI

- [Application entry](https://github.com/aswina1636/neomatchup/blob/main/main.py): `main.py`
- [Game hub](https://github.com/aswina1636/neomatchup/blob/main/hub.py): `hub.py`
- [Theme engine](https://github.com/aswina1636/neomatchup/blob/main/core/theme.py): `core/theme.py`
- [Canvas animations](https://github.com/aswina1636/neomatchup/blob/main/core/animations.py): `core/animations.py`
- [Sound effects](https://github.com/aswina1636/neomatchup/blob/main/core/sounds.py): `core/sounds.py`

### Game Play

- [Game framework](https://github.com/aswina1636/neomatchup/blob/main/games/base_game.py): `games/base_game.py`
- [Game roster](https://github.com/aswina1636/neomatchup/tree/main/games): `games`
- [Chess](https://github.com/aswina1636/neomatchup/blob/main/games/chess.py): `games/chess.py`
- [Connect Four](https://github.com/aswina1636/neomatchup/blob/main/games/connect_four.py): `games/connect_four.py`
- [2048](https://github.com/aswina1636/neomatchup/blob/main/games/game2048.py): `games/game2048.py`
- [Memory Match](https://github.com/aswina1636/neomatchup/blob/main/games/memory_match.py): `games/memory_match.py`
- [Minesweeper](https://github.com/aswina1636/neomatchup/blob/main/games/minesweeper.py): `games/minesweeper.py`
- [Roulette](https://github.com/aswina1636/neomatchup/blob/main/games/roulette.py): `games/roulette.py`
- [Snake](https://github.com/aswina1636/neomatchup/blob/main/games/snake.py): `games/snake.py`
- [Sudoku](https://github.com/aswina1636/neomatchup/blob/main/games/sudoku.py): `games/sudoku.py`
- [Tic-Tac-Toe](https://github.com/aswina1636/neomatchup/blob/main/games/tictactoe.py): `games/tictactoe.py`
- [Wordle](https://github.com/aswina1636/neomatchup/blob/main/games/wordle.py): `games/wordle.py`

### Player Progress

- [Player profile](https://github.com/aswina1636/neomatchup/blob/main/pages/profile.py): `pages/profile.py`
- [NeoCoin shop](https://github.com/aswina1636/neomatchup/blob/main/pages/bank_shop.py): `pages/bank_shop.py`
- [Achievements page](https://github.com/aswina1636/neomatchup/blob/main/pages/achievements_page.py): `pages/achievements_page.py`
- [Settings](https://github.com/aswina1636/neomatchup/blob/main/pages/settings.py): `pages/settings.py`
- [JSON storage](https://github.com/aswina1636/neomatchup/blob/main/core/storage.py): `core/storage.py`
- [NeoCoin economy](https://github.com/aswina1636/neomatchup/blob/main/core/bankroll.py): `core/bankroll.py`
- [Achievement rules](https://github.com/aswina1636/neomatchup/blob/main/core/achievements.py): `core/achievements.py`

### Online Play

- [Relay client](https://github.com/aswina1636/neomatchup/blob/main/multiplayer/client.py): `multiplayer/client.py`
- [Relay server](https://github.com/aswina1636/neomatchup/blob/main/multiplayer/server.py): `multiplayer/server.py`
- [Connect codes](https://github.com/aswina1636/neomatchup/blob/main/multiplayer/utils.py): `multiplayer/utils.py`
- [Online roulette extension](https://github.com/aswina1636/neomatchup/blob/main/roulette_patch.py): `roulette_patch.py`

### Other components

- **Player**
- **Remote player**

## Connections

- Player → Application entry: launches (evidence: `README.md`)
- Application entry → Game hub: loads hub (evidence: `main.py`)
- Game hub → Game roster: offers games (evidence: `README.md`)
- Game roster → Game framework: shares framework (evidence: `README.md`)
- Game framework → Theme engine: uses (evidence: `README.md`)
- Game framework → JSON storage: accesses (evidence: `games/base_game.py`)
- Game framework → NeoCoin economy: accesses (evidence: `games/base_game.py`)
- Game framework → Achievement rules: checks (evidence: `games/base_game.py`)
- Game framework → Sound effects: accesses (evidence: `games/base_game.py`)
- Chess → Game framework: inherits (evidence: `games/chess.py`)
- Connect Four → Game framework: inherits (evidence: `games/connect_four.py`)
- 2048 → Game framework: inherits (evidence: `games/game2048.py`)
- Memory Match → Game framework: inherits (evidence: `games/memory_match.py`)
- Minesweeper → Game framework: inherits (evidence: `games/minesweeper.py`)
- Roulette → Game framework: inherits (evidence: `games/roulette.py`)
- Snake → Game framework: inherits (evidence: `games/snake.py`)
- Sudoku → Game framework: inherits (evidence: `games/sudoku.py`)
- Tic-Tac-Toe → Game framework: inherits (evidence: `games/tictactoe.py`)
- Wordle → Game framework: inherits (evidence: `games/wordle.py`)
- Player profile → JSON storage: reads and saves (evidence: `pages/profile.py`)
- NeoCoin shop → NeoCoin economy: spends coins (evidence: `README.md`)
- Achievements page → Achievement rules: shows progress (evidence: `README.md`)
- Settings → JSON storage: persists settings (evidence: `README.md`)
- Player → Game hub: navigates (evidence: `README.md`)
- Remote player → Relay client: connects online (evidence: `README.md`)
- Relay client → Relay server: sends messages (evidence: `README.md`)
- Relay server → Remote player: relays messages (evidence: `multiplayer/server.py`)
- Relay client → Connect codes: uses codes (evidence: `README.md`)
- Chess → Relay client: sends moves (evidence: `games/chess.py`)
- Chess → Connect codes: displays code (evidence: `games/chess.py`)
- Roulette → NeoCoin economy: wagers coins (evidence: `games/roulette.py`)
- Online roulette extension → Roulette: extends (evidence: `roulette_patch.py`)
- Online roulette extension → Relay client: syncs rounds (evidence: `roulette_patch.py`)
- Game framework → JSON storage: records stats (evidence: `games/base_game.py`)
- Player profile → Theme engine: styles page (evidence: `README.md`)
- Game roster → Canvas animations: animates play (evidence: `README.md`)
