# lukalomadze1/georgian-wordle architecture

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

- Interactive diagram: https://gitdiagram.com/lukalomadze1/georgian-wordle
- Repository: https://github.com/lukalomadze1/georgian-wordle

## Overview

This is a client-side Georgian Wordle game. The player enters five-letter guesses through the physical or on-screen keyboard; the game validates each guess, colors feedback, and ends in a win or loss. Players can request a hint, start another random-word round, and inspect locally saved win statistics. The runtime is concentrated in script.js, with words.js supplying the word list. Feature wiring beyond the shown excerpts is included only where the README documents it.

Main entry points: [`script.js`](https://github.com/lukalomadze1/georgian-wordle/blob/main/script.js) (Game Runtime), [`index.html`](https://github.com/lukalomadze1/georgian-wordle/blob/main/index.html) (Game Page), [`words.js`](https://github.com/lukalomadze1/georgian-wordle/blob/main/words.js) (Georgian Words), [`style.css`](https://github.com/lukalomadze1/georgian-wordle/blob/main/style.css) (Game Styling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_play["Gameplay"]
  node_game["Game Runtime<br/>[script.js]"]
  node_keyboard["Keyboard Input<br/>[script.js]"]
  node_guess["Guess Validation<br/>[script.js]"]
  node_feedback["Guess Feedback<br/>[script.js]"]
  node_round["Random Rounds<br/>[script.js]"]
  node_hint["Word Hint<br/>[script.js]"]
end

subgraph group_content["Game Content"]
  node_wordlist["Georgian Words<br/>[words.js]"]
end

subgraph group_results["Results and Progress"]
  node_stats["Win Statistics<br/>[script.js]"]
  node_storage[("Browser Local Storage")]
  node_distribution["Win Distribution<br/>[script.js]"]
end

subgraph group_interface["Web Interface"]
  node_page["Game Page<br/>[index.html]"]
  node_styles["Game Styling<br/>[style.css]"]
end

node_player(("Player"))

node_player -->|"enters guesses"| node_keyboard
node_keyboard -->|"sends input"| node_game
node_game -->|"submits guess"| node_guess
node_guess -->|"checks membership"| node_wordlist
node_game -->|"imports list"| node_wordlist
node_game -->|"colors guess"| node_feedback
node_game -->|"starts round"| node_round
node_player -->|"requests hint"| node_hint
node_player -->|"views progress"| node_stats
node_stats -->|"reads and writes"| node_storage
node_stats -->|"renders wins"| node_distribution
node_player -->|"plays through"| node_page
node_page -.->|"uses styling"| node_styles

click node_game "https://github.com/lukalomadze1/georgian-wordle/blob/main/script.js"
click node_keyboard "https://github.com/lukalomadze1/georgian-wordle/blob/main/script.js"
click node_guess "https://github.com/lukalomadze1/georgian-wordle/blob/main/script.js"
click node_feedback "https://github.com/lukalomadze1/georgian-wordle/blob/main/script.js"
click node_wordlist "https://github.com/lukalomadze1/georgian-wordle/blob/main/words.js"
click node_round "https://github.com/lukalomadze1/georgian-wordle/blob/main/script.js"
click node_hint "https://github.com/lukalomadze1/georgian-wordle/blob/main/script.js"
click node_stats "https://github.com/lukalomadze1/georgian-wordle/blob/main/script.js"
click node_distribution "https://github.com/lukalomadze1/georgian-wordle/blob/main/script.js"
click node_page "https://github.com/lukalomadze1/georgian-wordle/blob/main/index.html"
click node_styles "https://github.com/lukalomadze1/georgian-wordle/blob/main/style.css"

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_game,node_keyboard,node_guess,node_feedback,node_round,node_hint toneBlue
class node_wordlist toneAmber
class node_stats,node_storage,node_distribution toneMint
class node_page,node_styles toneRose
class node_player toneIndigo
```

## Components

### Gameplay

- [Game Runtime](https://github.com/lukalomadze1/georgian-wordle/blob/main/script.js): `script.js`
- [Keyboard Input](https://github.com/lukalomadze1/georgian-wordle/blob/main/script.js): `script.js`
- [Guess Validation](https://github.com/lukalomadze1/georgian-wordle/blob/main/script.js): `script.js`
- [Guess Feedback](https://github.com/lukalomadze1/georgian-wordle/blob/main/script.js): `script.js`
- [Random Rounds](https://github.com/lukalomadze1/georgian-wordle/blob/main/script.js): `script.js`
- [Word Hint](https://github.com/lukalomadze1/georgian-wordle/blob/main/script.js): `script.js`

### Game Content

- [Georgian Words](https://github.com/lukalomadze1/georgian-wordle/blob/main/words.js): `words.js`

### Results and Progress

- [Win Statistics](https://github.com/lukalomadze1/georgian-wordle/blob/main/script.js): `script.js`
- **Browser Local Storage**
- [Win Distribution](https://github.com/lukalomadze1/georgian-wordle/blob/main/script.js): `script.js`

### Web Interface

- [Game Page](https://github.com/lukalomadze1/georgian-wordle/blob/main/index.html): `index.html`
- [Game Styling](https://github.com/lukalomadze1/georgian-wordle/blob/main/style.css): `style.css`

### Other components

- **Player**

## Connections

- Player → Keyboard Input: enters guesses (evidence: `README.md`)
- Keyboard Input → Game Runtime: sends input (evidence: `script.js`)
- Game Runtime → Guess Validation: submits guess (evidence: `script.js`)
- Guess Validation → Georgian Words: checks membership (evidence: `script.js`)
- Game Runtime → Georgian Words: imports list (evidence: `script.js`)
- Game Runtime → Guess Feedback: colors guess (evidence: `script.js`)
- Game Runtime → Random Rounds: starts round (evidence: `script.js`)
- Player → Word Hint: requests hint (evidence: `README.md`)
- Player → Win Statistics: views progress (evidence: `README.md`)
- Win Statistics → Browser Local Storage: reads and writes (evidence: `README.md`)
- Win Statistics → Win Distribution: renders wins (evidence: `script.js`)
- Player → Game Page: plays through (evidence: `README.md`)
- Game Page → Game Styling: uses styling
