Help Guide

🚀 Getting Started

Quick Start

Get scoring in 5 easy steps:

1. Open Toss Tally and you'll land on the Setup tab
2. Enter team names by tapping the text fields
3. Tap "Start New Match" at the bottom of the screen
4. Select a scoring mode (Tap to Score for quick games, Bag Scoring for detailed tracking)
5. Start scoring — swipe to the Scorekeeping tab and record each round

App Overview

Toss Tally has three main tabs you can swipe between:

Screen Navigation

• Swipe left or right to move between tabs
• The current tab is indicated by the position of the view
• During your first use, on-screen hints will guide you through swiping

⚙️ Setting Up a Match

Before starting a game, configure your match settings on the Setup tab.

Team Names and Colors

To change a team name:

• Tap the team name text field
• Type the new name
• Tap elsewhere or press return to save

To change a team color:

• Tap the colored circle next to the team name
• Select a new color from the picker
• The color appears on score cards and broadcasts

To swap team positions:

• Tap the Swap button between the two teams
• This switches which team appears on the left vs. right

Match Format

Choose how many games make up your match:

Best 2 of 3 is standard for most casual and competitive play. Use Best 1 of 1 for quick games or Best 3 of 5 for tournament finals.

Adding Players

For doubles play, you can add up to 2 players per team:

1. Tap the player section for a team
2. Select an existing player from your directory, or tap "Add New Player"
3. Enter the player's name
4. Repeat for additional players

Managing your player directory:

• Swipe left on a player name to delete them
• Tap a player name to edit it
• Players are saved across all future matches

Scoring Mode Selection

When you tap Start New Match, you'll choose a scoring mode:

• Tap to Score — Quick and simple, best for casual games
• Bag Scoring — Detailed tracking with statistics

🎯 Scoring Modes

Toss Tally offers two main scoring approaches, each suited to different play styles.

📝 Keeping Score

Using Tap to Score

1. After starting a match, swipe to the Scorekeeping tab
2. The view rotates to landscape automatically
3. Tap the top half of a team's panel to add 1 point
4. Tap the bottom half to subtract 1 point (for corrections)
5. Continue until a team reaches 21 points

The score displays update with a subtle animation when changed.

Using Bag Scoring

1. After starting a match, swipe to the Scorekeeping tab
2. You'll see both teams' scoring panels
3. For each team, record bags using the In/On/Off buttons:
   • Each button shows a count and point total
   • Tap to increment the count
   • The button updates to show bags recorded
4. Each team can record up to 4 bags per round

Submitting Rounds

After both teams have recorded their bags:

1. The Submit Round button becomes active
2. Tap it to calculate and apply the round's scores
3. Cancellation scoring is applied automatically
4. The round counter advances
5. Bag counts reset for the next round

Undoing Mistakes

Made an error? You can fix it:

Before submitting:

• Tap a bag type button again to adjust the count
• Counts cycle through valid values

After submitting:

• Tap Revert Last Round to undo the submission
• The previous round's data is restored
• Make your corrections and resubmit

Game Over and Match Winner

When a team reaches 21 points:

1. The game ends immediately
2. A winner announcement appears
3. Confetti celebrates the victory
4. The game win is recorded for the match

In multi-game matches:

• The win counter updates (shown as circles)
• Tap to start the next game
• When a team wins enough games, the match ends

📋 Cornhole Scoring Rules

Points System

Each bag earns points based on where it lands:

Cancellation Scoring

Toss Tally uses cancellation scoring (also called "netting"), which is standard in competitive cornhole:

How it works:

1. Both teams throw their 4 bags in a round
2. Calculate each team's raw points (0-12 possible)
3. Subtract the lower score from the higher score
4. Only the team with more points scores — they get the difference

This keeps games competitive and prevents runaway scores.

Race to 21

• The first team to reach 21 points wins the game
• There is no "bust" rule — you cannot go over and lose points
• If both teams would reach 21 in the same round, the team with more points wins
• Most games last 15-25 rounds

📡 Multiplayer Features

Share your game with spectators or collaborate with others to keep score using Bluetooth.

Broadcasting for Spectators

What it does: Shares your live scoreboard publicly so anyone nearby can watch.

To start broadcasting:

1. On the Setup tab, find the "Broadcast" section
2. Toggle on Broadcast for Spectators
3. A status shows "Broadcasting" with viewer count

What spectators see:

• Live score updates
• Team names and colors
• Current round and game information
• They cannot modify scores — view only

Range: Approximately 30-50 feet, depending on environment.

Hosting for Collaborators

What it does: Allows another person to help keep score from their own device.

To start hosting:

1. On the Setup tab, find the "Host" section
2. Toggle on Host for Collaborators
3. A QR code appears on your screen
4. Have your collaborator scan this code

Security:

• The QR code contains a secure authentication key
• Only people who scan the code can modify scores
• Commands are cryptographically signed to prevent tampering

Dual Mode

Combine broadcasting and hosting:

• Public spectators can watch (read-only)
• Authenticated collaborators can help score
• Ideal for tournaments or events with both audiences

Watching Nearby Matches

To find matches to watch:

1. Go to the Feed tab
2. The "Watch Nearby" section shows available matches
3. Swipe through the carousel to browse matches
4. Tap a match card to view the live scoreboard

What you'll see:

• Team names and current scores
• Signal strength indicator (colored bars)
• "Stale" indicator if connection is lost

To disconnect: Tap the back button to return to the match list.

Joining as a Collaborator

To join someone's match as a collaborator:

1. On the Setup tab, select Join mode
2. Tap Scan QR Code
3. Point your camera at the host's QR code
4. Once connected, you can record scores

Your score changes:

• Sync instantly with the host device
• The host sees your updates in real-time
• Both devices show the same scores

📊 Statistics

When using Bag Scoring mode, Toss Tally tracks detailed performance statistics.

Understanding Your Stats

Player Performance Tracking

Statistics are tracked at multiple levels:

Current Game:

• Stats for this game only
• Resets when a new game starts

Current Match:

• Aggregated across all games in this match
• Updates as each game completes

Player History:

• Average stats across your last 10 matches
• Persists across app sessions
• Updated automatically when matches finish

Viewing Statistics

During a match:

• Swipe to the Feed tab
• The "Current Match Stats" card shows team performance
• Tap a player's name to see individual stats

🏆 Match History

Automatic Saving

Toss Tally automatically saves your match progress:

• Scores are saved after each round
• Team names and settings are preserved
• Player assignments are remembered
• Broadcasting/hosting state is maintained

Resuming Matches

If the app closes or your device sleeps:

1. Reopen Toss Tally
2. Your active match loads automatically
3. All scores and rounds are restored
4. Continue playing from where you left off

Current Match Stats

On the Feed tab, view real-time statistics for your active match:

• Team performance comparison
• Individual player statistics
• Round-by-round breakdown

💡 Tips & Troubleshooting

Best Practices

For accurate statistics:

• Enter player names before starting (consistent names track history)
• Use Bag Scoring mode for detailed tracking
• Submit rounds promptly to avoid forgetting throws

For smooth gameplay:

• Charge your device before long sessions
• Keep Bluetooth enabled for multiplayer features
• Use Tap to Score for quick casual games

For multiplayer:

• Stay within 30-50 feet of connected devices
• Avoid physical obstructions between devices
• Keep the app in the foreground while broadcasting

Bluetooth Troubleshooting

Common Questions

📚 Glossary