🏓

PickleQ User Guide

The complete guide for staff and players

Version 1.0

What is PickleQ?

PickleQ is a free, easy-to-use web app that helps you manage pickleball open play sessions. Whether you're running a busy recreation center or organizing a casual weekend game, PickleQ handles all the logistics so everyone can focus on playing.

How It Works

  1. Players check in when they arrive at the court
  2. PickleQ assigns courts automatically based on skill level
  3. Staff records winners after each game
  4. Players rotate fairly - play a game, then back to the queue
  5. Everyone sees stats at the end of the session
No app download required! PickleQ works in any web browser on phones, tablets, or computers. Just go to pickleq.app and you're ready to play.

Key Features

📋

Import from Reclub

Paste player lists directly! NEW

📺

Live Session View

Players watch queue in real-time NEW

⚖️

Fair Rotation

First in, first out queue system

Skill Matching

Balanced teams for better games

📊

Stats Tracking

Wins, losses, and rankings

🔗

Lock Partners

Keep couples together

🔊

Voice Announce

Calls out matches audibly

📱

Share Stats

Beautiful cards for social media

📶

Works Offline

No internet? No problem

🏆

Leaderboards

Track all-time rankings

Who Uses PickleQ?

User Type What They Do
Staff / Coordinators Set up sessions, add players, manage courts, record winners, and share stats
Players Check in, play games, view stats, and share achievements
Venue Managers Set up cloud sync, configure venue settings, access all-time leaderboards

First-Time Setup (Staff)

Getting started takes less than a minute. No account required!

1

Open PickleQ

Go to pickleq.app on your tablet, phone, or computer. For best results, use a tablet at the front desk where players can see it.

2

Tap "Get Started"

On the landing page, tap the green "Get Started" button. You'll go straight to the setup screen.

3

Enter Your Location

Type where you're playing (e.g., "Courts A-D" or "Recreation Center"). This will be saved for next time!

4

Set Number of Courts

Use the + and - buttons to set how many courts you have available (1-10).

5

Choose Game Mode

Select Doubles (4 players per court, default) or Singles (2 players per court).

Pro Tip: Your settings are saved automatically. Next time you open PickleQ, your location and court count will be pre-filled!

Running a Session

Adding Players

1

Type the Player's Name

In the "Add player" box, type the player's name. If they've played before, their name will auto-complete.

2

Set Their Skill Level (Optional)

Tap the stars to set their skill level. This helps create balanced teams. See the Skill Levels section for details.

3

Tap "Add"

The player appears in the "Not Here Yet" section. They're saved to your roster for future sessions.

Checking Players In

When a player arrives at the court:

1

Find Their Name

Look for the player in the "Not Here Yet" section, or use the search box.

2

Tap "Check In"

The player moves to the "Checked In" section and joins the queue. The earlier they check in, the sooner they'll play!

Starting the Session

1

Wait for Enough Players

You need at least 4 checked-in players for doubles (or 2 for singles).

2

Tap "Start Session"

The green "Start Session" button becomes active when you have enough players. Tap it!

3

Courts Fill Automatically

PickleQ automatically assigns balanced teams to all available courts. Remaining players go to the queue.

Note: You can still add and check in players after the session starts. Late arrivals will join the back of the queue.

During Play

Understanding the Play Screen

The play screen shows three main areas:

Recording Winners

When a game ends on any court:

1

Find the Court

Locate the court card showing the completed match.

2

Tap the Winning Team

Tap the Team 1 (left/top) or Team 2 (right/bottom) button for the winners.

3

Players Rotate

All 4 players return to the back of the queue. Stats are updated. New players get assigned to the court.

Made a mistake? An "Undo" popup appears for 10 seconds after recording a winner. Tap it to reverse the result!

Managing the Queue

The queue shows who's playing next:

Handling Special Situations

Player Needs a Break

Tap the player's name and select "Check Out." They'll be removed from the queue but can check back in later.

Player Leaves Mid-Game

Tap the player on the court and select "Pull from Court." PickleQ will find a substitute from the queue.

Late Arrival

Just add and check in the new player. They'll join the back of the queue.

Ending a Session

1

Tap "End Session"

When you're done for the day, tap the "End Session" button in the header.

2

View the Leaderboard

The session leaderboard appears, showing all players ranked by wins. Top 3 get medals!

  • 🥇 Gold - Most wins
  • 🥈 Silver - Second place
  • 🥉 Bronze - Third place
3

Share Stats (Optional)

Tap any player's name to generate a shareable stats card. Players can download it or share to social media!

4

Start a New Session

Tap "New Session" to begin another session. All players and settings are preserved.

Import from Reclub NEW

If you organize events through Reclub, you can now import your participant list directly into PickleQ with a simple copy-paste!

How to Import

1

