**English** | [Dansk](Home.da) | [Bahasa Melayu](Home.ms)

# U.S. States Game

A quiz game from Udemy's *100 Days of Code* (day 25): name the 50 states on a blank map of the United States. Every correct guess appears on the map; when you leave, the states you missed are saved to `states_to_learn.csv`.

![The blank map with the prompt at 0/50 states](https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-us-states-game/raw/branch/main/docs/images/game-start.png)

![A game in progress: 14 of 50 states named](https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-us-states-game/raw/branch/main/docs/images/game-in-progress.png)

## At a glance

- Python 3.13 or newer, no runtime dependencies
- Tests with `pytest`, no display needed
- Source documentation with Doxygen
- Wiki in English, Danish and Bahasa Malaysia

## Pages

| Page | |
| --- | --- |
| [Install](Install) | Set the project up on Windows, Linux Debian or MacOS and run it |
| [Description](Description) | How the game and the code work: rules, modules, tests, CI and source documentation |

[Repository](https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-us-states-game)