MoslemT7/TuniSport-API

TuniSport.tn is a national multi-sport data platform for Tunisia, providing structured APIs and tools to manage and access reliable information about Football, Handball, Basketball, and more. This repo contains the backend code powering the API, with plans to support a full web and mobile experience. # 🏅 TuniSport-API **TuniSport-API** is a national-level open-source initiative that aims to build a unified, reliable, and scalable API system for all major sports in Tunisia, starting with Football, Handball, and Basketball. This project powers **TuniSport.tn** — a centralized platform for sports data — and will also support the development of a dedicated **mobile application** for fans, journalists, scouts, and analysts. --- ## 🎯 Project Goal TuniSport-API is designed to: - 🗃️ **Collect** and structure sports data across multiple disciplines. - ⚽ 🏀 🤾 **Support Football, Basketball, and Handball** in Tunisia at all levels (Professional, Amateur, Youth). - 📡 **Expose RESTful API endpoints** to deliver live or historical data. - 📱 **Feed a web platform and mobile application** to present insights to users in a user-friendly way. - 🔄 Allow **future contribution, automation, and scalability** across regions and sports. --- ## 🌐 Ecosystem Overview | Component | Description | |------------------|---------------------------------------------------------------| | `TuniSport-API` | Core backend (Node.js, Express, PostgreSQL/Supabase) | | `TuniSport.tn` | Official web platform (React.js / Next.js frontend) | | `TuniSport App` | Cross-platform mobile application (React Native or Flutter) | --- ## 📚 Features - 🏆 **Multi-sport coverage** (starting with Football, Handball, Basketball) - 🏟️ Fixtures, Results, Standings, and Player Stats - 📈 Historical season tracking (since early 2000s if available) - 🔍 Player profiles, match events, and goal scorers - 📊 Real-time updates for live competitions (future) - 🧩 Modular architecture: scalable to Volleyball, Rugby, etc. - 🛠️ Admin dashboard (future) for data entry and validation --- ## 🛠️ Tech Stack - **Backend**: Node.js, Express, PostgreSQL, Supabase - **Frontend (Website)**: React.js, TailwindCSS, Vite - **Mobile App**: React Native (pla …