// readme

VSinger & Singer Tracker

A discovery and tracking platform for virtual singers (VTuber / VSinger) and real human singers / music producers. It collects public performer profiles and cross-platform identities from global rosters, then refreshes available channel and media details from supported platform APIs.

  • Collects VTuber singing streams, music videos, covers and original songs.
  • Keeps the dataset in the repository as versioned JSON, so it is diffable, auditable and served directly from a static host โ€” GitHub Pages, and a separate deployment on Vercel with real cache headers.
  • Searches it instantly with an inverted index built at pipeline time.
  • Separates the virtual and real datasets, and splits everything by region. The app can filter channels and media by region and platform.
  • Lets you link supported platform accounts to see the VTubers and singers you already follow.

Quick start

npm install
cp .env.example .env        # optional platform API credentials
npm run dev:web             # the web app on :5173

The web app reads the committed dataset in data/. To refresh it:

npm run data:sync           #โ€ฆ