Pokerface

Pokerface is an open-source Texas Hold'em poker assistant for Android/iOS. It is built with Dart on top of Google's Flutter Framework. It helps one to understand and play Texas Hold'em Poker better.

1b39f950-9394-49f0-a0fb-49cb6b5d5084.mp4

Table of Contents

• About the Project
• Getting Started
  • Prerequisites
  • Installation
• Features
• Usage
• Contributing
• Roadmap
• License
• Contact
• Contributors

About The Project

Pokerface is a mobile application developed using Flutter, designed to help poker players of all levels improve their game. It shows your real win probability against the table, tells you in plain language whether you're ahead and which card you need to improve your hand, and includes an optional pot-odds helper to decide whether a call is worth it. It also finds the best hands you can make from your current cards and the community cards.

Built With

• Flutter
• Dart

Getting Started

To get a local copy up and running follow these simple steps.

Prerequisites

• Flutter: Make sure you have Flutter installed on your machine. To install Flutter, follow the instructions on the Flutter official website.

Installation

1. Clone the repo

   git clone https://github.com/codenameakshay/pokerface-flutter.git

2. Navigate to the project directory

   cd pokerface-flutter

3. Install dependencies

   flutter pub get

4. Run the app

   flutter run

Features

• Win Probability: See your real chance of winning the hand — a Monte Carlo simulation against the number of players at the table — updated as each community card is revealed.
• Plain-Language Verdict: A jargon-free read on the hand (winning, too close to call, or behind), plus which card you need to improve.
• Should I Call?: An optional pot-odds helper that tells you whether a call is worth it, based on the pot and the amount to call.
• Best Hand Finder: See the best hands you can make from your current cards and the community cards, in real time.
• Themes: Choose from a range of themes to customize the app to your liking.

It also features a lot of easter eggs and cool animations to make the app more fun and engaging.

Usage

The app is simple to use and intuitive. It is designed to be user-friendly and accessible to players of all levels. The app will guide you through the process of calculating the best hand and making the best move.

Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

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

Roadmap

• Game timer (to time games)
• Currently you have to new game for each round, show option to restart when all house cards are selected
• Save game history
• Background music + SFX
• Volume control and settings
• Badges
• Achievements
• Dynamic app icons
• Calculate score for each game
• Store win/loss of each game
• Premium subscription
• Onboarding

License

Distributed under the BSD-3 License. See LICENSE for more information.

Contact

Your Name - @codenameakshay - akshaymaurya3006@gmail.com

Project Link: https://github.com/codenameakshay/pokerface-flutter

Contributors

If you made it here, thanks for your support. You can show more support by forking or starring this repo. See ya!