Skip to content

Vishrut2403/GameVault

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

48 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Game Vault

Track. Analyze. Optimize your gaming library across multiple platforms.

A full-stack web app that unifies Steam, RetroAchievements, RetroArch, Minecraft, and console emulators into a single analytics-driven dashboard — with session tracking, HowLongToBeat estimates, and intelligent budget recommendations.

Analytics Dashboard Multi Platform HLTB Integration RetroArch

⚠️ Not affiliated with Valve, Steam, HowLongToBeat, RetroArch, or any other platform mentioned.


What is this?

Modern gamers play across Steam, retro emulators, Minecraft, and more — making it impossible to track total playtime or analyze habits in one place. Game Vault solves that by aggregating everything into a single dashboard with GitHub-style activity heatmaps, value analytics, and smart wishlist recommendations.


Key Features

  • Multi-platform library — Steam, RetroAchievements, RetroArch, Minecraft, PCSX2, RPCS3, PPSSPP
  • RetroArch support — Auto-detects games and playtime from local playlists and runtime logs across any installed core
  • HowLongToBeat integration — Main story, main + extras, and completionist estimates on every game
  • Smart recommendations — 0/1 knapsack algorithm scored by discount, HLTB hrs/₹ value, and your taste profile
  • Advanced analytics — GitHub-style heatmap, session tracking, radar chart, platform distribution, price-per-hour
  • Unified journal — Notes and progress logs for every game across all platforms
  • Auto-Sync — Automatically sync all platforms after gaming sessions with a single click

Screenshots

Analytics Dashboard

Analytics Dashboard

Game Library

Game Library

Wishlist

Wishlist

Recommendations

Recommendations


Quick Start

# 1. Clone
git clone https://github.com/Vishrut2403/GameVault.git
cd GameVault

# 2. Backend
cd backend
npm install
cp .env.example .env   # fill in your keys
npx prisma migrate dev
npm run dev

# 3. Frontend (new terminal)
cd frontend
npm install
cp .env.example .env   # set VITE_API_URL=http://localhost:3001
npm run dev

Open http://localhost:5173

You'll need Node.js 18+, PostgreSQL 14+, and a Steam API key to get started. See docs/setup.md for the full setup guide.


Tech Stack

Layer Tech
Frontend React 18, TypeScript, Vite, TailwindCSS, Recharts
Backend Node.js, Express, TypeScript
Database PostgreSQL 14+, Prisma ORM
Auth JWT, Passport.js (Steam OAuth)
Integrations Steam API, RetroAchievements API, RetroArch (local), HowLongToBeat (unofficial API)

Documentation


Author

Vishrut Sachan


Disclaimer

This project is not affiliated with Valve, Steam, HowLongToBeat, RetroAchievements, RetroArch, or any other platform mentioned. HLTB data is fetched via an unofficial third-party API and may not always be complete or accurate.

About

Full-stack gaming library tracker — unifies Steam, RetroArch, RetroAchievements, Minecraft and more with analytics, HowLongToBeat integration, and smart budget recommendations.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages