Sheepshead Scoring App - Documentation

📋 Table of Contents

🔍 App Overview
🎯 Core Features
🎮 Gameplay Features
📊 Statistics & Analytics
💾 Data Management
💡 Usage Examples
🔧 Technical Capabilities
❓ Troubleshooting

🔍 App Overview

The Sheepshead Scoring App is a comprehensive web-based solution designed specifically for groups who regularly play sheepshead. It transforms the traditional pen-and-paper scoring into a digital experience with advanced analytics, automatic calculations, and persistent data storage.

🎯 Perfect For

Regular Game Groups • Tournament Play • Casual Players • Statistics Enthusiasts

⚡Instant Setup

No installation required - runs directly in your web browser. Works on desktop, tablet, and mobile devices.

🧠Smart Logic

Implements all sheepshead rules automatically, including complex doubler mechanics and schneider calculations.

📊Rich Analytics

Detailed statistics tracking overall performance, picking success, and historical trends.

🎯 Core Features

👥 Player Management

🎭Preset Players

✓7 predefined regular players
✓Quick selection with checkboxes
✓Instant game setup
✓Names: Duane, Nate, Adam, Jim, Rick, Jeff, Todd

➕Custom Players

✓Add your own players
✓Maximum 8 players total
✓Remove players as needed
✓Flexible game composition

🪑Sitting Out

✓Automatic with 6+ players
✓Dealer sits out (6+ players)
✓Smart dropdown filtering
✓No manual management needed

🚀 Quick Start Workflow

1

Select 5+ players from preset list or add custom players

2

Click "Start Game" - app automatically sets up scoring interface

3

Begin recording hands immediately with smart form validation

🎮 Gameplay Features

💰 Scoring System

Dollar-Based Display

All points are displayed as dollars ($1/point) making settlement calculations crystal clear. No more mental math - just read the numbers!

Hand Type	Base Points	With Wrap	With Re-wrap	Doubler (2x)
Normal Win/Loss	$1	$2	$4	$2
Schneider	$2	$4	$8	$4
No Trick (Schwarz)	$3	$6	$12	$6

🎲 Advanced Doubler System

🔄Doubler Queue Mechanics

Unlike traditional systems that compound multipliers, this app correctly implements doubler queueing:

✓1 Doubler → Next 1 hand is 2x
✓3 Doublers → Next 3 hands are each 2x
✓Visual Queue → "3 DOUBLED HANDS QUEUED"
✓Auto-Consume → Queue decrements as doubled hands are played

📱 Screenshot: Doubler queue showing "2 DOUBLED HANDS QUEUED" in session info

🧮 Smart Rule Implementation

⚡Schneider Logic

✓Picker needs 31+ to avoid
✓Opponents need 30+ to avoid
✓Automatic detection
✓Correct "No Schneider" display

🚫Schwarz Detection

✓0 or 120 points = No Trick
✓3x point multiplier
✓Automatic recognition
✓Clear display in hand details

📝 Hand Recording Interface

🎯 Streamlined Hand Entry

1

Dealer Selection - Required first with 6+ players, optional with 5

2

Picker Choice - Auto-excludes dealer if 6+ players

3

Partner Selection - Auto-excludes picker and dealer

4

Points & Details - Points (0-120), called suit, wraps, doublers

5

Validation & Scoring - Smart error checking, instant results

📊 Statistics & Analytics

🏆 Player Performance Tracking

Dual Record System

The app tracks both Overall Record (all roles) and Picker Record (picking only) to give complete performance insights.

Player	Overall Record	Picker Record	Win %	Times Picked	Doublers Won	Avg $/Hand
Duane Haas	18-12	8-4	60.0%	12	3	$1.25
Adam Arndt	15-15	6-8	50.0%	14	1	$0.50
Nate Miller	22-8	5-2	73.3%	7	2	$2.10

📈 Session Analytics

🎯Current Session

✓Live hand-by-hand breakdown
✓Running session totals
✓Doublers won this session
✓Progress indicator (X of 5 hands)

📚Historical Sessions

✓Browse all completed sessions
✓Detailed session breakdowns
✓Export individual sessions
✓Date/time stamps

🏅All-Time Rankings

✓Player performance rankings
✓Called suit success rates
✓Wrap/re-wrap statistics
✓Long-term trends

🎲 Doubler Performance

📊 Current session shows "DOUBLERS WON" row with golden highlighting for each player

