---

🎮 About the Project

APEX ESPORTS is a full-stack competitive esports tournament management platform built for mobile battle-royale titles like Free Fire and BGMI. It replaces the usual "manage tournaments over WhatsApp groups and spreadsheets" chaos with a proper product — separate User and Admin frontends, a dedicated backend, real-time updates, and automated payment + leaderboard flows.

Players can register their squads, pay entry fees via UPI, get their room ID/password the moment a match goes live, and track standings on a real-time leaderboard — while admins run the entire tournament lifecycle from one dashboard.

🔗 Live: apex-esports-zlbc.vercel.app

---

✨ Key Features

For Players

• 🏆 Team Registration — seamless squad sign-up flow for tournaments
• 💸 UPI Payment Verification — entry fees paid and verified via UPI, no manual back-and-forth
• 🔐 Room Credential Auto-Reveal — match Room ID & Password unlock automatically at the scheduled match time, no admin has to paste it manually
• 📊 Real-time Leaderboard — live standings update as matches conclude
• 🔔 Push Notifications — Firebase Cloud Messaging (FCM) alerts for match timings, results, and announcements

For Admins

• 🎛️ Dedicated Admin Dashboard (admin-frontend) — separate, locked-down interface for tournament operators
• ✅ Payment Verification Panel — approve/reject UPI payment submissions
• 📅 Match & Room Management — schedule matches, assign room credentials, control reveal timing
• 🏅 Automated Leaderboard Engine — standings calculated and updated without manual score entry
• 👥 Team & Player Oversight — view and manage all registered teams in one place

---

🛠️ Tech Stack

Layer	Technology
User Frontend	JavaScript (React)
Admin Frontend	JavaScript (React)
Backend	Node.js + Express
Database	MongoDB
Notifications	Firebase Cloud Messaging (FCM)
Deployment	Vercel (Frontends) · Render (Backend)

---

📂 Project Structure

APEX-ESPORTS/
├── admin-frontend/       # Admin dashboard — tournament & payment management
├── user-frontend/        # Player-facing app — registration, payments, leaderboard
├── backend/              # REST API — auth, matches, payments, notifications
├── PROJECT_CONTEXT.md    # Internal project context & architecture notes
├── vercel.json           # Vercel deployment config
└── package.json

---

🚀 Getting Started

Prerequisites

• Node.js (v18+ recommended)
• MongoDB instance (local or Atlas)
• Firebase project (for FCM push notifications)

Installation

# Clone the repository
git clone https://github.com/ThakurDivyanshsingh-77/APEX-ESPORTS.git
cd APEX-ESPORTS

# Install backend dependencies
cd backend
npm install

# Install user frontend dependencies
cd ../user-frontend
npm install

# Install admin frontend dependencies
cd ../admin-frontend
npm install

Environment Variables

Create a .env file inside backend/ with the following:

PORT=5000
MONGODB_URI=your_mongodb_connection_string
JWT_SECRET=your_jwt_secret
FIREBASE_SERVER_KEY=your_firebase_fcm_key
UPI_ID=your_upi_id_for_verification

Running Locally

# Start backend
cd backend
npm run dev

# Start user frontend (in a new terminal)
cd user-frontend
npm run dev

# Start admin frontend (in a new terminal)
cd admin-frontend
npm run dev

---

🗺️ Roadmap

• In-app chat/support for players
• Multi-game expansion beyond Free Fire & BGMI
• Automated payout system for winners
• Analytics dashboard for tournament performance

---

🤝 Contributing

Contributions, issues, and feature requests are welcome. Feel free to check the issues page.

📄 License

This project is open source. Add your preferred license (MIT recommended) in a LICENSE file.

---

Built by Divyansh Singh