User Guide

1. Home Screen

The Home Screen is the first thing you see when you open the app.

Tabs

The app has three tabs at the bottom:

• Games — your active game, recent history, and the New Game button (described in this section)
• Events — create and track multi-game events with aggregated standings (see Events)
• Profiles — create and manage player profiles that track lifetime stats (see Profiles)

Active Event Banner

If an event is currently running, a banner appears at the very top of the Games tab showing the event name and how many games have been played in it. Tap the banner to jump to the event's standings.

Active Game Banner

If a game is currently in progress, a banner appears below the event banner (if any) showing the game name, number of players, and the date it was started. Tap it to resume the game.

New Game Button

Tap + New Game to start a new game.

• If a game is already in progress, you will be asked to confirm before ending it. Choosing End & Start New Game archives the current game to history and opens the new game setup sheet.

Recent Games

All completed games are listed below the New Game button, most recent first. Each row shows:

• Game name (or "Unnamed Game" if none was set)
• Date and player count (team games also show team count)
• Winner name and score, or "Tie (+N)" if multiple players or teams share the top score

Team games are marked with a person.2 icon badge next to the game name.

Swipe left on any history row to reveal a red Delete button and remove that game from history.

At the bottom of the history list, a Clear History button removes all completed games at once (requires confirmation).

2. Starting a New Game

Tap + New Game to open the New Game sheet.

Game Info

Field	Description
Game Name	Optional. Names the game (e.g. "Friday Night Rummy"). Appears in the history list and on the active game screen.
Date	Defaults to today. Tap to change if you are entering a game that was played on a different day.
Low Score Wins	Toggle ON for games where the lowest score at the end wins — Mexican Train, SkyJo, Rummikub, Golf, etc. Affects sort order and winner detection everywhere in the app. Defaults OFF.
Team Game	Toggle ON for games where players compete as teams — Spades, Euchre, Pictionary, etc. See Team Games. Defaults OFF.

Building Your Roster (Individual Game)

When Team Game is OFF, the Players section uses a roster-first design. There are two ways to add players:

From Profiles — Any profiles you have created appear as tappable rows. Tap a profile to add that player to the roster. Profile rows show the player's all-time record (e.g. "12 games · 58% win"). Profile-linked players show a person badge in the roster.

Add Guest Player — Tap + Add Guest Player to add an anonymous player with a default name. Guest players are not linked to any profile and do not contribute to lifetime stats.

You can have any mix of profile-linked and guest players in the same game (up to 16 total).

Editing names: Any player's name in the roster can be edited inline — tap the name field and type. Changing a name here only affects this game; it does not rename the profile.

Pre-fill from last game: When the sheet opens, the roster is pre-filled from your most recent game, including any profile links. Remove or change players as needed.

Removing a player from the roster: Tap the red − button to the right of any roster row to remove that player before the game starts.

Building Your Roster (Team Game)

When Team Game is ON, the roster is replaced by team sections. Two default teams ("Team 1" and "Team 2") are created automatically — adjust the names and players as needed.

Team names — Tap any team name at the top of its section to rename it.

Add from Profiles — A single "Add from Profiles" section appears below all teams. Each profile row shows a + button with a menu — tap it and choose which team to add that player to. A profile disappears from this list once added to any team, so the same profile can't appear on two teams.

Add Guest — Tap + Add Guest to [Team Name] inside any team section to add an anonymous player to that team.

Remove a player from a team — Tap the red − button on any player row within a team section.

Add a team — Tap + Add Team at the bottom of the sheet to add another team.

Delete a team — Tap the trash icon in a team's header. The last remaining team cannot be deleted.

The roster always starts fresh when Team Game is toggled on — no pre-fill from the last game.

Tap Start Game in the top-right corner to begin. The button is enabled once at least one team has at least one player. Tap Cancel to close without starting.

3. Active Game Screen

The Active Game Screen shows the live scoreboard for the game in progress.

Individual Game Layout

• Top section: Editable game name field. Tap to rename the game at any time; the new name is saved when you tap Return or move focus elsewhere.
• Players section: A table with three columns: Player (editable name), Score (current total, color-coded: green for positive, red for negative, gray for zero), and Change (field for entering the next score delta).

Team Game Layout

In a team game, the scoreboard shows team rows instead of individual player rows:

• Team — editable team name
• Score — current team score (color-coded the same way)
• Change — field for entering the next score delta for that team

Player names appear as a small subtitle beneath each team name, shown in gray.

The Manage Teams button in the toolbar opens a sheet where you can add, remove, or reassign players during the game. See Managing Players Mid-Game.

Navigation Bar

Button	Action
Home (top-left)	Returns to the Home Screen. The game remains active and can be resumed later.
Reorder (top-right)	Enters reorder mode — drag handles appear so you can rearrange players or teams. Tap Done to return to normal mode.
Manage Teams (top-right, team games only)	Opens the Manage Teams sheet to add/remove/reassign players between teams.
End Game (top-right)	Ends and archives the current game to history (requires confirmation).

4. Entering Scores

Each player or team row has a Change field on the right side.

1. Tap the Change field for the player or team whose score you want to update. The numeric keyboard appears.
2. Type the point value (just the number — no sign needed yet).
3. Use the keyboard toolbar at the bottom of the screen:
   • +/− toggle (left side) — switches the delta between adding (green) and subtracting (red). Defaults to adding.
   • ✓ checkmark (right side) — applies the delta to that player's or team's score. The field clears and focus is dismissed. The checkmark is grayed out until a non-zero value is entered.
4. You can also scroll the list to dismiss the keyboard without applying — the delta field clears automatically.

Last Delta (swipe right)

After applying a score, swipe right on that row to peek at the last delta that was applied — shown as "+10" or "−3", colored green or red. This is useful to quickly verify the last entry without scrolling through history.

5. Managing Players During a Game

Renaming a Player

Tap the player's name in the Player column. Edit the name and tap Return (or tap elsewhere) to save. Text is selected automatically when you tap the field.

Adding a Player

If the game has fewer than 16 players, a + Add Player button appears below the player list. Tap it to add a new player starting at 0 points.

Removing a Player

Swipe left on any player row to reveal a red Delete button. A minimum of 1 player is always enforced — the delete action does nothing if only one player remains.

In team games, use the Manage Teams sheet for all player management. See Team Games — Managing Players Mid-Game.

6. Reordering Players

Tap Reorder in the top-right corner of the Active Game Screen.

• Drag handles (three horizontal lines) appear on the right side of each player or team row.
• Press and drag any handle to move that player or team up or down in the list.
• Tap Done when finished. The new order is saved automatically.

Swipe actions (last delta and delete) are not available while in Reorder mode. Tap Done first to return to normal mode.

7. Team Games

Team mode lets you track games where players compete as a group — Spades, Euchre, Pictionary, Hearts, and any other team-based game.

Setting Up a Team Game

See Starting a New Game — Building Your Roster (Team Game) for full setup details.

Scoring in a Team Game

Team scoring works identically to individual scoring, but the delta is applied to the whole team:

1. Tap the Change field on any team row.
2. Enter the point value and use the +/− toggle.
3. Tap the ✓ checkmark to apply.

The team's score updates immediately and all players on that team share it.

Managing Players Mid-Game

Tap Manage Teams in the toolbar to open the Manage Teams sheet. From here you can:

Add a player from profiles — Profiles not already in the game appear as tappable rows within each team section. Tap a row to add that profile player directly to that team.

Add a guest — Tap + Add Guest to [Team Name] to add an anonymous player to a team.

Remove a player — Tap the − button on any player row. The minimum is 1 player in the game total.

Move a player to another team — Tap the ⇄ icon on a player row to reveal a menu of other teams. Choose a team to reassign the player.

Rename a team — Tap the team name in the section header to edit it.

Add a team — Tap + Add Team at the bottom of the sheet.

Delete a team — Swipe left on any team section to reveal a Delete button. Deleting a team also removes all players on that team from the game. The last remaining team cannot be deleted.

Tap Done to return to the scoring screen.

Ending a Team Game

Tap End Game as usual. If any team has no players, a warning appears asking you to confirm before ending — you can go back to add players or proceed anyway.

When the game ends, the final team scores are saved to history. Profile stats are credited per player: everyone on any team receives a games-played credit, and players on the winning team receive a win credit.

8. Ending a Game

Tap End Game in the top-right corner. A confirmation dialog appears:

• End Game — archives the game to history and returns to the Home Screen.
• Cancel — dismisses the dialog and returns to the game.

The final standings are immediately visible in the Game History section on the Home Screen. If any players were linked to profiles, their lifetime stats are updated immediately. If an event is active, the game is automatically added to it.

9. Game History

All completed games appear in the Recent Games section on the Home Screen, newest first.

Viewing a Game

Tap any history row to open the Game Detail View.

Deleting a Single Game

Swipe left on a history row and tap the red Delete button.

Clearing All History

Scroll to the bottom of the history list and tap Clear History. A confirmation alert appears before anything is deleted.

10. Game Detail View

Tap any completed game in history to open its detail view.

Info Section

Field	Editable?	Description
Date	No	The date the game was started (set at game creation).
Ended	Yes	The date and time the game was ended. Tap the date or time to edit. Useful for correcting games logged at the wrong time.
Players	No	Number of players in the game.

Final Standings — Individual Game

Players are ranked by their final score:

• High Score Wins (default): sorted highest to lowest.
• Low Score Wins: sorted lowest to highest.

Ranking uses competition rules — tied players share the same rank and the next rank skips. For example, if two players tie for first, both receive 🥇 and the next player receives rank 3 (not 2).

Rank	Medal
1st	🥇 (gold highlight)
2nd	🥈
3rd	🥉
4th+	"4.", "5.", etc.

Final Standings — Team Game

Teams are ranked by their final score (highest first, or lowest first for Low Score Wins). The winning team is highlighted in gold.

Each team appears as a header row showing the team's medal, name, and score. The players on that team are listed indented beneath the team header.

The same competition ranking rules apply — tied teams share the same rank.

Profile Links in Standings

Each player row in the standings shows their profile link status:

• Linked player — a small person icon and the profile name appear below the player's name. A person × button appears to the right — tap it to remove the link.
• Unlinked player — a person + button appears to the right (only when at least one profile exists). Tap it to open the profile picker and link this player to a profile. Stats update immediately.

For more on linking games to profiles retroactively, see Linking Games to Profiles.

Notes

A free-text notes field appears at the bottom of the view. Tap the field to type. Notes are saved automatically as you type.

• Tap Done in the keyboard toolbar to dismiss the keyboard without navigating away.
• You can also scroll the view up or down to dismiss the keyboard.
• Notes persist across app launches.

11. Events

Events let you group multiple game sessions under a single name — a game night, a holiday weekend, a tournament — and see a combined standings table for everyone who played.

The Events Tab

Tap Events in the tab bar to see all your events:

• Active event — shown at the top with an "In progress" badge. Only one event can be active at a time.
• Past events — listed below, most recent first.

Creating an Event

Tap + New Event and enter a name (e.g. "Christmas 2026", "Scott's Birthday Weekend"). Tap Create. The event becomes active immediately.

Automatic Game Tagging

Once an event is active, every game you start is automatically tagged to it — no extra steps. The active event banner on the Games tab confirms which event is currently running.

When you end a game, it is added to the active event's standings. If no event is active, the game goes into your general history only.

Ending an Event

When your gathering is over, open the event and tap the ⋯ button in the top-right corner, then choose End Event. The event is marked as completed and moves to the Past Events section. Future games will no longer be tagged to it.

Reopening an Event

If you ended an event by accident, tap it in the Past Events list, then use the ⋯ menu to choose Reopen Event. The event becomes active again. (Only available when no other event is currently active.)

Renaming and Deleting

Use the ⋯ menu from inside an event's detail view to Rename it or Delete it.

Deleting an event removes the event itself but leaves all the games in your history. The games just lose their event tag — no game data is ever deleted.

Swipe Actions

From the Events list:

• Swipe left on the active event to reveal an End button.
• Swipe left on a past event to reveal a Delete button.
• Swipe right on a past event to reveal a Reopen button (only available when no other event is active).

12. Event Detail & Standings

Tap any event to open its detail view.

Info Section

Shows the event start date, end date (if completed), and total game count.

Standings

The Standings section ranks every player who participated in any game within the event.

Sort modes — tap the Sort picker in the Standings header to switch between:

• Wins (default) — players ranked by number of 1st-place finishes
• Games Played — players ranked by total games played in the event

Within the same primary stat, ties are broken by the other stat. Ranking uses competition rules — tied players share the same rank.

Rank	Medal
1st	🥇
2nd	🥈
3rd	🥉
4th+	"4.", "5.", etc.

Each row shows the player name (with a profile badge if profile-linked), 🏆 Wins count, and 🎮 Games played count.

Guest players are grouped by name, matched case-insensitively. "Bob" and "BOB" are the same participant. "Bob" and "Robert" are counted separately.

Team games in event standings: Event standings are always individual-player based. For a team game, each player on the winning team receives a win credit, and each player receives a games-played credit.

