Skip to content

b-on-g/blitz

Repository files navigation

Blitz Quiz

Реалтайм-мультиплеерная викторина. Хост создаёт квиз, игроки подключаются по QR-коду и отвечают на вопросы наперегонки.

Демо · Исходники

Возможности

  • Лобби — создание комнаты, QR-код для входа, зал ожидания
  • Игра — таймер, вопросы (выбор / текст), лидерборд, реакции
  • Админка — создание и редактирование квизов, AI-генерация вопросов, импорт JSON
  • Профиль — аватар, статистика, история игр
  • Радио — фоновая музыка во время игры
  • Темы — переключение светлой/тёмной темы и пресетов
  • i18n — английский, русский, украинский, китайский

Стек

UI-фреймворк $mol
Синхронизация Giper Baza (CRDT)
Сборка MAM
Деплой GitHub Pages

Структура

bog/blitz/
├── blitz.view.tree          # Корневой компонент (навигация, тема, радио)
├── lobby/                   # Игровое лобби
│   ├── host/                #   Экран хоста (QR, старт)
│   ├── join/                #   Вход игрока (имя, аватар)
│   ├── waiting/             #   Зал ожидания
│   ├── players/             #   Список игроков
│   ├── reactions/           #   Реакции
│   └── game/                #   Игровой процесс
│       ├── option/          #     Варианты ответа
│       ├── timer/           #     Таймер
│       ├── leaderboard/     #     Таблица лидеров
│       └── reactboard/      #     Доска реакций
├── admin/                   # Управление квизами
│   ├── quiz/                #   Список квизов
│   ├── question/            #   Редактор вопроса
│   ├── option/              #   Редактор варианта
│   ├── editor/              #   Настройки квиза
│   └── bot/                 #   AI-генерация
├── profile/                 # Профиль игрока
├── radio/                   # Радио
└── blog/                    # Блог (about, guide, features)

Разработка

Требуется Node.js >= 24.

# Из корня MAM-монорепозитория:
npm start
# Dev-сервер: http://localhost:9080/bog/blitz/
# в консоли 
+ giper/baza/app/run port=9090

Деплой

CI настроен в .github/workflows/deploy.yml:

  • masterhttps://b-on-g.github.io/blitz/
  • mishahttps://b-on-g.github.io/blitz/misha/

Сборка запускается по push, pull request, вручную и ежедневно в 07:00 UTC.

About

kahoot free ver

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors