GeoChallenge: Open-Source Geographic Quiz 🌍

GeoChallenge is an interactive geography quiz application where users test their knowledge by choosing difficulty levels, completing challenges, earning points, and tracking their personal statistics.
The project is built with Django and combines a solid backend with a clean, dynamic interface.

---

⚙️ Technologies Used

• Python
• Django
• HTML / CSS / JavaScript
• Tailwind CSS
• Bootstrap

---

🖼️ Screenshots

🚀 Features

• 🔐 User Authentication
  Registration, login, and persistent progress for each user.

• 🎯 Multiple Difficulty Levels
  From easy to hardcore - choose your challenge.

• 📊 Player Statistics
  Track accuracy, best scores, completed levels, and overall progress.

• ⚡ Dynamic UI
  Tailwind + Bootstrap provide a responsive and polished interface.

---

🔧 Installation

1. Clone the Repository

git clone https://github.com/sviato11/Geo-Challenge.git
cd Geo-Challenge

2. Create and Activate a Virtual Environment

python -m venv venv
source venv/bin/activate   # Linux / macOS
venv\Scripts\activate    # Windows

3. Install Dependencies

pip install -r requirements.txt

4. Apply Database Migrations

cd project
python manage.py migrate

5. Load countries data

py manage.py load_countries

6. Create Superuser

py manage.py createsuperuser

7. Run the Development Server

py manage.py runserver

🎉🎈 Done!

You can now open the app in your browser at http://127.0.0.1:8000

---

GeoChallenge: Бесплатный сервис по географии 🌍

GeoChallenge - это интерактивное приложение-викторина по географии, где пользователи проверяют свои знания, выбирают уровни сложности, проходят задания, зарабатывают очки и отслеживают свою личную статистику.
Проект создан на Django и сочетает удобный backend с чистым и динамичным интерфейсом.

---

⚙️ Используемые технологии

• Python
• Django
• HTML / CSS / JavaScript
• Tailwind CSS
• Bootstrap

---

🖼️ Скриншоты

🚀 Возможности

• 🔐 Аутентификация пользователей
  Регистрация, вход и сохранение индивидуального прогресса.

• 🎯 Несколько уровней сложности
  От лёгкого до хардкора - выбирайте свою сложность.

• 📊 Статистика игрока
  Отслеживание точности ответов, лучших результатов, пройденных уровней и общего прогресса.

• ⚡ Динамичный интерфейс
  Tailwind + Bootstrap обеспечивают адаптивный и современный внешний вид.

---

🔧 Установка

1. Клонируйте репозиторий

git clone https://github.com/sviato11/Geo-Challenge.git
cd Geo-Challenge

2. Создайте и активируйте виртуальное окружение

python -m venv .env
source .env/bin/activate    # Linux / macOS
.env\Scripts\activate       # Windows

3. Установите зависимости

pip install -r requirements.txt

4. Примените миграции базы данных

cd project
python manage.py migrate

5. Загрузите данные о странах

python manage.py load_countries

6. Создайте суперпользователя

python manage.py createsuperuser

6. Запустите сервер разработки

python manage.py runserver

🎉🎈 Готово!

Теперь вы можете открыть приложение в браузере по адресу http://127.0.0.1:8000