https://github.com/pejpero/pokercalculator
Poker Calculator is an educational mobile application built with Kotlin for Android. It allows users to add poker players, track their balances, and calculate final results including rebuys. This project is designed for learning purposes and is not intended for actual gambling use.
https://github.com/pejpero/pokercalculator
android calculator educational-project kotlin mobile mobile-app poker-game recyclerview
Last synced: 3 months ago
JSON representation
Poker Calculator is an educational mobile application built with Kotlin for Android. It allows users to add poker players, track their balances, and calculate final results including rebuys. This project is designed for learning purposes and is not intended for actual gambling use.
- Host: GitHub
- URL: https://github.com/pejpero/pokercalculator
- Owner: PejperO
- License: gpl-3.0
- Created: 2023-09-23T10:48:51.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-23T23:26:32.000Z (3 months ago)
- Last Synced: 2025-02-24T00:24:34.902Z (3 months ago)
- Topics: android, calculator, educational-project, kotlin, mobile, mobile-app, poker-game, recyclerview
- Language: Kotlin
- Homepage:
- Size: 22.2 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Poker Calculator (Educational Project)
**Disclaimer:** This project is intended for educational purposes only. It does not encourage gambling and should not be used for gambling purposes.
## Overview
This Poker Calculator application is a Kotlin-based Android app designed to calculate and manage poker player balances. It features a simple interface for adding players and tracking their results, including the handling of rebuys.
## Features
- Add new players with their names.
- Automatically set initial balance and rebuys to 0.
- Calculate final player balances considering rebuys.
- Display player information in a RecyclerView.
- A modern and responsive UI design.
## Screenshots
## Development Roadmap
### Current Features
- Basic UI for adding players.
- Calculation logic for player balances including rebuys.
### Future Improvements
1. **Persist Player Data:**
- Integrate a local database (e.g., SQLite or Room) to save player information.
- Ensure player data persists between app sessions.
2. **Historical Data Analysis:**
- Add functionality to store historical game results.
- Implement analysis features to track player performance over time.
3. **Advanced Calculations:**
- Include more advanced poker metrics and calculations.
- Allow users to input and calculate more complex poker scenarios.
4. **Cross-Platform Support:**
- Extend the application to iOS using Kotlin Multiplatform Mobile (KMM).
- Ensure seamless functionality and UI experience across both platforms.
5. **Enhanced User Interface:**
- Improve the design and usability of the app.
- Add animations and transitions for better user experience.
## Code Structure
### MainActivity.kt
- Handles the main logic of the app including adding players and calculating balances.
### activity_main.xml
- Defines the main user interface layout.
### Player.kt
- Data class representing a poker player.
### PlayerAdapter.kt
- Adapter for binding player data to the RecyclerView.
## Getting Started
### Prerequisites
- Android Studio
- Kotlin
### Installation
1. Clone the repo:
```bash
git clone https://github.com/PejperO/pokerCalculator.git
```
2. Open the project in Android Studio.
3. Build and run the project on an Android device or emulator.
## License
This project is licensed under the GPL-3.0 License. See the [LICENSE](LICENSE) file for details.
## What I Learned
- **Kotlin for Android Development:** Enhanced my understanding and proficiency in Kotlin.
- **Android UI Design:** Learned to design and implement user interfaces in Android.
- **RecyclerView and Adapters:** Gained experience in using RecyclerView to display lists of data.
- **Cross-Platform Mobile Development:** Explored the potential of Kotlin Multiplatform Mobile (KMM) for creating cross-platform apps.
- **Software Licensing:** Understood the implications of GPL-3.0 license for open-source projects.