# leansart/tp_pokemon architecture

> Architecture diagram of the GitHub repository leansart/tp_pokemon, 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/leansart/tp_pokemon
- Repository: https://github.com/leansart/tp_pokemon

## Overview

This is an early, SFML-based Pokémon game prototype; the README says it currently does not compile. Its apparent player journey is title and starter selection, exploration, then trainer or wild encounters, with party and Pokédex screens available along the way. The graph preserves these documented-in-code stages and supporting UI/domain layers. Many implementation files are listed as read in the source index but their contents were not excerpted, so those links are dashed and unverified rather than asserted as confirmed calls.

Main entry points: [`src/BattleState.cpp`](https://github.com/leansart/tp_pokemon/blob/master/src/BattleState.cpp) (Trainer battle), [`src/WildEncounterState.cpp`](https://github.com/leansart/tp_pokemon/blob/master/src/WildEncounterState.cpp) (Wild encounter), [`src/TitleScreen.cpp`](https://github.com/leansart/tp_pokemon/blob/master/src/TitleScreen.cpp) (Title and starters), [`src/Exploration.cpp`](https://github.com/leansart/tp_pokemon/blob/master/src/Exploration.cpp) (Exploration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_flow["Game flow"]
  node_engine["Game engine<br/>[GameEngine.cpp]"]
end

subgraph group_domain["Pokémon domain"]
  node_pokedex["Pokédex<br/>[Pokedex.cpp]"]
  node_party["Pokémon party<br/>[PokemonParty.cpp]"]
  node_attacks["Attack data<br/>[PokemonAttack.cpp]"]
  node_pokemon["Pokémon model<br/>[Pokemon.cpp]"]
end

subgraph group_screens["Player screens"]
  node_title["Title and starters<br/>[TitleScreen.cpp]"]
  node_explore["Exploration<br/>[Exploration.cpp]"]
  node_battle["Trainer battle<br/>[BattleState.cpp]"]
  node_wild["Wild encounter"]
  node_gameover["Game over<br/>[GameOverState.cpp]"]
  node_partyview["Party viewer"]
  node_attackview["Attack viewer"]
end

subgraph group_ui["Shared presentation"]
  node_sprite["Pokémon sprite<br/>[PokemonSprite.cpp]"]
  node_infobox["Status panel<br/>[PokemonInfoBox.cpp]"]
  node_button["Buttons<br/>[Button.cpp]"]
  node_uihelpers["UI helpers<br/>[UIHelpers.cpp]"]
  node_health["Health bar<br/>[HealthBar.cpp]"]
  node_theme["Theme<br/>[Theme.hpp]"]
  node_layout["Battle layout<br/>[BattleLayout.hpp]"]
end

node_player(("Player"))

node_player -.->|"starts game"| node_engine
node_engine -.->|"sets initial state"| node_title
node_title -.->|"starts exploration"| node_explore
node_explore -.->|"enters battle"| node_battle
node_explore -.->|"starts encounter"| node_wild
node_explore -.->|"opens party"| node_partyview
node_explore -.->|"opens attacks"| node_attackview
node_battle -.->|"changes state"| node_gameover
node_wild -.->|"changes state"| node_gameover
node_title -.->|"selects starter"| node_pokedex
node_title -.->|"chooses starter"| node_pokemon
node_battle -.->|"battles with"| node_pokemon
node_wild -.->|"battles or captures"| node_pokemon
node_battle -.->|"uses status panel"| node_infobox
node_wild -.->|"uses status panel"| node_infobox
node_infobox -.->|"shows health"| node_health
node_battle -.->|"shows combatants"| node_sprite
node_wild -.->|"shows combatants"| node_sprite
node_title -.->|"shows starters"| node_sprite
node_title -.->|"uses buttons"| node_button
node_explore -.->|"uses buttons"| node_button
node_battle -.->|"uses buttons"| node_button
node_wild -.->|"uses buttons"| node_button
node_button -.->|"uses helpers"| node_uihelpers
node_battle -.->|"uses layout"| node_layout
node_wild -.->|"uses layout"| node_layout
node_title -.->|"uses theme"| node_theme
node_explore -.->|"uses theme"| node_theme
node_battle -.->|"uses theme"| node_theme
node_wild -.->|"uses theme"| node_theme
node_partyview -.->|"views party"| node_party
node_attackview -.->|"views attacks"| node_attacks
node_pokedex -.->|"stores entries"| node_pokemon

click node_engine "https://github.com/leansart/tp_pokemon/blob/master/src/GameEngine.cpp"
click node_title "https://github.com/leansart/tp_pokemon/blob/master/src/TitleScreen.cpp"
click node_explore "https://github.com/leansart/tp_pokemon/blob/master/src/Exploration.cpp"
click node_battle "https://github.com/leansart/tp_pokemon/blob/master/src/BattleState.cpp"
click node_wild "https://github.com/leansart/tp_pokemon/blob/master/src/WildEncounterState.cpp"
click node_gameover "https://github.com/leansart/tp_pokemon/blob/master/src/GameOverState.cpp"
click node_partyview "https://github.com/leansart/tp_pokemon/blob/master/src/PokemonPartyViewver.cpp"
click node_attackview "https://github.com/leansart/tp_pokemon/blob/master/src/PokemonAttackViewver.cpp"
click node_pokedex "https://github.com/leansart/tp_pokemon/blob/master/src/Pokedex.cpp"
click node_party "https://github.com/leansart/tp_pokemon/blob/master/src/PokemonParty.cpp"
click node_attacks "https://github.com/leansart/tp_pokemon/blob/master/src/PokemonAttack.cpp"
click node_pokemon "https://github.com/leansart/tp_pokemon/blob/master/src/Pokemon.cpp"
click node_sprite "https://github.com/leansart/tp_pokemon/blob/master/src/PokemonSprite.cpp"
click node_infobox "https://github.com/leansart/tp_pokemon/blob/master/src/PokemonInfoBox.cpp"
click node_button "https://github.com/leansart/tp_pokemon/blob/master/src/Button.cpp"
click node_uihelpers "https://github.com/leansart/tp_pokemon/blob/master/src/UIHelpers.cpp"
click node_health "https://github.com/leansart/tp_pokemon/blob/master/src/HealthBar.cpp"
click node_theme "https://github.com/leansart/tp_pokemon/blob/master/includes/Theme.hpp"
click node_layout "https://github.com/leansart/tp_pokemon/blob/master/includes/BattleLayout.hpp"

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_engine toneBlue
class node_pokedex,node_party,node_attacks,node_pokemon toneAmber
class node_title,node_explore,node_battle,node_wild,node_gameover,node_partyview,node_attackview toneMint
class node_sprite,node_infobox,node_button,node_uihelpers,node_health,node_theme,node_layout toneRose
class node_player toneIndigo
```

## Components

### Game flow

- [Game engine](https://github.com/leansart/tp_pokemon/blob/master/src/GameEngine.cpp): `src/GameEngine.cpp`

### Pokémon domain

- [Pokédex](https://github.com/leansart/tp_pokemon/blob/master/src/Pokedex.cpp): `src/Pokedex.cpp`
- [Pokémon party](https://github.com/leansart/tp_pokemon/blob/master/src/PokemonParty.cpp): `src/PokemonParty.cpp`
- [Attack data](https://github.com/leansart/tp_pokemon/blob/master/src/PokemonAttack.cpp): `src/PokemonAttack.cpp`
- [Pokémon model](https://github.com/leansart/tp_pokemon/blob/master/src/Pokemon.cpp): `src/Pokemon.cpp`

### Player screens

- [Title and starters](https://github.com/leansart/tp_pokemon/blob/master/src/TitleScreen.cpp): `src/TitleScreen.cpp`
- [Exploration](https://github.com/leansart/tp_pokemon/blob/master/src/Exploration.cpp): `src/Exploration.cpp`
- [Trainer battle](https://github.com/leansart/tp_pokemon/blob/master/src/BattleState.cpp): `src/BattleState.cpp`
- [Wild encounter](https://github.com/leansart/tp_pokemon/blob/master/src/WildEncounterState.cpp): `src/WildEncounterState.cpp`
- [Game over](https://github.com/leansart/tp_pokemon/blob/master/src/GameOverState.cpp): `src/GameOverState.cpp`
- [Party viewer](https://github.com/leansart/tp_pokemon/blob/master/src/PokemonPartyViewver.cpp): `src/PokemonPartyViewver.cpp`
- [Attack viewer](https://github.com/leansart/tp_pokemon/blob/master/src/PokemonAttackViewver.cpp): `src/PokemonAttackViewver.cpp`

### Shared presentation

- [Pokémon sprite](https://github.com/leansart/tp_pokemon/blob/master/src/PokemonSprite.cpp): `src/PokemonSprite.cpp`
- [Status panel](https://github.com/leansart/tp_pokemon/blob/master/src/PokemonInfoBox.cpp): `src/PokemonInfoBox.cpp`
- [Buttons](https://github.com/leansart/tp_pokemon/blob/master/src/Button.cpp): `src/Button.cpp`
- [UI helpers](https://github.com/leansart/tp_pokemon/blob/master/src/UIHelpers.cpp): `src/UIHelpers.cpp`
- [Health bar](https://github.com/leansart/tp_pokemon/blob/master/src/HealthBar.cpp): `src/HealthBar.cpp`
- [Theme](https://github.com/leansart/tp_pokemon/blob/master/includes/Theme.hpp): `includes/Theme.hpp`
- [Battle layout](https://github.com/leansart/tp_pokemon/blob/master/includes/BattleLayout.hpp): `includes/BattleLayout.hpp`

### Other components

- **Player**

## Connections

- Player → Game engine: starts game
- Game engine → Title and starters: sets initial state
- Title and starters → Exploration: starts exploration
- Exploration → Trainer battle: enters battle
- Exploration → Wild encounter: starts encounter
- Exploration → Party viewer: opens party
- Exploration → Attack viewer: opens attacks
- Trainer battle → Game over: changes state
- Wild encounter → Game over: changes state
- Title and starters → Pokédex: selects starter
- Title and starters → Pokémon model: chooses starter
- Trainer battle → Pokémon model: battles with
- Wild encounter → Pokémon model: battles or captures
- Trainer battle → Status panel: uses status panel
- Wild encounter → Status panel: uses status panel
- Status panel → Health bar: shows health
- Trainer battle → Pokémon sprite: shows combatants
- Wild encounter → Pokémon sprite: shows combatants
- Title and starters → Pokémon sprite: shows starters
- Title and starters → Buttons: uses buttons
- Exploration → Buttons: uses buttons
- Trainer battle → Buttons: uses buttons
- Wild encounter → Buttons: uses buttons
- Buttons → UI helpers: uses helpers
- Trainer battle → Battle layout: uses layout (evidence: `src/BattleState.cpp`)
- Wild encounter → Battle layout: uses layout (evidence: `src/WildEncounterState.cpp`)
- Title and starters → Theme: uses theme (evidence: `src/TitleScreen.cpp`)
- Exploration → Theme: uses theme (evidence: `src/Exploration.cpp`)
- Trainer battle → Theme: uses theme (evidence: `src/BattleState.cpp`)
- Wild encounter → Theme: uses theme (evidence: `src/WildEncounterState.cpp`)
- Party viewer → Pokémon party: views party
- Attack viewer → Attack data: views attacks
- Pokédex → Pokémon model: stores entries
