Skip to main content

Riichi Tracker - Case study

· 3 min read
Gerard Konopielko
Gerard Konopielko

Riichi Tracker

Problem​

Riichi Mahjong, a popular variation of Mahjong, involves complex rules and intricate point counting, making the game challenging to track, especially for new players. Many players rely on tracking apps for accurate scorekeeping due to the game’s detailed scoring system. However, the only prominent app, Mahjong Tracker, was available exclusively on Android.

Mahjong Tracker Mahjong Tracker, source: Google Play

Solution​

To address these issues, I created Riichi Tracker, an iOS app designed as a streamlined alternative to the existing Android solution. Built using Swift, SwiftUI, SwiftData, and Swift Charts, the app adheres to Apple’s Human Interface Guidelines, ensuring a native look and feel.

Riichi Tracker

Development Process​

During the development of Riichi Tracker, I focused on simplifying the user experience while retaining all essential features. I chose Swift, SwiftUI, SwiftData, and Swift Charts to build the app, taking advantage of native iOS components to enhance usability and performance. A key feature was the streamlined hand input method: instead of navigating through multiple screens, users could input everything related to a round’s end on a single sheet, making the process more intuitive. I also integrated a score chart directly into the app, something that was only accessible via a website in the Android version.

The core functionality involves creating a game and recording the outcome of each round. Players can input how the round ended — whether someone won, who caused the win, or if it ended in a tie—along with the Han and Fu values. The app then automatically calculates and updates the scores. Designed to be placed at the center of a Mahjong table, Riichi Tracker allowes all players to view their scores, the number of Riichi and Honba sticks, and the current round status in real-time.

Unique Selling Points​

Riichi Tracker distinguishes itself from Mahjong Tracker through several key features:

  • Native iOS Design: Adhering to Apple’s Human Interface Guidelines, the app utilizes native iOS components, offering a look and feel familiar to iOS users.
  • Simplified Hand Input: The new hand input method consolidates all necessary information into a single sheet, making it easier for users to log rounds without navigating through multiple screens.
  • Integrated Score Chart: Including the score chart directly in the app, rather than relegating it to a website, provides a more seamless and informative experience.
  • Offline Capability: Unlike the Android app, Riichi Tracker works offline, ensuring uninterrupted gameplay.

User Feedback and Testing​

Before development, I engaged with regular Mahjong players, observing how they used the Android app during offline Mahjong sessions. This hands-on research helped me identify key pain points, particularly the hand input method, which inspired the design of Riichi Tracker. After the initial version was developed, I shared the app with iOS Mahjong players for feedback. This iterative feedback loop ensured the app met the needs and expectations of the community.

Future Plans​

I plan to update Riichi Tracker in line with changes to various Mahjong rules and implement region-specific rules to cater to different player bases. Additional features, such as a timer and the ability to declare Riichi while the hand is still in play, are also on the roadmap. This app has not only benefited the Mahjong community but has also given me an opportunity to practice and refine my iOS development skills.

See the result