Skip to content

Latest commit

ย 

History

9 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

FoldOrRaise.ai โ€” Preflop GTO Compass ๐Ÿƒ๐Ÿš€

Hyper-Fast Preflop GTO Compass โ€” An agile decision utility for independent players to realize hand equity.

๐ŸŒ Language: English | ็ฎ€ไฝ“ไธญๆ–‡

GitHub license GitHub stars Live Demo


๐ŸŒ Live Demo

๐Ÿš€ Play Now: https://huangq-dev.github.io/fold-or-raise/ (100% Client-Side. No Servers. Zero Tracking. Provably Private. Perfect for PC & Mobile.)


๐ŸŽฏ Core Positioning & Use Cases (MVP Stage)

This project follows an Agile Evolution (MVP) protocol. The current 1.0 (Proof of Concept) version is strictly scoped to a specific, hard-core Texas Hold'em scenario:

  • Stack Depth: Calibrated for 10BB - 25BB short-stack tournament scenarios where post-flop playability converges into a pure Push or Fold mathematical model.
  • Action Context: Simulates an Unopened Pot where all prior positions have folded, forcing an opening decision on the current player.
  • Dimensional Multi-linking: Supports dynamic matrix updates and equity value counting triggered by 3 Stack Levels (10BB/15BB/25BB) and 3 Key Positions (UTG, CO, BTN).

๐Ÿ› ๏ธ Tech Stack & Design Highlights

Cyberpunk UI Aesthetics (Vue 3 Single File)

  • Zero-Compile Build: Powered by Vue 3 (Global Prod) + Tailwind CSS runtime. No Webpack/Vite build overhead; instant page loads.
  • Matrix Dashboard: A 13x13 grid rendering custom CSS neon glows, custom SVG background grids, and JetBrains Mono fonts.
  • Fluid Animations: Custom cubic-ease dampening functions driving responsive count-up animations for hand equity.
  • Self-Contained i18n: Pure JS path-parser enabling seamless, dependency-free toggling between English (EN) and Chinese (ZH).

๐Ÿ—บ๏ธ Engineering Roadmap

We reject over-engineered hype, adhering strictly to Tool-based Rationalism and gradual evolution:

  • Phase 1: Proof of Concept (POC) โ€” Deliver 13x13 grid rendering, dual-language toggling, and interactive multi-variable mock matrices. (Current)
  • Phase 2: Java Calculation Factory โ€” Build an offline multi-threaded Java engine to pre-compute hyper-accurate strategy matrices via billions of Monte Carlo simulations.
  • Phase 3: Real-time Reactive Pipeline โ€” Implement a Java WebFlux async backend to stream instant equity data based on live player counts and raw card inputs.

๐Ÿ›ก๏ธ Legal Disclaimer

This utility is strictly an offline mathematical training and strategy validation tool. It features NO multiplayer functions and NO real-money/crypto wagering capabilities. 100% legal, compliant, and intended solely for scientific and research purposes.


๐Ÿ‘จโ€๐Ÿ’ป Developer / Author

  • Quentin (GitHub: @huangq-dev)
  • If this compass saved your stack, drop a โญ Star to support the journey!

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages