Skip to main content

G-RANK Docs

Competitive Gaming Platform Documentation

Full-stack esports platform — Node.js + Express + MongoDB + React 19 + Vite

Platform Features

Everything needed to run competitive gaming tournaments

🏆
MMR Ranking System
Seven-tier ranking system (Bronze to Elite) with tier-specific gain and loss rates. Climb the ranks through competitive play.
🎮
Competitive Lobbies
Create or join lobbies for League of Legends, Pokemon Showdown, and more. Manage participants and track match results.
🔗
Riot Games Integration
Link your official Riot account via RSO OAuth. Verify match results directly through the Riot API for League of Legends.
📊
Live Leaderboard
Global leaderboard sorted by MMR. See your rank position, win/loss record, and tier badge at a glance.
🛡️
Secure Authentication
JWT tokens stored in httpOnly cookies prevent XSS token theft. Email verification required before first login.
⚙️
Admin Dashboard
Full user and lobby management for administrators. Platform statistics, role management, and content moderation.

Rank Tiers

Seven tiers with tier-specific MMR gain and loss rates

Bronze
0–499 MMR
Silver
500–999 MMR
Gold
1000–1499 MMR
Platinum
1500–1999 MMR
Diamond
2000–2499 MMR
Master
2500–2999 MMR
Elite
3000+ MMR

Tech Stack

Backend
  • Node.js 18+
  • Express 5
  • MongoDB + Mongoose 9
  • JWT + Bcrypt
  • Nodemailer
Frontend
  • React 19 + TypeScript
  • Vite 7
  • Tailwind CSS v4
  • React Router v7
  • Framer Motion
Visual FX
  • Three.js
  • React Three Fiber
  • GSAP
  • WebGL Shaders
  • CSS Animations
Infrastructure
  • MongoDB Atlas
  • Vercel (frontend)
  • Railway / Render (API)
  • GitHub (monorepo)
  • Gmail SMTP