Copy from Reclub

Open your Reclub event and select/copy the participant list. It looks something like:

Participants (26)
1. Player One
2. Player Two
3. Player Three
...
2

Open Import in PickleQ

On the Setup screen, tap "Import from Reclub" next to "Add Players". Or go to the Players screen and tap the "Import" button.

3

Paste and Parse

Paste the copied text into the text area and tap "Parse Players". PickleQ will extract all the player names automatically.

4

Review and Import

You'll see a list of all players found. Uncheck anyone you don't want to import. Players already in your session or database will be marked as "already added".

5

Tap Import

Tap the green "Import X Players" button. Done! All selected players are added instantly.

Pro Tip: If your Reclub list has both "Organizers" and "Participants" sections, PickleQ will show them separately so you can choose which ones to import.

Where to Import

Location What Happens
Setup Screen Players are added to the current session (they'll appear in "Not Here Yet")
Players Screen Players are saved to your roster for future sessions

Live Session View NEW

Players can now watch the live session on their own phones! They can see the queue, current matches, and their wait time in real-time.

How It Works

1

Staff Shares the Link

During an active session, staff can share a live session link. Players scan a QR code or receive the URL directly.

2

Players Open on Their Phone

Players open the link in their phone's browser. No app download needed!

3

Watch in Real-Time

The page updates automatically. Players can see:

  • Which courts are active and who's playing
  • Their position in the queue
  • Estimated wait time
  • Game scores and win/loss records
No Crowding! Players don't need to hover around the staff tablet anymore. They can relax, warm up, or grab a drink while watching the queue on their own device.

Requirements

Skill Levels

Skill levels help PickleQ create balanced teams. When possible, it pairs a stronger player with a newer player on each team, so games are competitive and fun for everyone.

Level Stars Description
Beginner New to pickleball, still learning basic rules and strokes
Intermediate ★★ Knows the game well, consistent play, developing strategy
Advanced ★★★ Highly skilled, strong strategy, competitive player
Unrated ☆☆☆ No skill level set (treated as average)

Setting Skill Levels

Tip: If you're unsure about a player's skill, start them at ★★ (Intermediate) and adjust after watching them play a few games.

Locking Partners

The "Lock Partners" feature keeps two players on the same team for every game. Perfect for couples, parent-child pairs, or friends who want to stick together.

How to Lock Partners

1

Make Sure Both Players Are Checked In

Both players must be in the "Checked In" section before you can lock them.

2

Tap the Lock Icon (🔗)

Find the first player and tap the chain/lock icon next to their name.

3

Select Their Partner

Tap the second player's name. Both players will now show a lock indicator.

How to Unlock Partners

Tap the lock icon on either locked player, then tap "Unlock" to separate them.

Note: Locked partners always play together and rotate together. They'll be matched against other pairs with similar combined skill levels.

Voice Announcements

PickleQ can announce matches out loud using text-to-speech. This is great for busy courts where players might not be watching the screen.

What Gets Announced

Mute/Unmute

Tap the speaker icon (🔊) in the header to toggle announcements on or off. Your preference is saved for future sessions.

Tip: Connect your device to a Bluetooth speaker for announcements that everyone can hear across the courts!

Singles Mode

Running 1-on-1 games instead of doubles? PickleQ supports that too!

Setting Up Singles

1

During Setup

On the setup screen, tap "Singles" instead of "Doubles".

2

Minimum Players

You need at least 2 players to start a singles session.

3

Court Assignment

Each court gets 2 players. Everything else works the same!

Note: The "Lock Partners" feature is not available in Singles mode.

Player Guide

Welcome to PickleQ! Here's what you need to know as a player.

When You Arrive

  1. Find the staff member with the PickleQ tablet or screen
  2. Give them your name so they can check you in
  3. Wait for your turn - you'll see your position in the queue on screen

The Queue System

PickleQ uses a fair queue system:

During Your Game

Taking a Break

Need to rest or grab water? Ask staff to "check you out." You'll be removed from the queue temporarily. Just check back in when you're ready to play again!

Viewing Your Stats

PickleQ tracks your performance across sessions. Here's what's tracked:

Stat What It Means
Games Played Total number of games you've participated in
Wins Number of games your team won
Losses Number of games your team lost
Win Rate Percentage of games won (wins divided by total games)
Ranking Your position compared to other players

Session Stats vs. Lifetime Stats

Sharing Your Stats

Show off your achievements with beautiful stats cards!

How to Get Your Stats Card

1

Access the Leaderboard

After the session ends, you'll see the leaderboard. Or visit the venue's public leaderboard link.

2

Tap Your Name

Find yourself on the leaderboard and tap your name.

3

View Your Stats Card

A beautiful card appears showing your name, skill level, record, and ranking.

4

Share or Download

  • Share: Tap the share button to post directly to social media, messages, or email
  • Download: Tap download to save the card as an image to your device
Tip: Stats cards look great on Instagram, Facebook, and WhatsApp! Share your wins with your pickleball friends.

Leaderboards

Session Leaderboard

Shows rankings for the current session only. Displayed automatically when a session ends.

All-Time Leaderboard

Shows lifetime rankings across all sessions (requires venue cloud sync).

Ranking Requirements

To appear on the ranked leaderboard, players typically need a minimum number of games (default: 10). This prevents players with just 1 win from topping the charts!

Cloud & Venue Setup

Setting up a venue enables cloud sync, public leaderboards, and multi-device access. This is optional but recommended for recreation centers and clubs.

Creating a Venue

1

Open Venue Settings

Tap the gear icon (⚙️) in the header, then "Set Up Venue".

2

Enter Venue Name

Type your venue name (e.g., "Green Valley Recreation Center"). A URL will be auto-generated.

3

Set a Password

Choose a password (minimum 4 characters). Staff will use this to access your venue on other devices.

4

Create the Venue

Tap "Create Venue". All your existing players and stats will sync to the cloud.

Joining an Existing Venue

If your venue is already set up:

  1. Tap the gear icon, then "Join Venue"
  2. Enter the venue URL slug (provided by your administrator)
  3. Enter the venue password
  4. Tap "Join" - all data syncs automatically

Venue Settings

Public Leaderboard: Once set up, your venue gets a public URL (e.g., pickleq.app/v/your-venue) where anyone can view leaderboards without logging in!

Offline Mode

PickleQ works completely offline! This is great for outdoor courts with spotty wifi.

How Offline Mode Works

Syncing After Being Offline

If you run a session offline with a venue configured:

  1. Sessions are queued for sync
  2. When internet returns, PickleQ automatically syncs
  3. You'll see a sync indicator in the header
Important: If you use multiple devices offline simultaneously, data may conflict. For best results, use one device at a time when offline.

Troubleshooting

Common Issues

The app isn't loading

Try refreshing the page. If that doesn't work, clear your browser cache or try a different browser. PickleQ works best on Chrome, Safari, and Firefox.

I accidentally recorded the wrong winner

Look for the "Undo" popup that appears for 10 seconds after recording. Tap it to reverse the result. If the popup is gone, you'll need to manually adjust (the stats will be slightly off).

A player is stuck on a court

Tap the player's name on the court card and select "Pull from Court". They'll return to the queue.

Voice announcements aren't working

Check that:

  • The mute button (🔊) is not muted
  • Your device volume is up
  • Your browser has permission to play audio

Stats aren't syncing to cloud

Make sure:

  • You have a venue set up (tap gear icon)
  • You have an internet connection
  • The sync indicator isn't showing an error

I can't start the session

The "Start Session" button requires at least 4 checked-in players (for doubles) or 2 (for singles). Make sure enough players are in the "Checked In" section.

My data disappeared

Data is stored in your browser's local storage. If you cleared browser data, switched browsers, or used incognito mode, local data won't be there. Cloud-synced data (venues) is preserved - just rejoin your venue.

Frequently Asked Questions

Is PickleQ free?

Yes! PickleQ is completely free to use. No subscriptions, no hidden fees.

Do I need to create an account?

No account is needed for basic use. Creating a venue (optional) enables cloud sync and public leaderboards.

Does PickleQ work on my device?

PickleQ works on any device with a modern web browser - phones, tablets, laptops, and desktops. No app download required.

How does the queue system ensure fairness?

It's first-in-first-out (FIFO). Players who check in earlier play sooner. After each game, all players go to the back of the queue.

How are teams balanced?

PickleQ pairs players of different skill levels together. A ★★★ player partners with a ★ player, facing another similar pairing. This creates competitive games for everyone.

Can players see their own stats?

Yes! After a session ends, players can view and share their stats. With a venue set up, they can also access the public leaderboard anytime.

What happens if someone leaves mid-game?

PickleQ automatically finds a substitute from the queue. If no substitute is available, the match is paused until someone is available.

Can I run multiple sessions at different locations?

Yes! Each browser/device maintains its own session. You can run simultaneous sessions at different courts.

How do I delete a player from my roster?

Go to the Players screen (tap the players icon), find the player, and tap "Delete". This removes them from your saved roster but preserves their historical stats.

Can I change a player's skill level mid-session?

Yes! Tap the player's name and select "Edit" to change their skill level. The change takes effect for their next game.

What's the maximum number of courts?

PickleQ supports up to 10 courts per session.

How are ties broken on the leaderboard?

First by win percentage, then by total games played, then alphabetically by name.

Ready to Play?

Open PickleQ and start your first session!

Open PickleQ

Back to Home