{"id":18275815,"url":"https://github.com/gr7800/live_cricket_scoring_app","last_synced_at":"2025-04-09T04:14:09.617Z","repository":{"id":254225306,"uuid":"845465715","full_name":"gr7800/Live_Cricket_Scoring_App","owner":"gr7800","description":null,"archived":false,"fork":false,"pushed_at":"2024-08-23T14:26:49.000Z","size":267,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-14T22:32:36.764Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://khel-ai-assignment.netlify.app","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/gr7800.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-08-21T10:02:42.000Z","updated_at":"2024-08-23T14:26:52.000Z","dependencies_parsed_at":"2024-08-22T06:25:31.435Z","dependency_job_id":"6876a78f-18a7-4332-8f2f-d1eaea6f4655","html_url":"https://github.com/gr7800/Live_Cricket_Scoring_App","commit_stats":null,"previous_names":["gr7800/live_cricket_scoring_app"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gr7800%2FLive_Cricket_Scoring_App","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gr7800%2FLive_Cricket_Scoring_App/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gr7800%2FLive_Cricket_Scoring_App/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gr7800%2FLive_Cricket_Scoring_App/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gr7800","download_url":"https://codeload.github.com/gr7800/Live_Cricket_Scoring_App/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247974731,"owners_count":21026742,"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":[],"created_at":"2024-11-05T12:14:08.864Z","updated_at":"2025-04-09T04:14:09.602Z","avatar_url":"https://github.com/gr7800.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Live Cricket Scoring Application\n\n## Overview\n\nThe Live Cricket Scoring Application is a comprehensive platform for simulating real-world cricket scoring. It includes features for real-time updates, interactive scoreboards, user management, and more. The application is built with a Node.js backend using Express and MongoDB for data management, and it supports real-time communication using WebSockets or Server-Sent Events (SSE).\n\n## Features\n\n- **Real-Time Updates**: Seamless score updates without page refreshes using WebSockets or SSE.\n- **Interactive Scoreboard**: Dynamic display of multiple innings, overs, runs, wickets, run rates, and other metrics.\n- **User Interface**: Intuitive and responsive design for easy interaction.\n- **Authentication**: Basic user authentication to protect match data.\n- **Error Handling**: Robust error handling for invalid inputs and unexpected responses.\n- **Optional Features**:\n  - Commentary\n  - Player Statistics\n  - Match History\n  - Mobile Optimization\n  - Social Sharing\n\n## Installation\n\n### Prerequisites\n\n- [Node.js](https://nodejs.org/) (version 14.x or later)\n- [MongoDB](https://www.mongodb.com/) (version 4.x or later)\n- [npm](https://www.npmjs.com/) (Node package manager)\n\n### Setup\n\n1. **Clone the Repository**\n\n   ```bash\n   git clone https://github.com/your-username/cricket-scoring-app.git\n   cd cricket-scoring-app\n   ```\n\n2. **Install Dependencies**\n\n   ```bash\n   npm install\n   ```\n\n3. **Configure Environment Variables**\n\n   Create a `.env` file in the root directory with the following content:\n\n   ```\n   MONGO_URI=\u003cYour MongoDB URI\u003e\n   PORT=5000\n   ```\n\n4. **Run the Application**\n\n   For development:\n\n   ```bash\n   npm run dev\n   ```\n\n   For production:\n\n   ```bash\n   npm start\n   ```\n\n## API Endpoints\n\n### Create a New Match\n\n- **URL**: `/api/matches`\n- **Method**: `POST`\n- **Body**:\n  ```json\n  {\n    \"teamA\": \"Team A\",\n    \"teamB\": \"Team B\",\n    \"overs\": 20\n  }\n  ```\n- **Response**: \n  ```json\n  {\n    \"_id\": \"matchId\",\n    \"teams\": {\n      \"teamA\": \"Team A\",\n      \"teamB\": \"Team B\"\n    },\n    \"overs\": 20,\n    \"innings\": [],\n    \"currentInning\": 0,\n    \"matchStatus\": \"not started\"\n  }\n  ```\n\n### Get Match Details\n\n- **URL**: `/api/matches/:id`\n- **Method**: `GET`\n- **Response**:\n  ```json\n  {\n    \"_id\": \"matchId\",\n    \"teams\": {\n      \"teamA\": \"Team A\",\n      \"teamB\": \"Team B\"\n    },\n    \"overs\": 20,\n    \"innings\": [\n      {\n        \"battingTeam\": \"Team A\",\n        \"runs\": 10,\n        \"wickets\": 2,\n        \"oversBowled\": 5,\n        \"balls\": 30\n      }\n    ],\n    \"currentInning\": 1,\n    \"matchStatus\": \"in progress\"\n  }\n  ```\n\n## Real-Time Updates\n\nReal-time updates are handled using WebSockets or Server-Sent Events (SSE). Ensure your frontend is set up to connect to the WebSocket or SSE endpoint to receive live match updates.\n\n## Contributing\n\n1. **Fork the Repository**\n2. **Create a Feature Branch**\n3. **Commit Your Changes**\n4. **Push to the Branch**\n5. **Open a Pull Request**\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\n- [Express](https://expressjs.com/) - Fast, unopinionated, minimalist web framework for Node.js\n- [MongoDB](https://www.mongodb.com/) - NoSQL database for storing match data\n- [WebSockets](https://developer.mozilla.org/en-US/docs/Web/API/WebSockets_API) - For real-time communication\n\nFor more details and updates, check out our [documentation](https://your-project-docs-link).\n```\n\nFeel free to customize the details according to your project specifics and any additional instructions or features you may have.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgr7800%2Flive_cricket_scoring_app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgr7800%2Flive_cricket_scoring_app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgr7800%2Flive_cricket_scoring_app/lists"}