PB Match User Manual

Version 1.0.0

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. Check your email for a verification link
  5. After verifying, 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 with your name.

Create a Match Button

The prominent green button at the top lets you quickly create a new match.

Pending 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

My 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

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 link opens PB Match and automatically sends the connection request

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, it opens PB Match with your code pre-filled

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. You’re connected immediately

Your Invite Code & QR

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

  • Codes never expire - Your code stays the same and works forever
  • Connect QR (default) - When scanned, opens the app and auto-fills your code
  • App QR - Tap “Show App QR” to switch to a QR that links to the app download page (useful for friends who don’t have PB Match yet)

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

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 a 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 to the nearest 15 minutes

Spots Needed

Use the + and - buttons to set how many other players you need. The app calculates total players automatically:

  • If you’re playing: “You + 3 others = 4 total”
  • If you’re not playing: “3 players (you’re not playing)”

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

Select which connections to invite:

  • Tap a tag to select all members of that tag
  • Tap individual players to select/deselect them
  • Use All to select everyone
  • Use None to clear selections
  • Toggle between pending (yellow) and confirmed (green) status for each invite

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. Send push notifications (if enabled)
  4. Return you to the Home screen

Responding to Invitations

When someone invites you to a match, you’ll receive a push notification (if enabled). The invitation also appears on your Home screen.

Accepting an Invitation

  1. Find the invitation in Pending Invitations
  2. Tap Accept
  3. You’re confirmed! The match appears in My Upcoming Matches

Declining an Invitation

  1. Find the invitation in Pending Invitations
  2. Tap Decline
  3. The invitation is removed and the host is notified

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

Invitations (Host Only)

If you created the match, you’ll see the status of all invitations:

  • Pending - Waiting for response (yellow)
  • Accepted - Player confirmed (green)
  • 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

Cancelling a Match (Host Only)

If you need to cancel:

  1. Scroll to the bottom and tap Cancel Match
  2. Confirm the cancellation
  3. All invitees will be notified

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. All your data will be removed

Push Notifications

PB Match sends push notifications to keep you informed.

What You’ll Be Notified About

  • New match invitations from connections
  • Updates to matches you’ve joined
  • When you’re moved off a waitlist

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)
  • Development builds are required (Expo Go doesn’t support push)

Tapping Notifications

When you tap a notification, the app opens to show you the relevant match or invitation.

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 any screen 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 - use a development 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 v1.0.0 - Find your next game