RiddlesNet

AI-powered riddle app — get a random riddle generated by Google Gemini, guess the answer, compete on the leaderboard.

---

🇬🇧 English

Features

• AI-generated riddles via Google Gemini API
• Firebase authentication (register / log in)
• Personal account with stats
• Global leaderboard
• Language switching (EN / RU / UA)
• Modern interface with SCSS + Tailwind

Screenshot

Tech Stack

Layer	Tech
Frontend	React 19, React Router 7
Styling	SCSS, Tailwind 4
AI	Google Gemini API
Auth & DB	Firebase (Auth + Realtime Database)
Tooling	Vite 7

Installation

1. Clone the repository:

   git clone https://github.com/ByteMe6/riddles-net
   cd riddles-net

2. Install dependencies:

   npm install

3. Create .env file in the project root:

   VITE_API_KEY=your_Gemini_API_key
   VITE_FIREBASE_KEY=your_Firebase_API_key

4. Run the project:

   npm run dev

   Open http://localhost:5173

Requirements

• Node.js >= 16
• Google Gemini API key
• Firebase project (Auth + Realtime Database enabled)

---

🇷🇺 Русский

Возможности

• Загадки от ИИ через Google Gemini API
• Аутентификация Firebase (регистрация / вход)
• Личный аккаунт со статистикой
• Глобальная таблица лидеров
• Переключение языков (EN / RU / UA)
• Современный интерфейс на SCSS + Tailwind

Скриншот

Технологии

Слой	Технология
Фронтенд	React 19, React Router 7
Стили	SCSS, Tailwind 4
ИИ	Google Gemini API
Авторизация и БД	Firebase (Auth + Realtime Database)
Инструменты	Vite 7

Установка

1. Клонировать репозиторий:

   git clone https://github.com/ByteMe6/riddles-net
   cd riddles-net

2. Установить зависимости:

   npm install

3. Создать файл .env в корне проекта:

   VITE_API_KEY=ваш_Gemini_API_ключ
   VITE_FIREBASE_KEY=ваш_Firebase_API_ключ

4. Запустить проект:

   npm run dev

   Открыть http://localhost:5173

Требования

• Node.js >= 16
• API-ключ Google Gemini
• Проект Firebase (включены Auth + Realtime Database)

---

🇺🇦 Українська

Можливості

• Загадки від ШІ через Google Gemini API
• Аутентифікація Firebase (реєстрація / вхід)
• Особистий акаунт зі статистикою
• Глобальна таблиця лідерів
• Перемикання мов (EN / RU / UA)
• Сучасний інтерфейс на SCSS + Tailwind

Знімок екрану

Технології

Шар	Технологія
Фронтенд	React 19, React Router 7
Стилі	SCSS, Tailwind 4
ШІ	Google Gemini API
Авторизація та БД	Firebase (Auth + Realtime Database)
Інструменти	Vite 7

Встановлення

1. Клонувати репозиторій:

   git clone https://github.com/ByteMe6/riddles-net
   cd riddles-net

2. Встановити залежності:

   npm install

3. Створити файл .env у корені проєкту:

   VITE_API_KEY=ваш_Gemini_API_ключ
   VITE_FIREBASE_KEY=ваш_Firebase_API_ключ

4. Запустити проєкт:

   npm run dev

   Відкрити http://localhost:5173

Вимоги

• Node.js >= 16
• API-ключ Google Gemini
• Проєкт Firebase (увімкнено Auth + Realtime Database)