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.