A small educational web application that helps children and students learn world geography through quick, interactive recognition games. The application is currently available in Macedonian, allowing players to identify countries by their flags or map outlines using multiple-choice questions.
🌐 Live Demo: https://geographyminigames.onrender.com
Note: The demo is hosted on Render's free tier. If the application has been inactive, the first visit may take 1–2 minutes while the server starts.
- Two country-recognition games sharing one game engine
- Multiple-choice rounds (1 correct answer + 3 random distractors)
- Instant correct/incorrect feedback
- Automatic next round on a correct answer, retry on a wrong one
- High score saved locally in the browser (
localStorage) - Dataset of 236 countries with matching map and flag SVGs
Map Shape Game — Guess the country from its outline on the map. Trains visual recognition of country shapes.
Flag Game — Guess the country from its national flag. Trains recognition of flags and their matching countries.
Both games use the same four-choice format and scoring logic; only the image and answer set change.
- Python 3.11 / Django 4.2
- HTML, CSS, vanilla JavaScript (no frontend framework)
- SQLite (Django defaults only — no custom models)
- Gunicorn + WhiteNoise for deployment
- Static JSON dataset + SVG assets for countries, flags, and maps
git clone https://github.com/oxSTERBENxo/GeographyMiniGames.git
cd GeographyMiniGames
python -m venv venv
venv\Scripts\activate # Windows
source venv/bin/activate # macOS/Linux
pip install -r requirements.txt
python manage.py migrate
python manage.py runserverOpen http://127.0.0.1:8000/ in your browser.
Home screen
Map shape game
Flag game — correct answer
- More games (capitals, continents, borders)
- Difficulty levels / timed rounds
- Separate high scores per game
- User accounts with saved progress
- Audio pronunciation of country names
MIT — see LICENSE.