PB Match User Manual

Preview guide for version 1.0.0

Mobile store releases are coming soon. This guide describes the current preview; notification delivery and some account and waitlist flows are still being validated.

At a Glance

PB Match is a mobile app for coordinating pickup pickleball games. Connect with other players, create matches, send invitations, and get everyone on the court.

Core Features:

  • Connect with players via QR code, link, or invite code
  • Create matches with time, location, and player limits
  • Organize connections into tags for quick group invitations
  • Get push notifications for invites and updates

Table of Contents

  1. Getting Started
  2. Home Screen
  3. Managing Connections
  4. Creating a Match
  5. Responding to Invitations
  6. Match Details
  7. Profile & Settings
  8. Push Notifications

Getting Started

Creating an Account

  1. Open PB Match and tap Sign Up on the login screen
  2. Enter your Full Name, Email, and choose a Password (minimum 6 characters)
  3. Confirm your password and tap Create Account
  4. If prompted to verify your email, follow the verification link
  5. Return to the app and sign in

Signing In

  1. Enter your email and password
  2. Tap Sign In
  3. You’ll be taken to the Home screen

Home Screen

The Home screen is your dashboard for pickleball activity. It shows:

Welcome Section

A personalized greeting and a summary of your next match, when one is scheduled.

Create Match

Tap Create Match to organize a game.

Invitations

Match invitations from other players appear here. Each invitation card shows:

  • Location - Where the match will be played
  • Time - When the match is scheduled (shows “Today” or “Tomorrow” for upcoming dates)
  • Host - Who created the match
  • Spots left - How many players are still needed
  • Notes - Any additional info from the host

For each invitation, you can:

  • Tap the card to view full match details
  • Tap Accept to join the match
  • Tap Decline to pass

Upcoming Matches

All matches you’re participating in (either as host or accepted player). Cards show:

  • Location and time
  • Spots remaining or “Full” status
  • “You’re hosting” badge if you created the match
  • Tap any card to view details

Past Matches

Earlier matches appear in the Past Matches section.

Pull down to refresh the screen and see the latest updates.

Managing Connections

Before you can invite players to matches, you need to connect with them. Go to the Players tab to manage your connections.

Ways to Connect

Tap + Add Connection to expand the connection panel. There are several ways to connect with another player:

QR Code (Easiest)

The fastest way to connect in person:

  1. Show your Connect QR code to the other player
  2. They scan it with their phone camera
  3. The connection link fills in your code; they sign in if needed and tap Connect

Send your invite link via text, email, or any messaging app:

  1. Tap Share Invite below the QR code
  2. Choose how to share (Messages, Email, etc.)
  3. When they tap the link, the PB Match connection page fills in your code
  4. They sign in if needed and tap Connect

Tell Them Your Code

If they already have the app open:

  1. Read them your 6-character code (shown above the QR)
  2. They type it into the “Enter a Code” box on their Players screen
  3. Tap Connect

Enter Their Code

If they share their code with you:

  1. Type their 6-character code in the “Enter a Code” box
  2. Tap Connect
  3. The request normally waits for the other player to accept

Showing your connection QR enables a brief pairing window that can accept one connection automatically. Outside that window, check Connection Requests or Pending Sent for the response.

Your Invite Code & QR

Your personal invite code is displayed when you tap + Add Connection. Key features:

  • Personal code - Reuse your six-character code while your account exists
  • Connect QR (default) - Opens the PB Match connection link and fills in your code
  • App QR - Tap “Show App QR” to display a QR linking to the PB Match website

Connection Requests

Requests You’ve Received

When someone sends you a connection request, you’ll see it in the Connection Requests section. You can:

  • Tap Accept to add them as a connection
  • Tap Decline to reject the request

Pending Sent

Requests you’ve sent that are awaiting response appear in Pending Sent.

Tags

Tags help you organize connections into groups for easier invitations.

Creating Tags

  1. Scroll to My Tags section
  2. Tap Create New Tag
  3. Enter a name (e.g., “Tuesday Regulars”, “Advanced Players”)
  4. Optionally add a description
  5. Select connections to add to the tag
  6. Tap Create

Using Tags

When creating a match, you can invite an entire tag at once instead of selecting players individually.

Managing Tags

  • Tap any tag to view its members
  • Add or remove players from tags
  • Tap a player to view their profile and manage their tag memberships

My Connections

Your accepted connections appear in the My Connections list. Each connection shows:

  • Player’s avatar (or initials)
  • Player’s full name

Managing Connections:

  • Tap a connection to view their profile
  • Long press on a connection to remove them
  • Tap Edit to enter bulk selection mode:
    • Select multiple connections with checkboxes
    • Tap Remove to remove all selected connections

Removing a connection also removes them from all your tags.

Creating a Match

Tap Create Match from the Home screen to set up a new game.

Match Details

Location

Enter where you’ll be playing (e.g., “Central Park Courts”, “YMCA Gym 2”).

When

  • Tap the date button to choose the day
  • Tap the time button to set the start time
  • Default is 1 hour from now, rounded up to a 15-minute interval

Spots

Use the + and - buttons to set the total number of players, including yourself when I’m Playing is on. Four spots means you plus three other players if you are playing, or four other players if you are only organizing.

I’m Playing

Toggle this on if you’ll be participating in the match. Toggle off if you’re just organizing for others.

Notes (optional)

Add any helpful info like:

  • What to bring
  • Court number or location details

Invite Players

  1. Tap Add Players
  2. Select individual connections or use tags to select groups
  3. Use Clear to reset the selection if needed
  4. Tap Add N Players to add the selection
  5. On the match form, choose Pending or Confirmed for each player