Games List

Below the Standings, all games in the event are listed with the game name, date, and winner. Tap any row to open that game's full detail view.

⋯ Menu (Event Detail)

Action	When available
End Event	Event is active
Reopen Event	Event is ended and no other event is active
Rename	Always
Export Games	Event has at least one game (see Exporting Games)
Delete Event	Always

13. Exporting Games

If you are a satellite scorekeeper (tracking games on your own device at a shared event), use Export to share your games with a master scorekeeper.

1. Open the event in the Events tab.
2. Tap the ⋯ button in the top-right corner and choose Export Games.
3. The Export Games sheet appears, listing all games in the event.
   • Tap any row to select or deselect it.
   • Tap All to select every game; tap None to deselect all.
4. Tap Export (N) — the iOS Share Sheet appears.
5. Choose how to send the file:
   • AirDrop — fastest option when both devices are nearby
   • iMessage — send as a message attachment; the recipient taps it to import
   • Mail — attach to an email; the recipient taps the attachment to import
   • Save to Files — saves the file to iCloud Drive or local storage so you or someone else can open it later

The exported file is a .dskexport file containing only the games you selected.

You can export a subset of games — useful if some games were already transferred in an earlier session.

14. Importing Games

If you are the master scorekeeper receiving games from satellite devices:

1. Open the .dskexport file — Scorekeeper opens automatically and the Import Games sheet appears. The file can arrive any way:
   • AirDrop — accept the transfer on your iPhone
   • iMessage — tap the file attachment in the conversation
   • Mail — tap the .dskexport attachment in the message
   • Files app — tap the file wherever it was saved, then tap the share button and choose Scorekeeper
2. Transfer Details — confirms the source event name, number of games, and export date.
3. Add to Event — tap the local event you want the games added to.
   • All your events (active and past) are listed.
   • Tap + Create New Event to create a new event on the spot if needed. If another event is already active, the new event is created as completed — you can reopen it later from the Events tab.
4. Match Players — each unique player name from the transferred games appears as a row. Tap any row to link that name to one of your local profiles.
   • If a name already matches a profile you have, link them here to get the imported stats counted.
   • Leave any row as Guest if you don't want to link that player.
5. Tap Import N in the top-right corner. A confirmation shows how many games were imported and how many were skipped as duplicates (if any).
6. Tap Done to close the sheet.

Duplicate Handling

If the same .dskexport file is imported more than once, the app silently skips any game already in your history. You will never end up with doubled scores or stats.

After Importing

Imported games appear in your history and in the event's standings immediately. Any profile-linked players from the import have their lifetime stats updated just as if those games had been played on your device.

15. Profiles

Profiles let you track lifetime stats across every game you play. Switch to the Profiles tab (person icon at the bottom of the screen) to manage them.

Creating a Profile

Tap + Add Profile at the top of the list. Enter a name and tap Add. The profile is ready to use immediately in new games.

Profile List

Each profile row shows the profile name, games played and wins, and win percentage. Tap any profile to open its detail view.

Renaming a Profile

Tap a profile to open its detail view, then tap the ⋯ button in the top-right corner and choose Rename.

Renaming a profile does not affect historical game records — the player's name in each game entry stays as it was when the game was played.

Deleting a Profile

Swipe left on any profile row to reveal the Delete button. Tap it and confirm. When a profile is deleted:

• The profile and all its lifetime stats are permanently removed.
• All historical games that were linked to that profile are preserved — the player rows remain in the game records but revert to anonymous (unlinked).

Profile Detail View

Tap any profile to see its full stats and history.

Stats banner at the top shows:

• Games — total games played while linked
• Wins — total 1st-place finishes (ties for 1st each count as a win; in team games, all players on the winning team each receive a win)
• Win % — wins divided by games played

History section lists every game this profile participated in, most recent first. Each row shows the game name and date, player count, placement, and score.

⋯ Menu (Profile Detail)

Action	Description
Rename	Change the profile's display name.
Claim N Games by Name	Links all unlinked historical games that have a player whose name exactly matches this profile's name (case-insensitive). Only appears when matching unlinked games exist. See Migrating Pre-Profile Games.

16. Linking Games to Profiles

You can link any player in any historical game to a profile — even games played before profiles were introduced. Stats update the moment you make a change.

Linking a Player

1. Open any game from history.
2. In the Final Standings section, find the player you want to link.
3. Tap the person + button to the right of their name.
4. Choose a profile from the picker. The player is linked and the profile's stats update immediately.

