PickleStax: Pickleball — Mobile App Manual

1. Home screen

• Start New Session — Opens the create-session flow.
• Resume Session — If you left a session open, use this to go back to it.
• Players — Manage your player list (add, edit, view).
• Leaderboard — View rankings (ELO).
• History — Past sessions and match history.

Tap ? (top right) to run the in-app tour.

2. Adding players

Before or without a session

1. From Home, tap Players.
2. Tap the green + Add Player button (bottom right).
3. Enter name, optional phone, DUPR (skill), avatar color, and whether they're a Guest.
4. Tap Save. The player is added to your roster.

During a session

1. With a session active, the top bar shows the session name and a + (add person) icon.
2. Tap + to open Check In Player.
3. Search or scroll, tap a player, then Check In or Check In & Queue.

• Check In — Marks them present.
• Check In & Queue — Marks them present and adds them to the queue.

You can also add people from the Queue tab (see below).

3. Creating a session

1. From Home, tap Start New Session.
2. Fill in:
   • Organizer name — Who is running the session.
   • Password — Required to create (organizer-only).
   • Session name — e.g. "Open Play".
   • Number of courts.
   • Duration — e.g. 2 hours, or "Open-ended".
   • Optional: Session fee, Matchmaking mode, Expected players, scheduled Start/End time, Popcorn King mode, etc.
3. Tap Create Session at the bottom.

You're taken to the session with tabs: Queue, Courts, History, and Leaderboard.

4. Adding players to the queue (during a session)

1. Go to the Queue tab.
2. Tap Add Players (green FAB) or the + in the header.
3. In Add to Queue, search or scroll, select one or more players (checkboxes).
4. Tap Add (or Add & Pay if a session fee is set). They appear in the queue in order.

• Pass — Move a player to the back of the queue (⋮ menu on their card).
• Take a Rest — Remove them from the queue; they stay checked in and can rejoin later (tap them in the "Resting" section).
• Lock Partner — From the card menu, lock two players so they always play together.

5. Starting a match

1. Queue tab: You need at least 4 players in the queue and at least one court free.
2. When that's true, a green Start Match (or "Ready to start match!") button appears.
3. Tap Start Match.
4. A Match Preview shows the suggested teams (Team 1 vs Team 2). You can tap a player slot to swap or replace with someone else (queue or resting), then confirm the lineup.
5. Tap Start Match (or Save if you're only editing a preview). The match is created and appears on the Courts tab.

You can start more matches the same way as courts free up and the queue has 4+ players.

6. Courts — viewing and ending matches

1. Open the Courts tab to see all courts and active matches.
2. Each card shows Court #, Team 1 vs Team 2, and elapsed time.
3. To finish a match: Tap End Match on that court's card, enter scores for Team 1 and Team 2 (e.g. 11–9). Ties are not allowed (unless in Popcorn King mode with non–11–11 ties). Tap Save or Complete. The match is recorded and players return to the queue/resting; the court is free again.

• Cancel Match — Removes the match and puts all four players back in the queue (use for wrong lineup or no-show).
• Emergency Edit — Replace one player on that court with another checked-in player (e.g. injury).

7. Ending the session

1. In the session, tap the ⋮ (three dots) in the top bar.
2. Tap End Session.
3. If there are active matches or expected players not checked in, the app will warn you. You can still end or go back to finish up.
4. After confirming, the Session Summary appears (champion, raffle if enabled, stats). Dismiss it to return to Home.

8. Other screens

• Players — List of all players; tap one for profile, stats, edit, or delete.
• Leaderboard (Stats) — Session or monthly leaderboard, ELO, wins/losses.
• History — Match history; tap a match to view or edit scores.
• Settings — App settings, trial/unlock, etc.

Quick reference