Overview

The Croke organizer app helps you run crokinole league nights efficiently. Access it at croke.app/league. This guide covers league setup through running sessions and viewing results.

1. Creating a League

Create league screen
Creating a new league

When you first open the app, you'll create or join a league:

  1. Click Create New League
  2. Enter a 3-4 letter code to identify your league
  3. Use this code to access your league from other devices and to generate QR codes
Important: Save your league code somewhere safe - you'll need it to access your league later.

2. Setting Up a Season

Season roster
Managing the season roster

Leagues are organized into seasons. To create one:

  1. Go to Settings tab and click New Season
  2. Enter a name (e.g., "Winter 2025")
  3. Add roster members in the Season tab

Add roster members for players who have paid into the league and are officially part of the season.

Note: Guests can still join sessions, but only roster members have their stats officially tracked in standings. This is part of the incentive to pay in and join the league.

3. Linking Player Accounts

Link player screen
Linking a roster member to their account

Roster members can link their accounts to track game history in their personal dashboard at croke.app/me.

To link a roster member:

  1. Go to the Season tab and find the player in the roster
  2. Click the Link button next to their name
  3. Click Invite New Player to generate a QR code
  4. Have the player scan the QR code with their phone
  5. The player signs in with Google or email to complete linking

Once linked, the player's name appears in bold with a cyan outline in the roster, and all their league matches will automatically appear in their personal dashboard.

Tip: Previously linked players appear in the link screen, making it quick to link returning players to new roster entries.

4. Starting a Session

New session modal
Configuring a new session

Each league night is a "session". To start one:

  1. Go to Today tab and click New Session
  2. Configure settings:
    • Format - Swiss pairs players by skill level; St. Jacobs randomizes pairings
    • Color Mode - Organizer assigns disc colors, or players choose at the table
    • Score Tracking - Enable to track game-by-game results and 20s via the Player Portal
    • 1v1 Matchups - Allow singles matches when you don't have enough players for another doubles table
    • Starting Team - "At random" picks randomly; "By diddle" lets players shoot for it
  3. Add table codes and click Start Session
Tip: Use the QR Code Generator to print table codes before your session.

5. Running Rounds

Active round view
Monitoring an active round

Once players are checked in:

  1. Click Generate Round to create pairings
  2. Review matches - you can edit pairings before starting if needed
  3. Click Start Round to begin play

As players score on their phones, you'll see match states:

  • In Progress - Match is active, waiting for scores
  • Locked - Scores confirmed, match complete

Click the lock icon on any match to unlock it and edit scores directly.

Note: The organizer has final say over all scores. If players mis-click or submit incorrect results, you can always unlock and fix it.

6. Monitoring Games

Monitoring match progress
Match card showing scores and a conflict

As players submit scores from the Player Portal, results appear automatically on match cards. You don't need to do anything until:

  • The round is complete (all matches locked)
  • A conflict appears (teams entered different results)

When a conflict occurs, ask teams to verify their entries. Most conflicts resolve themselves when players correct their mistakes in the Player Portal.

If needed, click the match card to manually unlock, enter correct scores, and lock the match.

Tip: The Player Portal prevents submitting until both teams' scores match, so conflicts are rare. When they happen, it's usually a simple miscommunication.

7. Ending a Session

Session ended view
Session complete

When all rounds are complete:

  1. Click End and Save Session
  2. Confirm to save results to season history

Results are automatically added to standings. You can end early if needed - only completed rounds are saved.

8. Season Analytics

Season standings
Season standings

The Season tab shows cumulative stats across all sessions:

  • Standings - Points, games played, win %, 20s scored
  • Partner Chemistry - Heatmap of how pairings perform together
  • Session History - Results from past league nights

Tips for Smooth Sessions

  • Print QR codes beforehand using the QR Generator
  • Brief new players on the Player Portal (one person per team scores)
  • Check connectivity - ensure WiFi or cell coverage at venue
  • Keep your league code handy for accessing from other devices