Skip to content

Commit

Permalink
Update readme description
Browse files Browse the repository at this point in the history
  • Loading branch information
cp-mayank committed Oct 1, 2024
1 parent ba30053 commit 74d95e6
Show file tree
Hide file tree
Showing 3 changed files with 51 additions and 64 deletions.
115 changes: 51 additions & 64 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,64 +1,63 @@
<p align="center"> <a href="https://canopas.com/contact"><img src="./cta/cta_banner.png"></a></p>
<p align="center"> <a href="https://canopas.com/contact"><img src="./cta/cta_banner.png" alt=""></a></p>

# Khelo- From Streets to Stadiums 🏏
Khelo - an open-source ultimate companion for all things cricket!
# Khelo - From Streets to Stadiums 🏏
**Your Ultimate Companion for Cricket Management**

<img src="./screenshots/cover-image.png" />
<img src="./screenshots/cover-image.png" alt=""/>

## Overview
Welcome to Khelo, an open-source multi-platform app designed to cater to all your cricket needs, whether you're a cricket enthusiast, a team manager, or a player. With a wide array of features, our app simplifies the management of cricket teams, players, matches, and performance records.
It's like having a personal assistant for your team!
Welcome to Khelo, an open-source multi-platform app designed to cater to all your cricket needs, whether you're a cricket enthusiast, a team manager, or a player. With a wide array of features, our app simplifies the management of cricket teams, players, matches, and performance records. It's like having a personal assistant for your team!

Khelo is an open-source Flutter project written in Dart using Firestore database, Firebase authentication, and cloud firestore. This project uses Riverpod as state management library and it adapts clean architecture approach, organized into multiple modules.
Khelo is built using Flutter and Dart, leveraging Firestore for database management and Firebase for authentication. This project employs Riverpod as its state management solution, adhering to a clean architecture approach organized into multiple modules.

## Download App

<a href= "https://play.google.com/store/apps/details?id=com.canopas.khelo"><img src="./cta/google play.png" width="200" ></img> <a href="https://apps.apple.com/us/app/khelo/id6480175424"><img src="./cta/app store.png" width="200"></img>
<a href="https://play.google.com/store/apps/details?id=com.canopas.khelo"><img src="./cta/google_play.png" width="200"></a>
<a href="https://apps.apple.com/us/app/khelo/id6480175424"><img src="./cta/app_store.png" width="200"></a>

## Screenshots
<table>
<tr>
<th width="32%" >Matches Record</th>
<th width="32%" >Teams List</th>
<th width="32%" >Start New Match</th>
<th width="32%">Matches Record</th>
<th width="32%">Teams List</th>
<th width="32%">Start New Match</th>
</tr>
<tr>
<td><img src="./screenshots/screen_shot_1.png" /></td>
<td> <img src="./screenshots/screen_shot_2.png" /> </td>
<td> <img src="./screenshots/screen_shot_3.png" /> </td>
<tr>
<td><img src="./screenshots/screen_shot_1.png" alt=""/></td>
<td><img src="./screenshots/screen_shot_2.png" alt=""/></td>
<td><img src="./screenshots/screen_shot_3.png" alt=""/></td>
</tr>
</table>

<table>
<tr>
<th width="32%" >Score Board</th>
<th width="32%" >Commentary</th>
<th width="32%" >Squad</th>
<th width="32%">Score Board</th>
<th width="32%">Commentary</th>
<th width="32%">Squad</th>
</tr>
<tr>
<td><img src="./screenshots/screen_shot_4.png" /></td>
<td> <img src="./screenshots/screen_shot_5.png" /> </td>
<td> <img src="./screenshots/screen_shot_6.png" /> </td>
<tr>
<td><img src="./screenshots/screen_shot_4.png" alt=""/></td>
<td><img src="./screenshots/screen_shot_5.png" alt=""/></td>
<td><img src="./screenshots/screen_shot_6.png" alt=""/></td>
</tr>
</table>


## Features 🌟🌟

- **Profile Management**: Create and manage profiles for players, coaches, and team managers effortlessly.
- **Team Creation**: Form your dream team by adding players and managing team compositions with ease.
- **Player Management**: Keep track of player details, including statistics, performance history, and personal information.
- **Match Data Recording**: Record detailed match data, including scores, wickets, runs, and other custom metrics, providing a comprehensive overview of each game.
- **Performance Tracking**: Monitor and analyze player performance over time, enabling informed decision-making and strategic planning.
- **Team Statistics**: Gain insights into team performance through comprehensive statistical analysis and reporting tools.
- **Toss Details**: Record toss details, including which team won the toss and their choice, enhancing match documentation and analysis.
- **Profile Management**: Effortlessly create and manage profiles for players, coaches, and team managers.
- **Team Creation**: Form your dream team by easily adding players and managing team compositions.
- **Player Management**: Keep track of player statistics, performance history, and personal information.
- **Match Data Recording**: Record detailed match data, providing a comprehensive overview of scores, wickets, and custom metrics.
- **Performance Tracking**: Analyze player performance over time for informed decision-making.
- **Team Statistics**: Gain insights into team performance through comprehensive statistical analysis and reporting.
- **Toss Details**: Document toss results, including winning teams and choices, for improved match analysis.

