# wojciech-bilicki/wordletutorial architecture

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

- Interactive diagram: https://gitdiagram.com/wojciech-bilicki/wordletutorial
- Repository: https://github.com/wojciech-bilicki/wordletutorial

## Overview

The tree suggests a Godot word-guessing game: a player enters guesses through a keyboard, sees letter feedback, and reaches a results view. The project also contains a word pool and validation alert. No README or source excerpts were provided, so the workflow links below are tentative and marked dashed; implementation details and call ownership could not be verified.

Main entry points: [`Scripts/rows_controller.gd`](https://github.com/wojciech-bilicki/wordletutorial/blob/main/Scripts/rows_controller.gd) (Rows Controller), [`Scripts/keyboard.gd`](https://github.com/wojciech-bilicki/wordletutorial/blob/main/Scripts/keyboard.gd) (Keyboard), [`Scenes/main.tscn`](https://github.com/wojciech-bilicki/wordletutorial/blob/main/Scenes/main.tscn) (Game Scene), [`Scripts/word_pool.gd`](https://github.com/wojciech-bilicki/wordletutorial/blob/main/Scripts/word_pool.gd) (Word Pool)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_game["Game Logic"]
  node_main["Game Scene<br/>[main.tscn]"]
  node_rows["Rows Controller<br/>[rows_controller.gd]"]
  node_pool["Word Pool<br/>[word_pool.gd]"]
  node_enums["Game Enums<br/>[enums.gd]"]
end

subgraph group_input["Input UI"]
  node_keyboard["Keyboard<br/>[keyboard.gd]"]
  node_keybutton["Keyboard Button<br/>[keyboard_button.gd]"]
end

subgraph group_feedback["Feedback UI"]
  node_tile["Letter Tile<br/>[letter_tile.gd]"]
  node_results["Results UI<br/>[results_ui.gd]"]
  node_alert["Validation Alert"]
end

node_player(("Player"))

node_player -.->|"enters guesses"| node_keyboard
node_keyboard -.->|"submits input"| node_rows
node_rows -.->|"checks words"| node_pool
node_rows -.->|"shows feedback"| node_tile
node_rows -.->|"shows validation"| node_alert
node_rows -.->|"shows outcome"| node_results
node_main -.->|"uses controller"| node_rows
node_keyboard -.->|"uses buttons"| node_keybutton

click node_main "https://github.com/wojciech-bilicki/wordletutorial/blob/main/Scenes/main.tscn"
click node_rows "https://github.com/wojciech-bilicki/wordletutorial/blob/main/Scripts/rows_controller.gd"
click node_pool "https://github.com/wojciech-bilicki/wordletutorial/blob/main/Scripts/word_pool.gd"
click node_enums "https://github.com/wojciech-bilicki/wordletutorial/blob/main/Scripts/enums.gd"
click node_keyboard "https://github.com/wojciech-bilicki/wordletutorial/blob/main/Scripts/keyboard.gd"
click node_keybutton "https://github.com/wojciech-bilicki/wordletutorial/blob/main/Scripts/keyboard_button.gd"
click node_tile "https://github.com/wojciech-bilicki/wordletutorial/blob/main/Scripts/letter_tile.gd"
click node_results "https://github.com/wojciech-bilicki/wordletutorial/blob/main/Scripts/results_ui.gd"
click node_alert "https://github.com/wojciech-bilicki/wordletutorial/blob/main/Scripts/validation_alert.gd"

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_main,node_rows,node_pool,node_enums toneBlue
class node_keyboard,node_keybutton toneAmber
class node_tile,node_results,node_alert toneMint
class node_player toneIndigo
```

## Components

### Game Logic

- [Game Scene](https://github.com/wojciech-bilicki/wordletutorial/blob/main/Scenes/main.tscn): `Scenes/main.tscn`
- [Rows Controller](https://github.com/wojciech-bilicki/wordletutorial/blob/main/Scripts/rows_controller.gd): `Scripts/rows_controller.gd`
- [Word Pool](https://github.com/wojciech-bilicki/wordletutorial/blob/main/Scripts/word_pool.gd): `Scripts/word_pool.gd`
- [Game Enums](https://github.com/wojciech-bilicki/wordletutorial/blob/main/Scripts/enums.gd): `Scripts/enums.gd`

### Input UI

- [Keyboard](https://github.com/wojciech-bilicki/wordletutorial/blob/main/Scripts/keyboard.gd): `Scripts/keyboard.gd`
- [Keyboard Button](https://github.com/wojciech-bilicki/wordletutorial/blob/main/Scripts/keyboard_button.gd): `Scripts/keyboard_button.gd`

### Feedback UI

- [Letter Tile](https://github.com/wojciech-bilicki/wordletutorial/blob/main/Scripts/letter_tile.gd): `Scripts/letter_tile.gd`
- [Results UI](https://github.com/wojciech-bilicki/wordletutorial/blob/main/Scripts/results_ui.gd): `Scripts/results_ui.gd`
- [Validation Alert](https://github.com/wojciech-bilicki/wordletutorial/blob/main/Scripts/validation_alert.gd): `Scripts/validation_alert.gd`

### Other components

- **Player**

## Connections

- Player → Keyboard: enters guesses
- Keyboard → Rows Controller: submits input
- Rows Controller → Word Pool: checks words
- Rows Controller → Letter Tile: shows feedback
- Rows Controller → Validation Alert: shows validation
- Rows Controller → Results UI: shows outcome
- Game Scene → Rows Controller: uses controller
- Keyboard → Keyboard Button: uses buttons