🌟 Why Doubler Tracking Matters

Doublers are high-pressure, high-reward situations. Tracking who succeeds in these moments reveals clutch performance and risk management skills.

💾 Data Management

🔄 Automatic Session Management

📊 5-Hand Session Cycle

1

Hands 1-5 - Record hands normally, see live totals

2

Session Complete - Auto-alert with settlement summary

3

New Session Starts - Fresh scoreboard, running debt tracking

4

Historical Storage - Previous session saved to history

📤 Export Capabilities

📊Current Game Export

✓All hands with scores
✓Player totals
✓Game details and timestamps
✓CSV format for Excel/Sheets

📝Session Export

✓Individual 5-hand sessions
✓Session-specific statistics
✓Settlement information
✓Easy sharing with players

📚Complete History Export

✓All sessions and hands
✓Complete player statistics
✓Data backup and migration
✓External analysis ready

# Example CSV Export Format
Hand,Duane Haas,Nate Miller,Adam Arndt,Jim Remm,Rick Lopez,Details
1,$2,$2,-$1,-$1,-$2,"Duane+Nate WON (75 pts, called Hearts)"
2,-$1,-$1,$1,$1,$0,"Adam+Jim WON (63 pts, called Spades)"
3,$4,$4,-$2,-$2,-$4,"Duane+Nate WON (92 pts, called Clubs) NO SCHNEIDER"
            

💾 Data Persistence

🔐 Reliable Storage

Browser localStorage automatically saves every hand, surviving browser restarts, crashes, and updates. Data is immediately available when you return to the app.

💡 Usage Examples

🎮 Example Game Scenario

👥Weekly Game Night

Players: Duane, Nate, Adam, Jim, Rick (5 players)

Session 1 Progression

H1

Duane picks, calls Nate - Win with 68 points, called Hearts → +$1 each

H2

Everyone passes → DOUBLER marked, next hand worth 2x

H3

Adam picks, calls Jim - Doubled hand, lose with 45 points → -$2 each

H4

Nate picks, calls Rick - Win with 95 points → +$2 each (No Schneider for opponents)

H5

Jim picks, calls Adam - Wrapped by Duane, picker team wins → +$4 each

Player	Session Total	Hands Won	Times Picked
Duane	$0	2	1
Nate	$1	2	1
Adam	$3	1	2
Jim	$3	1	1
Rick	-$7	1	0

📊 Statistics Insights

                🎯 What The Numbers Reveal
                ✓Rick didn't pick but lost the most - conservative but unlucky
✓Adam picked twice, won once - 50% picker success rate
✓Nate best overall performance - good picker AND partner
✓Doubler impact - Adam's loss was amplified by 2x multiplier

            

🔧 Technical Capabilities

🌐 Platform Compatibility

💻Desktop Browsers

✓Chrome/Chromium
✓Firefox
✓Safari
✓Edge

📱Mobile Devices

✓iOS Safari
✓Android Chrome
✓Responsive design
✓Touch-friendly interface

⚡Performance

✓Single-file architecture
✓No external dependencies
✓Instant loading
✓Offline capable

🏗️ Architecture

📁 Project Structure
├── 📄 index.html          # Complete application
├── 📄 docs.html           # This documentation
└── 📄 README.md           # Project overview

💾 Data Storage
├── 🔐 localStorage         # Player stats, game history
├── 📊 Session tracking     # 5-hand cycles
└── 🔄 Auto-backup         # Every hand saved
            

🛡️ Data Security & Privacy

🔒 Local-First Approach

All data stays on your device - no servers, no accounts, no tracking. Your game data is completely private and under your control.

❓ Troubleshooting

🚨 Common Issues & Solutions

⚠️"Need 5+ Players"

Problem: Can't start game

Solution: Select at least 5 players from preset list or add custom players

🎯"Select Dealer First"

Problem: Can't select picker/partner

Solution: With 6+ players, choose dealer before other roles

📚Missing History

Problem: No historical data showing

Solution: Complete at least one 5-hand session to generate history

📱Mobile Display Issues

Problem: Interface too small on mobile

Solution: Rotate to landscape or zoom in browser

🔧 Advanced Troubleshooting

Data Recovery Steps

1

Use "Debug Storage" button to inspect raw data

2

Export all data as backup before making changes

3

Clear browser cache/cookies if data seems corrupted

4

Use import function to restore from exported files

🃏 Sheepshead Scoring App