Mirage

Mirage is a self-hostable "rhythm" game score tracker that doesn’t rely on predefined seeds or chart metadata. It preseves your scores across games, even niche ones.

✨ Features

• Import & Track Scores – Keep a safe backup of your game scores.
• Add Any Game – Works with any rhythm game, even without official metadata.
• Self-Host or Go Solo – Use locally or host for group score tracking. Multi-user system.
• Presets - Comes pre-loaded with tracking functionality for various rhythm games

Default Supported Games

• DANCERUSH
• DANCE aROUND
• Project DIVA Arcade: Future Tone
• MUSIC DIVER
• Nostalgia
• REFLEC BEAT
• Taiko no Tatsujin Arcade

Note

Basically stuff that isn't supported by Tachi (yet?), you should use it for all the other games it does support

⚠️ Warning: Work in progress

Development

Install dependencies:

pnpm install:all

Create a .env file in backend based on backend/.env.template. Fill in the fields as required.

Setup and Initialize Database:

pnpm db-init

Create a .env file in frontend based on frontend/.env.template

• If you did not change the port of the API in the backend env file. Then your VITE_API_URL is http://localhost:5000/api

Start Frontend and Backend

pnpm dev

Stack

• React Typescript
• Express
• Prisma ORM
• Postgres

You're welcome to join my personal instance, but I make no guarantees about the integrity of data if something goes catastrophically wrong.