WINGAMES.CLUB — Real Money Gaming Matchmaking Platform

Welcome to WINGAMES.CLUB — a real-money Ludo battle platform where users can deposit funds, find real opponents, submit proof, and win cash prizes. Built with high performance and user trust in mind, this web app is fully mobile-optimized, secure, and integrated with real payment and verification systems.

⚙️ Features

• KYC & Age Verification
• ** Phone Number Otp based auth with Supabase**
• Wallet System: Deposit, Withdraw, View History
• Matchmaking with Redis + Socket.IO
• Ludo Room Creation & Game Sharing
• Match Verification via Screenshot Upload
• **Razorpay Integration for Fund Handling (Upcoming ) **
• Transaction & Match History
• Referral System (Earn 2% of your friend’s winnings)

UI Sneak Peek

Match Verification	Share Page	KYC Verification

Referral System	Transactions	Battle System

🛠️ Tech Stack

Technology	Role
React	Frontend UI
Node.js + Express	Backend API server
Supabase	Auth + PostgreSQL database
Razorpay	Payments (deposit & withdraw)
Socket.IO	Real-time matchmaking
Redis	Queue system for battle pairing
Cloudinary	Image storage for screenshot proof

Folder Structure

/client         # Frontend (React)
/server         # Backend (Express.js)
/screenshots    # UI screenshots for README

Getting Started

1. Clone the Repo

git clone https://github.com/Shlokmonster/WINGAMES.CLUB.git
cd WINGAMES.CLUB

2. Install Dependencies

• Frontend

  cd client
  npm install
  npm start

• Backend

  cd ../server
  npm install
  npm run dev

3. Set Environment Variables

Create .env files for both client and server:

SUPABASE_URL=
SUPABASE_ANON_KEY=
REDIS_URL=
{ RAZORPAY_KEY_ID=
RAZORPAY_SECRET= }= Upcoming Feature

How It Works

1. User signs in using Google (Supabase).
2. Deposits funds to wallet (Razorpay).
3. Joins a matchmaking queue (Socket.IO + Redis).
4. Plays Ludo using shared room code.
5. Uploads screenshot to verify match outcome.
6. Admin reviews and credits winnings.

Referral System

Users can earn 2% of their friends' winnings when they join via referral link. The referral module includes easy share buttons for WhatsApp, Telegram, etc.

Admin Panel (not shown)

• Approve/Reject KYC
• Review Match Results
• Control Matchmaking and Payouts
• Manual Fund Adjustment

Future Plans

• AI-based screenshot validation (anti-cheat)
• Leaderboard & Seasonal Tournaments
• Push Notifications

Developed By

Made with ❤️ by @Shlokmonster for a private client project.

---

⚠️ Disclaimer

This project is for educational and freelance portfolio purposes. All payment flows were integrated under client license and jurisdictional rules. Ensure compliance with Indian gaming laws before reusing or deploying.