> **Note**: Khelo is currently in active development🚧, with plans to incorporate additional features shortly.
> **Note**: Khelo is currently in active development 🚧, with plans to introduce additional features soon!
## Requirements ✅

<details>
<summary> Click to expand </summary>
<summary> Click to expand </summary>
<br>

**Khelo** requires the following to function properly:
Expand All @@ -79,6 +78,7 @@ Khelo is an open-source Flutter project written in Dart using Firestore database
- **Android (if targeting Android):**
- An Android device or emulator for development and testing.
- Android Studio (optional, but recommended) for development: [Download Android Studio](https://developer.android.com/studio)

- **iOS (if targeting iOS):**
- A Mac computer with Xcode installed for development and testing.

Expand All @@ -90,51 +90,38 @@ Khelo is an open-source Flutter project written in Dart using Firestore database

## Technologies Stack 📚

Khelo utilizes the latest Flutter app development technologies and adheres to industry best
practices. Below is the current technologies stack used in the development process:

- MVVM Architecture
- Flutter
- Dart
- Http
- Dio
- GoRouter
- RiverPod
- Firebase Authentication
- Firebase Firestore
- Cloud Functions
Khelo leverages modern Flutter development technologies, adhering to industry best practices. Below is our current technology stack:

- **MVVM Architecture**: A design pattern that separates the user interface from business logic, enhancing testability.
- **Flutter**: A UI toolkit for building natively compiled applications.
- **Dart**: The programming language used to write Flutter apps.
- **Http & Dio**: Libraries for making network requests.
- **GoRouter**: A declarative routing package for Flutter.
- **RiverPod**: A state management solution that is simple and powerful.
- **Firebase Authentication**: For secure user authentication.
- **Firebase Firestore**: A scalable database for storing app data.
- **Cloud Functions**: To run backend code in response to events triggered by Firebase features.

## Contribution 🤝
Khelo is an open-source project but currently, we are not accepting any contributions.

Khelo is an open-source project, but we are not currently accepting contributions. However, we appreciate community feedback and suggestions for future improvements.

## What's Coming Next? 🚀

- **Tournament Feature**: Khelo will soon support tournament management, allowing users to organize
and track cricket tournaments with ease, right from the app.
- **Live Streaming**: Watch live matches directly through Khelo as we introduce live streaming, making
it easier to follow your favorite teams and matches in real time.
- **Voice-Over Scoring**: Get an immersive cricket experience with voice-over scoring, providing
live commentary and score updates as the game unfolds.
- **Improve User Experience**: We're continuously working on improving the user experience, with
plans to incorporate additional features and enhancements shortly.

- **Tournament Feature**: Khelo will soon support tournament management, allowing users to organize and track cricket tournaments with ease, right from the app.
- **Live Streaming**: Watch live matches directly through Khelo as we introduce live streaming, making it easier to follow your favorite teams and matches in real time.
- **Voice-Over Scoring**: Get an immersive cricket experience with voice-over scoring, providing live commentary and score updates as the game unfolds.
- **Improve User Experience**: We're continuously working on improving the user experience, with plans to incorporate additional features and enhancements shortly.

## Feedback & Suggestions ✨

We welcome and appreciate any suggestions you may have for improvement.

For bugs, questions and discussions please use the [Github Issues](https://github.com/canopas/khelo/issues).

We welcome and appreciate any suggestions you may have for improvement. For bugs, questions, and discussions, please use the [GitHub Issues](https://github.com/canopas/khelo/issues).

## Credits 💻
Khelo is owned and maintained by the [Canopas team](https://canopas.com/).

You can follow them on Twitter at [@canopassoftware](https://twitter.com/canopassoftware) for project updates and releases. If you are interested in building apps or designing products, please let us know. We'd love to hear from you!
Khelo is owned and maintained by the [Canopas team](https://canopas.com/).

<a href="https://canopas.com/contact"><img src="./cta/cta_btn.png" alt="Contact Canopas" width=300></a>
You can follow them on Twitter at [@canopassoftware](https://twitter.com/canopassoftware) for project updates and releases. If you are interested in building apps or designing products, please let us know. We'd love to hear from you!

<a href="https://canopas.com/contact"><img src="./cta/cta_btn.png" alt="Contact Canopas" width="300"></a>

## Licence 📄

Expand Down
File renamed without changes
File renamed without changes

0 comments on commit 74d95e6

Please sign in to comment.