You must select at least one player to create a match.

Creating the Match

Tap Create in the top right. The app will:

  1. Create the match
  2. Send invitations to all selected players
  3. Attempt invitation notifications in supported native builds, according to preferences
  4. Return you to the Home screen

Responding to Invitations

Invitations appear on your Home screen. You may also receive a push notification in a supported native build when notifications are enabled.

Accepting an Invitation

  1. Find the invitation in Invitations
  2. Tap Accept
  3. If a spot is available, the match appears in Upcoming Matches

Joining a Waitlist

If the match is full, use Join Waitlist when it is offered. Your invitation shows your waiting position; use Leave Waitlist if you no longer want to wait.

After a promotion, use Confirm or Confirm Spot before the displayed deadline to accept the offered spot. Pass declines that offer. Check your current status in the match details during the preview.

Declining an Invitation

  1. Find the invitation in Invitations
  2. Tap Decline
  3. Your response is updated for the host

Viewing Details Before Deciding

Tap anywhere on the invitation card (except the buttons) to see:

  • Full match information
  • Who’s already confirmed
  • Any notes from the host

Match Details

Tap any match card to view its full details.

Match Information

  • Location - Where to play
  • Status badge - Shows spots remaining, “Full”, or “Cancelled”
  • Date and time - Formatted with day and time
  • Host - Who created the match (shows “You” if you’re the host)
  • Playing status - Whether the host is participating
  • Notes - Any additional information

Mute Notifications

If you’re a participant, you can mute notifications for a specific match to stop receiving updates about it.

Confirmed Players

A list of everyone who has accepted and will be playing. Each player shows:

  • Their avatar
  • Their name
  • “Host” badge if they created the match
  • “(You)” indicator if it’s your entry
  • Connection status icon if you’re not connected

Invitation Status

Before the match starts, the invitation list is labeled Invitations for the host and Other Invited Players for other viewers. Statuses include:

  • Pending - Waiting for response (yellow)
  • Accepted - Player confirmed (green)
  • Waitlist #N - Waiting for an available spot
  • Confirming - An offered spot is awaiting confirmation
  • Expired - The confirmation deadline has passed
  • Declined - Player passed (red)

Comments

View and add comments to discuss the match. Comments are visible to all participants.

Editing a Match (Host Only)

If you’re the host and the match hasn’t started:

  • Tap Edit to modify match details
  • Add or remove participants
  • Invite additional players

Withdrawing from a Match

If you are a confirmed player other than the host, use Withdraw from Match when shown before the match starts, then confirm the action.

Cancelling a Match (Host Only)

If you need to cancel:

  1. Scroll to the bottom and tap Cancel Match
  2. Confirm the cancellation
  3. The match is marked Cancelled in the app

Tell players directly about cancellations during the preview while notification delivery is being validated.

Pull down to refresh and see the latest player responses.

Profile & Settings

Tap the Profile tab to manage your account.

Your Profile

Shows your:

  • Avatar (or initials)
  • Full name
  • Email address

Settings

  • Edit Profile - Change your name and avatar
  • Notifications - Manage notification preferences

Help & Support

  • Help Center - Opens this user manual
  • Send Feedback - Submit feedback or report issues

Sign Out

Tap Sign Out to log out of your account. On mobile, you’ll be asked to confirm.

Delete Account

If you need to delete your account:

  1. Tap Delete Account in the Danger Zone
  2. Confirm twice (this is permanent)
  3. Wait for the deletion result; account deletion is permanent

Push Notifications

PB Match sends push notifications to keep you informed.

Notification Examples

  • New match invitations from connections
  • Connection requests
  • Comments on matches you can access
  • Waitlist promotions

Availability depends on the build, permissions, and notification preferences. During the preview, check the app for current match status instead of relying on a notification for every change.

Enabling Notifications

  1. When you first sign in, the app will request notification permission
  2. Tap Allow to receive notifications
  3. If you denied initially, enable in your device’s Settings app

Notification Requirements

  • Push notifications require a physical device (not simulators)
  • An installed native build is required; Expo Go and the web app do not support push notifications

Tapping Notifications

Tapping a match notification opens the related match. Check the Players tab for connection requests.

Tips for Success

  1. Build your network first - Add connections before creating matches so you have players to invite

  2. Use QR codes - The fastest way to connect when meeting players in person

  3. Create tags - Organize your regulars into groups for quick invitations

  4. Be descriptive - Include court details and what to bring in your notes

  5. Respond promptly - Accept or decline invitations quickly so hosts can plan

  6. Refresh often - Pull down on Home or match details to get the latest updates

  7. Enable notifications - Stay informed about new invitations and match updates

Troubleshooting

I can’t see my connection’s invitation

  • Check your internet connection
  • Pull down to refresh the Home screen
  • Ensure you’re signed in with the correct account

My code isn’t working

  • Make sure the code is entered exactly (6 characters, letters and numbers)
  • Codes are case-insensitive
  • Try having the other person scan your QR code instead

The QR code won’t scan

  • Ensure good lighting
  • Hold the phone steady
  • Try increasing screen brightness
  • Use the Share Link option as an alternative

I’m not receiving notifications

  • Check your device settings to ensure PB Match has notification permission
  • Push notifications don’t work in Expo Go or the web app - use an installed native build
  • Notifications only work on physical devices

Match shows wrong player count

  • Pull down to refresh the screen
  • The host may have updated the match settings

Support

For help:

  • Visit the Help Center
  • Use Send Feedback in the Profile tab to report issues

PB Match preview - Find your next game