Skip to content
Logan1hPublic

About

Educational quest platform with fullscreen interactive components

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

📖 Поэтический Квест

Интерактивная образовательная платформа для учеников 3–4 класса. Квесты, мини-игры и битвы на основе произведений русской литературы.


🎮 Квесты

Квест Класс Описание
🐾 Следы Колобка 3 класс Детективное расследование по мотивам русских народных сказок
✒️ Поэтическая мастерская 3 класс Изучение поэтических приёмов — эпитет, метафора, сравнение
⚔️ Путь богатыря 4 класс Приключение по карте Руси, сражения с Соловьём, Змеем, Тугарином
📜 Беседа с летописцем 4 класс Диалоговый квест с историческими персонажами

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

  • Игровые механики — викторины, загадки, сбор предметов, пошаговые диалоги, слот-пазлы, боевые мини-игры с системой уклонения и серий
  • Прогресс и достижения — дневник фактов, доска лидеров, сертификат об окончании, система очков и наград
  • Для учителей — отдельная страница с аналитикой и управлением классом
  • Тёмная/светлая тема — с анимированным переходом
  • PWA — работает как установленное приложение, иконки и манифест настроены
  • Адаптивный дизайн — полная поддержка мобильных устройств
  • Аудио — звуковые эффекты и фоновая музыка (Tone.js), переключаемые в интерфейсе
  • Анимации — Framer Motion + Lottie для персонажей и переходов

🛠 Стек технологий

Категория Технологии
Frontend React 19, TypeScript, Vite 7
Стилизация Tailwind CSS v4 (via @tailwindcss/vite), Vanilla CSS
Анимации Framer Motion 12, Lottie React
Роутинг React Router 7
Звук Tone.js
Иконки Lucide React
Деплой Static (npm run build → dist/)

🚀 Быстрый старт

# Установка зависимостей
npm install

# Режим разработки (порт 5000)
npm run dev

# Сборка для продакшна
npm run build

# Предпросмотр сборки
npm run preview

📁 Структура проекта

src/
├── features/
│   ├── bogatyr/        # Квест «Путь богатыря» — карта, инвентарь, битвы
│   ├── dialogue/       # Квест «Беседа с летописцем» — диалоговая система
│   ├── kolobok/        # Квест «Следы Колобка» — детективный сценарий
│   └── poetry/         # Квест «Поэтическая мастерская» — 3 комнаты + финал
├── components/
│   └── quest/          # Переиспользуемые компоненты: BattleMiniGame, SlotPuzzle, RunicPuzzle и др.
├── pages/              # Маршруты: LandingPage, Grade3/4Page, Dashboard, Achievements и др.
├── data/               # Статические данные: былины, сказки, стихи
├── utils/              # Прогресс, дневник, аудио, sfx
└── contexts/           # AudioContext, ThemeContext

🌐 Деплой

Проект настроен как статический сайт:

# .replit
[deployment]
deploymentTarget = "static"
build = ["npm", "run", "build"]
publicDir = "dist"

Приложение доступно на порту 5000 в режиме разработки и экспортируется в dist/ при сборке.


Создано с любовью к литературе и образованию.

About

Educational quest platform with fullscreen interactive components

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages