🎮 V-RIVALS — The Next-Gen Valorant Esports Platform

V-RIVALS is an award-winning, high-performance competitive platform engineered specifically for the Valorant community. It bridges the gap between casual matchmaking and professional esports by offering a unified ecosystem for tournaments, player scouting, statistical analysis, and community building.

Built with an ultramodern tech stack featuring Next.js 15, Tailwind CSS 4, and Appwrite, V-RIVALS delivers a pixel-perfect, responsive, and blazing-fast experience. It integrates directly with Riot Games’ data (via unofficial APIs) to provide real-time stats, rank verification, and live match tracking.

🛠️ Technology Stack

✨ Features at a Glance

🏆 Advanced Tournament Engine

The platform supports multiple competitive formats with professional-grade management tools.

• Game Modes: Support for Standard 5v5, Deathmatch (FFA), and Skirmish modes (1v1, 2v2, 3v3).
• Automated Brackets: Dynamic single-elimination bracket generation that updates in real-time as matches conclude.
• Match Lobbies: Dedicated match rooms for every pairing, featuring:
  • Map Veto System: Interactive map banning phase for 5v5 matches.
  • Map Lottery: CS:GO Case-style map randomization animation for Skirmish modes.
  • Live Chat: Real-time communication between teams and admins.
  • Quick Import: Admins can fetch match results directly from Valorant API to auto-fill scores and stats.

🤖 Deep Discord Integration

Seamlessly connected with your community Discord server.

• Verification Bot: Links Discord accounts to V-RIVALS profiles to verify identity.
• Automated Channels: Automatically creates private text and voice channels for each tournament match.
• Role Management: Assigns roles to registered captains and players automatically.
• Live Notifications: Broadcasts tournament creates, match results, and scouting reports directly to Discord channels.

🔍 Scouting & Player Finder

A sophisticated discovery engine to help teams find the perfect roster fit.

• Smart Filtering: Filter free agents by Role (Duelist, Controller, etc.), Region (AP, NA, EU), Rank (Radiant to Iron), and Agent Pool.
• Intelligence Score: A proprietary algorithm that calculates a player’s “Intelligence Score” based on their rank, win rate, and recent performance.
• Scouting Reports: Players can post “Scouting Reports” (LFT posts) which are broadcasted to the Discord server.

👤 Pro-Grade Profiles

Your digital resume for the competitive scene.

• Riot Sync: One-click integration key stats directly from Valorant (Rank, Headshot %, K/D).
• Career Timeline: Visual history of recent matches with detailed performance breakdowns (ACS, ADR, Clutches).
• Rank Intelligence: Visualizations of MMR progress and rank distribution.
• Leaderboards: Global and regional leaderboards tracking earnings and tournament wins.

🛡️ Admin Command Center

A powerful dashboard for ecosystem managers.

• Tournament Control: Create, edit, and delete tournaments. Force-advance brackets and resolve disputes.
• User Management: Inspect user profiles, ban/suspend users, and manage permissions.
• Discord Controls: Manually sync or delete tournament-associated Discord channels.

📁 Project Structure

src/
├── app/                  # Next.js 15 App Router
│   ├── (admin)/          # Protected Admin Dashboard routes
│   │   ├── admin/tournaments/[id]/ # Deep tournament management
│   │   └── ...
│   ├── (main)/           # Public facing pages
│   │   ├── tournaments/  # List & Detail views for tournaments
│   │   ├── profile/      # User Profile & Stats
│   │   └── match/        # Live Match Lobby & Veto Interface
│   ├── api/              # API Routes (Discord Webhooks, Auth callbacks)
│   └── globals.css       # Tailwind 4 & Global Styles
├── components/           # Reusable UI Library
│   ├── match/            # Match-specific components (MapLottery, VetoBoard)
│   ├── admin/            # Admin forms (MatchEditor, BracketView)
│   └── ...               # Generic UI (Buttons, Modals, Loaders)
├── lib/                  # Core Business Logic
│   ├── appwrite.js       # Appwrite SDK Config
│   ├── brackets.js       # Bracket generation & advancement logic
│   ├── discord.js        # Discord Bot interactions
│   └── valorant.js       # Game API wrappers
└── context/              # React Context Providers (AuthContext)

🚀 Installation & Setup

1. Prerequisites

• Node.js (v18.17.0 or better)
• Appwrite Instance: You need a running Appwrite instance (Cloud or Self-Hosted).
• Discord Application: Create a bot in the Discord Developer Portal.

2. Clone the Repository

git clone https://github.com/leonardoo210399/V-Rivels.git
cd V-Rivels/frontend

3. Install Dependencies

npm install
# or
yarn install

4. Environment Configuration

The application relies on several environment variables for Appwrite, Valorant Data, and Discord integration. Create a .env or .env.local file in the root of frontend/.

CORE: Appwrite Configuration

These keys connect the frontend to your Appwrite backend.

DATABASE: Collection IDs

Specific IDs for your Appwrite Collections.

GAME DATA: Valorant API

Keys for the unofficial HenrikDev API to fetch player ranks and matches.

INTEGRATIONS: Discord Bot

Required for automated channel creation and innovative notification features.

SYSTEM: Base URLs

# EXAMPLE .env FILE

# Core Appwrite
NEXT_PUBLIC_APPWRITE_ENDPOINT=https://cloud.appwrite.io/v1
NEXT_PUBLIC_APPWRITE_PROJECT_ID=65abcd1234
NEXT_PUBLIC_APPWRITE_PROJECT_NAME=V-RIVALS
NEXT_PUBLIC_APPWRITE_DATABASE_ID=65dbcd5678
APPWRITE_API_KEY=your_secret_admin_key_here

# Collections
NEXT_PUBLIC_APPWRITE_TOURNAMENTS_COLLECTION_ID=tournaments
NEXT_PUBLIC_APPWRITE_REGISTRATIONS_COLLECTION_ID=registrations
NEXT_PUBLIC_APPWRITE_MATCHES_COLLECTION_ID=matches
NEXT_PUBLIC_APPWRITE_FREE_AGENTS_COLLECTION_ID=free_agents
NEXT_PUBLIC_APPWRITE_SUPPORT_TICKETS_COLLECTION_ID=support_tickets

# Valorant Data
VALORANT_API_KEYS=key1,key2,key3

# Discord
DISCORD_BOT_TOKEN=OTk5...
DISCORD_ANNOUNCEMENTS_CHANNEL_ID=123456789
DISCORD_TOURNAMENT_INFO_CHANNEL_ID=123456789
DISCORD_PLAYER_FINDER_CHANNEL_ID=123456789
DISCORD_RESULTS_CHANNEL_ID=123456789
DISCORD_REGISTRATIONS_CHANNEL_ID=123456789

# System
NEXT_PUBLIC_SITE_URL=http://localhost:3000
APP_BASE_URL=http://localhost:3000

DATABASE: Schema Setup

[!TIP] This project includes an appwrite.config.json file properly defining all Collections (Users, Tournaments, Matches, etc.) and their Attributes. You can reference this file to manually create your Appwrite Database structure, or use the Appwrite CLI to deploy it directly.

🤝 Contributing

We welcome contributions to make V-RIVALS better!

1. Fork the repository.
2. Create a Feature Branch (git checkout -b feature/NewThing).
3. Commit your changes.
4. Push to the branch.
5. Open a Pull Request.

📄 License

Distributed under the MIT License. See LICENSE for more information.

Designed & Developed by Aditya (aka aditya-2129)