https://github.com/inaxdeveloper/inaxesports
Tournament App
https://github.com/inaxdeveloper/inaxesports
Last synced: 7 days ago
JSON representation
Tournament App
- Host: GitHub
- URL: https://github.com/inaxdeveloper/inaxesports
- Owner: INAxDeveloper
- Created: 2024-11-09T05:25:07.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-24T11:08:31.000Z (12 months ago)
- Last Synced: 2025-03-24T12:26:07.744Z (12 months ago)
- Language: Kotlin
- Size: 1.05 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# INAxEsports
Tournament App
# Tournament App
## 📱 Overview
Tournament App is a mobile application that allows users to participate in, organize, and manage tournaments seamlessly. Whether you're a solo player or part of a team, this app makes it easy to join tournaments, track scores, and compete for exciting prizes.
## 🚀 Features
- **User Authentication**: Sign in using Google or email.
- **Tournament Management**: Create, join, and manage tournaments with ease.
- **Bracket System**: Automatically generate single or double elimination brackets.
- **Team Management**: Create and manage teams with detailed profiles.
- **Live Match Updates**: Get real-time scores and updates.
- **Leaderboards**: View rankings and player statistics.
- **Notifications**: Stay informed with push notifications for upcoming matches and tournament updates.
- **Secure Payments**: Integrated payment gateway for entry fees and prize distribution.
- **Social Interaction**: Team chats, community forums, and social media sharing.
## 🛠️ Tech Stack
- **Frontend**: Kotlin (Android)
- **Backend**: Firebase Authentication, Firestore, Firebase Realtime Database
- **Payment Integration**: Razorpay
- **Live Streaming**: YouTube API (for match streams)
- **Image Loading**: Glide
## 📂 Project Structure
## 🔧 Installation
1. **Clone the repository**:
```bash
git clone https://github.com/yourusername/tournament-app.git
cd tournament-app
```
2. **Open in Android Studio**:
- Open Android Studio and select "Open an existing project."
- Choose the project folder you just cloned.
3. **Configure Firebase**:
- Add your `google-services.json` file to the `/app` directory.
- Ensure Firebase Authentication, Firestore, and Realtime Database are set up in your Firebase Console.
4. **Build and Run**:
- Click the "Run" button in Android Studio or use:
```bash
./gradlew assembleDebug
```
## 📸 Screenshots
| Home Screen | Tournament Details | Bracket View |
|-------------|--------------------|--------------|
| |  |  |
## 🎨 UI/UX Design
- The app follows a modern and intuitive design, inspired by Material Design guidelines.
- Primary color: `#3498db`
- Secondary color: `#2ecc71`
## 🤝 Contribution
Contributions are welcome! Please follow these steps:
1. Fork the project.
2. Create your feature branch (`git checkout -b feature/AmazingFeature`).
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`).
4. Push to the branch (`git push origin feature/AmazingFeature`).
5. Open a pull request.
## 📝 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🌐 Connect with Me
- **LinkedIn**: [Paresh Chauhan](https://www.linkedin.com/in/paresh-chauhan)
- **Email**: [paresh@example.com](mailto:paresh@example.com)
- **Portfolio**: [pareshchauhan.dev](https://www.pareshchauhan.dev)
## 📬 Support
If you have any questions, feel free to open an issue or contact me directly.
---
Thank you for checking out my project! 🌟
🏆 Tournament App
📖 Table of Contents
Overview
Features
Tech Stack
Architecture
Screenshots
Installation
Usage
API Endpoints
Database Structure
Contributing
Roadmap
License
Contact
📱 Overview
Tournament App is an all-in-one platform for organizing, managing, and participating in gaming tournaments. Whether you're a solo gamer or part of a team, the app offers an intuitive interface to explore and join various tournaments across multiple game titles. Designed for esports enthusiasts, this app helps streamline tournament management, making it easier for organizers and participants to engage in competitive events.
🚀 Features
🔑 User Authentication
Google & Email Login: Secure sign-in with Google or email credentials.
Profile Management: Users can create detailed profiles with avatars, bios, and gaming stats.
🏆 Tournament Management
Create & Join Tournaments: Users can host or join existing tournaments.
Tournament Dashboard: View tournament details, rules, prize pools, and participants.
Automated Bracket Generation: Supports single elimination, double elimination, and round-robin formats.
Match Scheduling & Results: Organizers can schedule matches, and update scores and results in real-time.
🧑🤝🧑 Team Management
Team Creation: Create teams, invite members, and manage team profiles.
Team Stats & Rankings: Track team performance, achievements, and leaderboards.
📊 Live Scores & Streaming
Real-Time Match Scores: Live score updates during ongoing matches.
Integrated Live Streaming: Watch live matches via YouTube or Twitch.
Match Highlights: Replay match highlights and top moments.
📱 Notifications & Alerts
Push Notifications: Stay updated with match schedules, tournament announcements, and results.
In-App Alerts: Receive notifications about new tournaments, match results, and more.
🏅 Leaderboards & Achievements
Global Leaderboard: Compete for top spots with players from around the world.
Seasonal Rankings: Track performance across different seasons and tournaments.
💰 Payment & Prizes
Secure Payment Gateway: Pay entry fees and receive prizes through Razorpay or PayPal.
Automated Prize Distribution: Seamlessly distribute prizes to winners.
💬 Social Interaction
Team & Match Chat: Communicate with teammates and opponents.
Community Forum: Discuss strategies, share tips, and engage with the community.
Social Sharing: Share tournament links, achievements, and match results on social media.
🛠️ Tech Stack
Frontend: Kotlin (Android), XML (UI Design)
Backend: Firebase (Authentication, Firestore, Realtime Database)
Cloud Functions: Firebase Cloud Functions for server-side logic
Streaming: YouTube API, Twitch API
Payments: Razorpay, PayPal SDK
Image Loading: Glide for efficient image handling
Push Notifications: Firebase Cloud Messaging (FCM)
🏗️ Architecture
The app follows the MVVM (Model-View-ViewModel) architecture pattern for a clear separation of concerns, improved testability, and scalability.
Model: Data classes and Firebase Firestore models.
View: Activities, Fragments, and XML layouts.
ViewModel: Manages UI-related data and business logic, communicates with the Repository.
Repository: Handles data operations and acts as a bridge between ViewModel and Firebase.
Firestore Database
├── Users
│ ├── UserID
│ ├── username
│ ├── email
│ ├── profilePic
│ ├── joinedTournaments
│ ├── teamID
├── Teams
│ ├── TeamID
│ ├── teamName
│ ├── members
│ ├── achievements
├── Tournaments
│ ├── TournamentID
│ ├── title
│ ├── gameType
│ ├── entryFee
│ ├── prizePool
│ ├── schedule
│ ├── participants
│ ├── bracket
│ ├── results
🛠️ Contributing
Contributions are welcome! Follow these steps:
Fork the repository
Create a new branch: git checkout -b feature/YourFeature
Commit your changes: git commit -m 'Add your feature'
Push to the branch: git push origin feature/YourFeature
Create a Pull Request
🛣️ Roadmap
Add support for more games (e.g., Free Fire, Call of Duty)
Implement voice chat for teams
Introduce a loyalty rewards system
Expand payment options (Crypto, Apple Pay)
Add iOS support (using Swift)
📝 License
This project is licensed under the MIT License - see the LICENSE file for details.
📧 Contact
Feel free to reach out if you have any questions!
Name: Paresh Chauhan
Email: paresh@example.com
LinkedIn: Paresh Chauhan
Portfolio: pareshchauhan.de