Songbird

Songbird is an educational project created during the Rolling Scopes School course.

It is a music quiz game where a player listens to short audio fragments from video game soundtracks and tries to guess the correct game.

Features

• 6 quiz rounds with different game genres
• 6 answer options per round
• Score system with a max score of 30
• Sound feedback for correct and wrong answers
• Built-in audio player with progress and volume controls
• Detailed card with game info (title, track, image, description)
• Leaderboard and final rank system
• User nickname and avatar persistence
• Language switch (English / Russian)
• Theme switch (Light / Dark)
• Responsive UI

Tech Stack

• Vanilla JavaScript (ES6 modules)
• SCSS
• Webpack 5
• Babel

Getting Started

Prerequisites

• Node.js 16+
• npm

Install dependencies

npm install

Run in development

npm start

Build for production

npm run build

Deploy to GitHub Pages

npm run deploy

Available Scripts

• npm start — run webpack dev server
• npm run build — create production build in dist
• npm run deploy — publish dist to gh-pages

Project Structure

songbird/
├─ assets/                # audio, images, icons, global styles
├─ blocks/                # app sections and game modules
│  ├─ header/
│  ├─ start/
│  ├─ game/
│  ├─ results/
│  ├─ collection/
│  ├─ description/
│  └─ reviews/
├─ index.html
├─ index.js               # app entry point
├─ webpack.config.js
└─ package.json

Notes

• This repository is intended for learning purposes.
• Game data (tracks, descriptions, images) is stored locally in JSON/assets.
• For GitHub Pages, make sure the Pages source is configured correctly in repository settings.