Unlinking a Player

1. Open any game from history.
2. Find the linked player (shown with a profile name and person icon below their name).
3. Tap the person × button to the right. The link is removed and the profile's stats are decremented.

Notes on Linking

• Double-link protection: Tapping "link" on a player who is already linked to a profile is a safe no-op — the same game cannot be counted twice.
• Stat accuracy: Linking and unlinking use incremental updates (add or subtract one game/win). Stats remain accurate even for profiles that accumulated stats from games that have since rolled off the 1,000-game history limit.

17. Migrating Pre-Profile Games

If you used the app before profiles were introduced (v1.1), your existing game history is fully preserved. Here's how to connect those older games to profiles you create.

Step 1 — Create Your Profiles

Go to the Profiles tab and tap + Add Profile for each regular player. Use the same name they used in your games (spelling and capitalization don't have to match exactly — the claim feature is case-insensitive).

Step 2 — Use "Claim Games by Name" for Bulk Linking

This is the fastest way to migrate a large history.

1. Tap a profile to open its detail view.
2. Tap the ⋯ button in the top-right corner.
3. If any unlinked historical games contain a player whose name matches this profile's name, you'll see Claim N Games by Name. Tap it.
4. Confirm. All matching games are linked at once and the profile's stats update immediately.

Repeat for each profile.

Tip: If a player used slightly different name spellings across games (e.g. "Scott" vs "scott"), the claim will still find them — matching is case-insensitive. However, if the name is spelled differently (e.g. "Scott M." vs "Scott"), those games will not be claimed automatically. Use the per-game manual link for those.

Step 3 — Link Any Remaining Games Manually

For games that weren't caught by the name claim (e.g. different spellings, guest players you want to associate), link them one at a time from the Game Detail View:

1. Open the game from history.
2. Tap the person + button next to the player.
3. Pick the profile.

What Happens to Unlinked Games?

Unlinked games remain in your history permanently. They just don't contribute to any profile's lifetime stats. There's no requirement to link every game — link as many or as few as you like.

18. Tips & Notes

• Resuming a game: The app remembers the active game between launches. The resume banner on the Home Screen is always there until you end the game.
• Starting a new game over an active one: Tapping + New Game when a game is in progress will prompt you to end the current game first. The current game is archived to history before the new one starts.
• Player names pre-fill: When you open New Game (individual mode), the roster from your most recent game is loaded automatically, including any profile links. Adjust as needed, then tap Start Game.
• Team games always start fresh: Toggling Team Game on always gives you two empty default teams — no pre-fill from the last game. This is intentional, since team composition is deliberate.
• Score colors: Scores are color-coded throughout the app — green for positive totals, red for negative, gray for zero.
• Low Score Wins applies everywhere: The toggle set at game creation affects the live scoreboard sort order, the winner displayed in the history row, and the Final Standings ranking in the Game Detail view. It works the same way in team games.
• Tied wins: If two or more players (or teams) tie for 1st place, each of them receives a win credit. In team games, every player on a tied-for-first team each receives a win credit. Win percentage is calculated as wins ÷ games played.
• Team game profiles: In a team game, all players on the winning team receive a win credit to their profile. All players in the game receive a games-played credit. No individual score is tracked — the team score is what counts.
• History limit: The app stores up to 1,000 completed games. The oldest games are removed automatically once that limit is reached. Profile lifetime stats are accumulated before any trim occurs, so no stats are lost when old games roll off.
• Profile stats survive the history limit: Even after a game rolls off the 1,000-game cap, the stats it contributed to a profile are already counted and are not removed.
• Events don't expire: Ended events stay in your Events tab indefinitely. You can always go back and review standings from a past gathering.
• One active event at a time: You cannot start a second event while one is already active. End the current event first, or reopen a past one after ending the current.
• Importing without an existing event: If you receive a transfer but haven't created a local event yet, use + Create New Event inside the Import sheet. No need to navigate away first.
• Re-importing safely: Share the same .dskexport file as many times as you like — duplicates are silently skipped. Only genuinely new games are added.
• Transfer works over iMessage, Mail, and Files too: The Export button opens the standard iOS Share Sheet. The recipient can tap any .dskexport attachment or file — regardless of how it arrived — and Scorekeeper opens the import flow automatically.
• Data storage: All data is saved locally on your device in a single JSON file. No account, no network connection, and no cloud sync is required.