Skip to content

dim4k/mixera

Repository files navigation

Logo MixEra

MixEra

A premium, modern music time machine quiz. Guess the years, test your knowledge.

Vue.js Vite TypeScript Lucide Icons

FeaturesGame ModesTech Stack

📱 Install on Android

  1. Go to the Releases page of this repository.
  2. Expand the Assets section of the latest release.
  3. Download the file named MixEra-vX.X.X.apk.
  4. Open the file on your Android device to install it.

✨ Features

  • Glassmorphic Design: A premium, high-contrast interface with vibrant glows and smooth transitions.
  • QR Scanner: Fully integrated Hitster-compatible QR scanner to play with your physical cards.
  • Dynamic Audio: Real-time Deezer integration for high-quality song previews.
  • Cross-Fade System: Seamless background transitions that adapt to the currently playing song's artwork.
  • Offline Persistence: High scores and game history are saved locally in your browser.
  • Responsive UX: Optimized for both mobile and desktop, featuring a specialized 14px "Precision Timer".

🎮 Game Modes

  • 🎯 Bullseye: The ultimate expert mode. Guess the exact year of a song on a specialized slider. Exact match = 100pts!
  • 🔥 Timeline: Compare mystery songs against a pivot year. Build the longest streak possible.
  • 🎵 Blindtest: The classic experience. Guess the artist and title with real-time feedback and discovery logic.
  • 🧠 Memory: Test your auditory memory! Match pairs of identical songs in this classic grid-flipping game.
  • 📷 Hitster: Use the built-in scanner to integrate your physical Hitster cards into the digital experience.

🛠️ Tech Stack

  • Framework: Vue.js 3 (Composition API)
  • Build Tool: Vite (Ultra-fast HMR)
  • Mobile: Capacitor (Android APK)
  • State Management: Vue Composables (Functional & Modular)
  • UI Icons: Lucide Vue
  • Deployment: GitHub Actions (Full Automaton to GH Pages & Releases)

🚀 Development

1. Requirements

  • Docker (Desktop or Engine)
  • Make (optional, but recommended)

2. Available Commands

All development tasks are handled via Docker to ensure a consistent environment.

Command Description
make dev Start development server at http://localhost:5173
make check Run all checks (Lint + Type Check)
make lint Run ESLint fix
make format Run Prettier format
make build Build web assets for production
make apk Build Android APK (Full pipeline)

Made with ❤️ for music lovers and trivia fans.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors