IZI Mobile App for Gaming Club Players

IZI Mobile App for Gaming Club Players

The IZI mobile app is the player-facing companion to IZI club management software. It gives club guests real-time visibility into their balance and session, and lets them interact with the club from their phone — topping up, ordering from the bar, managing their active session, and receiving operator notifications.

From a club owner’s perspective the app reduces front-desk load: players handle routine actions (balance check, top-up, session extension) themselves, staff focus on higher-value tasks.

---

What the app covers

The mobile app is organised around six core areas. Each is a separate screen accessible from the bottom navigation or side menu.

Map and club finder

The home screen opens a Google Maps view with pins for every club in the player’s region. The app resolves the player’s location and performs an initial zoom toward the nearest club. Tapping a pin shows the club details — name, address — and leads into the club’s booking or bar flow.

Tariff selection and session booking

After choosing a club and a zone (PC zone, console zone, etc.) the player browses the available tariffs — time-based or multipass plans — and picks a duration. The app loads a fresh tariff catalogue on each visit and clears any prior draft selection so the player always sees current pricing and availability.

Payment happens at this step using a saved card, Apple Pay, or Google Pay. Once confirmed, the session is created and the player proceeds to their seat.

Active session management

When a session is running, the app shows a dedicated management screen with:

• A live countdown timer synced to the server, aligned to wall-clock minutes.
• The current PC status (running or blocked/paused).
• A toggle to block or unblock the PC remotely — useful when a player steps away.
• Remaining-time alerts: when time drops below a threshold, a banner offers a fast top-up or a tariff extension without visiting reception.
• Controls to cancel an upcoming booking or end the session early.

Session state stays in sync via real-time status updates pushed from the backend.

Payment methods and membership cards

The Payment & Membership screen (ClubMembershipsPage) lists every club where the player has an active account. Each club card shows:

• Gaming balance — the spendable balance for computer time.
• Bonus balance — earned bonus points (shown as the secondary “bolt” figure).
• Promo code block — the player’s current active promo code, if any.
• Linked payment methods — saved cards with their last-four digits. Players can add new cards, remove old ones, and configure auto-renewal.

Auto-renewal uses the designated card to extend the session automatically when time expires. The player selects the auto-renewal card per club.

The same screen is accessible from inside any club flow as a bottom-sheet modal when the context requires it (for example, adding a card while purchasing a tariff).

Bar ordering

Inside a club, the bar feature (MobileBarHomeScreen) lets players browse the club’s food and drink catalogue. The screen supports:

• Product listings with search.
• Combo and promo detail pages.
• In-app ordering — an order is placed from the seat.
• Order history accessible from the Orders screen.

This replaces or supplements a physical menu and reduces wait-staff interactions for simple orders.

Notifications

The Notifications screen stores the player’s push notification inbox. Operators can send session-time alerts, announcements, and promotional messages via FCM (Firebase Cloud Messaging). Players can scroll through notification history directly in the app without needing to re-open system notification banners.

---

How balance and bonuses work in the app

The app shows two distinct balances per club:

• Gaming balance (also called cash balance) — topped up by the player, spent on computer time.
• Bonus balance — awarded by the club’s automation rules (for example, a top-up bonus when reloading above a certain amount).

These map directly to the concepts described in the bonus and retention section. The app pulls them from the same GraphQL API the CRM uses, so what the front desk sees and what the player sees is always consistent.

---

Club operator perspective

Club staff do not configure the mobile app directly — it inherits its data from the CRM. Key links:

• Tariffs: what the player sees in the tariff picker is exactly what is published in Tariffs & Pricing. Unpublished or zone-restricted tariffs do not appear.
• Bar catalogue: the product list and combos come from the bar and warehouse module. Only items marked available in the CRM show up in the app.
• Player account: created automatically when the player registers with a phone number linked to a club visit.
• Push notifications: sent from the CRM’s notification tool and delivered via FCM. The Notifications screen in the app is the read inbox for those messages.

No separate mobile app admin panel exists. The app is a read/act layer on top of IZI’s existing data model.

---

Technical overview (for integration questions)

The IZI player app is built with Flutter using a Melos sub-monorepo structure. Core logic lives in the shared package and is reused by:

• The mobile shell (iOS and Android — this app).
• The widget shell (Windows desktop widget used at club stations).
• The iZi.Boss app (owner-facing companion, separate build).

Authentication is phone-number OTP with optional email login. GraphQL over WebSocket handles real-time session state. Payment card tokenization flows through a WebView redirect so the app itself never handles raw card numbers.

The iOS build includes a Live Activities implementation targeting the Dynamic Island and Lock Screen (session countdown). This is built in the current codebase but deployed with a kill-switch; enabling it is a configuration change, not a code change.

---

FAQ

What can a player do in the IZI mobile app? Players can view their gaming and bonus balances, top up via saved card or Apple Pay / Google Pay, browse and activate tariffs, manage an active session (pause, extend, end), order food and drinks from the bar menu, and receive push notifications about session time, promos, and news.

Does the app work across multiple clubs of the same network? Yes. The app uses a map to show all clubs in your region. After phone-number registration, the player account is linked to each club separately. Balances, payment methods, and membership cards are shown per club on the Payment & Membership screen.

How does session management work in the app? Once a session is active at the club, the app shows a live countdown timer, the current PC status, and controls to pause (block PC) or end the session. When time is running low, a banner appears offering a quick top-up or tariff extension without visiting the front desk.

Can a player top up balance through the app? Yes. Players can add a bank card (via WebView tokenization), set one card as default for auto-renewal, and top up directly in the app. Apple Pay and Google Pay are supported on compatible devices.

What is auto-renewal and how does a player enable it? Auto-renewal automatically extends a session when time is about to run out, using the linked payment method. Players enable it per club in the Payment & Membership section by selecting a saved card as the auto-renewal source.

Does the IZI app support iOS Live Activities? The codebase contains a Live Activities implementation (Dynamic Island and Lock Screen widget showing session countdown). As of the reviewed codebase, the feature has a kill-switch set to disabled. Session time is shown in the in-app timer instead.

How do push notifications work? The app uses Firebase Cloud Messaging for push delivery. Players receive notifications for session time alerts, promos, and operator announcements. A Notifications page stores the inbox history so players can review past messages.

What is the bar feature in the app? Players inside a club can browse the club’s food and drink menu, view product and combo detail pages, and place an order without leaving their seat. Orders are tracked in the app under the Orders screen.

Is registration required to use the app? Yes. Registration uses a phone number verified by OTP. The same phone number ties the player account to all IZI clubs. Optional email login is also available.

What platforms is the IZI player app available on? The app is built with Flutter and targets both iOS and Android. It shares core logic with the IZI Windows desktop widget used at club stations.