⚽ TopCorner

TopCorner is a full-stack fantasy football web application where users can explore match schedules, predict match outcomes, create private leagues, and compete on leaderboards. Powered by the Football-Data.org API, the app provides reliable football fixture and result data while enabling league-based competition and score prediction gameplay.

TopCorner is designed to make football viewing more engaging by turning matches into a social and competitive experience.

---

✨ Features

• Match Schedules & Results
  Browse upcoming and past football matches across major competitions using the Football-Data.org API.

• Score Predictions
  Predict match scores before kickoff with automatic prediction locking once matches start.

• Private Leagues
  Create or join leagues using invite codes and compete with friends.

• Leaderboards
  Dynamic league leaderboards ranked by points earned from predictions.

• Automated Point System
  Predictions are evaluated after matches finish using a custom scoring engine.

• Dashboard Overview
  A central dashboard to view recent matches, leagues, stats, and activity.

• Dark & Light Theme
  Fully responsive UI with support for both dark and light modes.

• Modern UI Architecture
  Reusable component-based layout for a consistent user experience.

---

🛠️ Tech Stack

Frontend

• React.js
• Vite
• JavaScript (JSX)
• Tailwind CSS

Backend

• Node.js
• Express
• MongoDB
• Football-Data.org API (v4)

Deployment

• Vercel (Frontend)
• Render (Backend)

---

🚀 Getting Started

Follow these steps to run the project locally.

Prerequisites

• Node.js (v18 or later)
• npm

---

Installation

1. Clone the repository

   git clone https://github.com/jayantigoyal1/TopCorner.git
   

2. Navigate to the project directory

   cd TopCorner
   

3. Install dependencies

   npm install
   

4. Start the development server

   npm run dev
   

🎥 Demo Video

TopCorner.mp4

📌 Notes

• Match data availability depends on Football-Data.org free-tier limitations, including delayed scores.
• Authentication features are currently under development and will be added in future updates.
• Prediction locking is enforced based on match kickoff time to ensure fair play.

🌱 Future Improvements

• User authentication & profiles
• Editable predictions before kickoff
• Countdown timers for prediction lock
• Enhanced league analytics
• Notification system