{"id":20459783,"url":"https://github.com/mullah98/my-footy-app","last_synced_at":"2026-05-04T18:31:41.541Z","repository":{"id":250384637,"uuid":"834169250","full_name":"Mullah98/My-Footy-App","owner":"Mullah98","description":"Built with React and Next.js, this football data app displays live API-Football stats such as league standings, player stats, and fixtures. It provides a dynamic and responsive user experience for football fans.","archived":false,"fork":false,"pushed_at":"2025-01-09T14:38:21.000Z","size":236,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-05T11:17:03.788Z","etag":null,"topics":["api","backend","frontend","nextjs","react"],"latest_commit_sha":null,"homepage":"https://www.youtube.com/watch?v=vH9TijMc_jo","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Mullah98.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-26T15:10:52.000Z","updated_at":"2025-01-27T16:09:14.000Z","dependencies_parsed_at":"2024-11-15T12:17:19.512Z","dependency_job_id":"a82454e5-9133-47df-b23a-943420c45cf4","html_url":"https://github.com/Mullah98/My-Footy-App","commit_stats":null,"previous_names":["mullah98/footy-app","mullah98/my-footy-app"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mullah98%2FMy-Footy-App","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mullah98%2FMy-Footy-App/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mullah98%2FMy-Footy-App/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mullah98%2FMy-Footy-App/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Mullah98","download_url":"https://codeload.github.com/Mullah98/My-Footy-App/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242014722,"owners_count":20057880,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","backend","frontend","nextjs","react"],"created_at":"2024-11-15T12:17:15.803Z","updated_at":"2026-05-04T18:31:41.536Z","avatar_url":"https://github.com/Mullah98.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# My Footy App Project\nThis is a live football stats app built using **NextJs**, with the data provided by [**API-Football Services**](https://www.api-football.com/).\n\n# Features\n- Display live football fixtures, standings, top scorers and assist leaders\n- View detailed stats, squads and club transfers for each team\n- View upto date statistics for each player\n- Data fetched from **API-Football Services**\n\n# Getting started\n- **Clone the repository -\u003e** `git clone repository_link`\n- **Install dependencies -\u003e** `npm install`\n- **Set up the environment variables by creating a .env.local file with your API key from api-football.com -\u003e** `API_FOOTBALL_KEY=your_api_key_here`\n- **Run the development server -\u003e** `npm run dev`\n- **View the app**\n\n# API Integration\nThis project uses the [**API-Football**](https://www.api-football.com/) to fetch football data. Ensure you have an API key by signing up on their platform.\n\n# Project structure\n- `/components:` Contains reusable components such as Player, Team and Fixture\n- `/pages:` Main pages of the app including fixtures, standings, and stats\n- `/api:` API calls to fetch data\n\n# Deployment with Vercel\n- Push the project to your GitHub\n- Link your GitHub to Vercel\n- Deploy your app with a single click\n- More details on the deployment [**Next.js deployment docs**](https://nextjs.org/docs/pages/building-your-application/deploying)\n\n# Challenges\n- `Handling Real-Time Data-` Managing and updating live football data for fixtures and stats in real time was challenging. I implemented efficient caching techniques using React Query to reduce API calls and improve performance by automatically caching and syncing data.\n\n- `API Rate Limits and Testing-` API-Football's rate limits initially restricted the number of requests I could make, making thorough testing difficult. To overcome this, I opted to purchase a membership, which provided a higher request limit, allowing me to perform more extensive tests.\n\n- `Loading the Current Fixture List-` Ensuring the current fixure list was displayed correctly was a challenge. I had to ensure all fixtures were complete before moving onto the next round which required handling data dependencies and making sure the state was updated after each map result.\n\n- `Deployment Issues-` During deployment on Vercel for the first time, I faced multiple build errors due to environment variable configuration. This was resolved by properly setting up .env.local and configuring the variables in Vercel's dashboard.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmullah98%2Fmy-footy-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmullah98%2Fmy-footy-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmullah98%2Fmy-footy-app/lists"}