[MatchLens]

CodePath WEB103 Final Project

Designed and developed by: Cristobal Talamantes, Eric Lee, Gildardo Orea, Javohir Ergashev, Rijul Poudel, Shalom Donga

🔗 Link to deployed app:

About

Description and Purpose

A football dashboard that brings match results, in-depth stats, player data, and standings together in one place. Instead of jumping between multiple sites to keep up with the game, users get everything they need in a single, clean interface — match details, team and player statistics, and up-to-date standings all at their fingertips.

The goal is to make following football simple and enjoyable, whether you're checking a scoreline, digging into the numbers behind a performance, or tracking how teams stack up across a competition.

Inspiration

This project was inspired by the FIFA World Cup 2026. Watching the tournament unfold sparked the idea of building a single hub where all the key football data — results, stats, and standings — could live together, styled after the clean, familiar look of major football sites. What started as a way to follow the World Cup grew into a broader dashboard for football fans in general.

Tech Stack

Frontend:

• React
• React Router
• Vite
• Tailwind CSS

Backend:

• Node.js
• Express
• PostgreSQL (node-postgres / pg)
• External football data API (proxied server-side)
• Render

Features

✅Authentication

Users can create an account and log in securely to access their profile and personalized features.

Search

Users can search for players, teams, and matches to quickly find what they're looking for.

[gif goes here]

✅Data Display

Users can browse players (history, team, and stats), match details (score, lineup, venue, weather), and a calendar of fixtures.

Leaderboards

Users can view ranked tables of top players by their stats and top users by their virtual points.

[gif goes here]

Score Predictions

Users can predict the score of upcoming matches to earn points and move up the user leaderboard.

[gif goes here]

Team Following

Users can follow a team to get its latest news and match notifications.

[gif goes here]

Comments

Users can comment on matches to share their thoughts with other fans.

[gif goes here]

Video Links

Users can access video highlights or full-game footage of a match.

[gif goes here]

✅User Profile

Users can customize their profile with a profile image and personal details.

[ADDITIONAL FEATURES GO HERE - ADD ALL FEATURES HERE IN THE FORMAT ABOVE; you will check these off and add gifs as you complete them]

Installation Instructions

[instructions go here]