Knowledge Base

Everything you need to know about using the Snooker Pool League app.

This guide covers all features of the mobile app — from creating your first league to understanding the leaderboard system and push notifications.

Getting Started

1.

Download the App

Available on iOS (App Store) and Android (Google Play). Search for “Snooker Pool League”.

2.

Create an Account

Sign up with your email address and choose a display name. This name will be visible to other league members.

3.

Create or Join a League

Create a league: Tap “Create League” from the dashboard, enter a name and description, and share the generated 6-character invite code.

Join a league: Tap “Join League”, enter the invite code, and wait for an admin to approve your request.

Leagues

Creating a League

Any registered user can create a league. You'll become the Owner with full control over league settings, members, and matches. Each league gets a unique 6-character invite code that you share with players.

Invite Codes

Invite codes are 6-character alphanumeric codes (e.g., ABC123). Share this code with players who want to join. The code is shown in your league settings.

League Settings

Owners and admins can edit league settings including the league name, description, and active status. Setting a league to inactive hides it from active views but preserves all data.

Multiple Leagues

You can be a member of multiple leagues simultaneously. Each league has its own leaderboard, match history, and member list.

Roles & Permissions

Each league has a hierarchy of four roles. Higher roles inherit all permissions of lower roles.

Player

Base role — can view league and edit own matches

Mod

Can create and edit any match

Admin

Can approve members, promote to mod, edit settings

Owner

Full control — can promote to admin, delete league

Permission Matrix

ActionPlayerModAdminOwner
View League
Edit Own Match
Create Match
Edit Any Match
Approve Members
Promote to Mod
Promote to Admin
Edit League Settings
Delete League

Matches

Creating Matches

Matches can be created by users with Mod role or higher. Select two players from the league and set up the match. The opponent (Player 2) receives a push notification when a match is created.

Scoring

Each match has scores for Player 1 and Player 2. Scores are recorded as frames won (e.g., 3-2). Either player involved in the match can update their own match score, while mods, admins, and owners can edit any match.

Completing a Match

When a match is marked as completed, the scores become final and are used for leaderboard calculations. The winner gets 3 points, a draw gives both players 1 point, and the loser gets 0 points. Both players are notified when a match is completed.

Match Views

Matches can be filtered by status (upcoming/completed), by player, or by week. This makes it easy to track your recent results or see upcoming fixtures.

Leaderboard

Points System

3

points per win

1

point per draw

0

points per loss

Sorting & Tiebreakers

Players are ranked using the following priority:

  1. Total points (descending)
  2. Number of wins (descending)
  3. Player name (alphabetical)

Standings Display

The leaderboard shows each player's position, games played, wins, draws, losses, and total points. The top 3 players receive gold, silver, and bronze position badges. Only approved league members appear on the leaderboard.

Position Notifications

When a match result causes a player to move up in the standings, any players who were overtaken receive a push notification letting them know their position has changed.

Membership

Joining a League

To join a league, enter the 6-character invite code. Your request goes to a “pending” state. Admins and owners will see your request and can approve or reject it. You'll receive a notification when your request is approved.

Approval Flow

Player requestsStatus: PendingAdmin reviewsApproved / Rejected

Member Management

Admins and owners can remove members from the league, promote players to Mod, and manage roles. Owners can additionally promote members to Admin and transfer ownership. Members can also leave a league voluntarily at any time.

Push Notifications

The app sends push notifications to keep you informed about league activity. Notifications require an iOS or Android device with notification permissions enabled.

Notification Types

Challenge Received

When another player challenges you to a match

Match Updated

When a match you're involved in is updated

Match Completed

When a match result is finalised

Join Request

When a player requests to join your league (admin/owner)

Request Approved

When your join request is approved

Position Overtaken

When another player overtakes you on the leaderboard

Admin Broadcast

When a league admin sends a broadcast message

Rate Limits

Notifications are sent via Expo Push Notification Service with rate limiting to prevent spam. Each notification type is sent once per relevant event.

Device Requirements

Push notifications require a physical iOS or Android device (not available on simulators/emulators). You'll be prompted to allow notifications when you first open the app. You can manage notification permissions in your device settings.

Still have questions?