Golf Handicap
A handicap tracker for golfers who keep their own number.
Live: https://eagleadams86.github.io/golf-handicap/
Most handicap apps will only ever show you the official figure. Plenty of golfers don't
work it out that way — they take their last few cards and average them, usually in a
spreadsheet. This app does both, from exactly the same rounds, and shows them side by side:
- Install it like an app — on a Mac or a PC, open the site in Chrome or Edge and choose "Install Golf Handicap". It gets its own window with no browser chrome, its own icon in the Dock or on the taskbar, and it opens straight from there. On an iPhone or iPad, Safari's Share ▸ "Add to Home Screen" does the same. Working offline was already here and is unchanged — the app has kept a copy of itself since August; what is new is that the manifest and its icons are kept too, because an installed app is the copy most likely to be opened with no connection at all
- The league handicap — by default the average of your last 5 rounds, and
configurable from there (see The League Handicap). This is the
figure the app leads with, and the one the leaderboard is ranked on.
- The official World Handicap System index — best 8 of the last 20, with the
reduced-scores table and the soft/hard caps. Always calculated, never affected by
anything you change about the league rule.
Add everyone you play with and the Leaderboard tab ranks the lot of you on the same
rule, from the same rounds — and Strokes on the Day turns those handicaps into the shots
each of you gets at one course, in one format, which is the sheet a league actually wants
before it tees off. One round of golf is logged once: tick everyone who played and give them
their scores, and the date, course and tees are typed a single time.
Share turns any of it into a read-only link you can send — the data rides inside the
link, so nothing is uploaded anywhere.
Everything works offline and without an account. Google sign-in is optional and only exists
to put the same rounds on your phone and your laptop.
Contents
Using It
A browser with nothing in it opens on one card — no tabs, no panels:
Welcome to Golf Handicap
A handicap tracker for golfers who keep their own number. Log a round and it works out both
figures from the same cards — the league handicap, an average of your last few rounds, and
the official World Handicap System index beside it…
Start Fresh · Load Sample Data · Restore a Backup
Start Fresh opens the course editor, because a score means nothing until the app knows the
rating and slope it was shot against. Load Sample Data loads
the example league. Restore a Backup opens the same
Back Up & Restore window the ⇩ button does. The Rounds card offers the two
examples again while the app has no rounds at all; a golfer with no rounds in an app that
has some — a new member, say — is offered a round and nothing else.
The card is up only while the app is completely bare. Save a course and it steps aside for the
Rounds card's own first-run state, which knows you have somewhere to play and offers the round
rather than the course again. Every app in the family opens on this same card, in the same
words and the same order.
- Add a course. Golfers & Courses → + Add Course in the header. A course needs, for each set of tees,
a course rating, a slope rating and a par — all three are printed on the
scorecard. The rating is what a scratch golfer is expected to shoot (e.g. 69.4); the
slope is how much harder it plays for everyone else (55–155, average 113). Add as many
sets of tees as you play from.
- Log a round. + Add round. Date, holes, course, tees, then a score for everyone who
played — the whole fourball goes in through one window, with nobody ticked but you until
you say otherwise. The next round pre-fills with whatever the last one used, so a regular
game at the same club is a few taps. A round is something that was played: a date after
today is refused, and the picker greys tomorrow out.
- Read the two numbers. Both figures update as you type, and How these are worked out
shows the actual arithmetic — which rounds were used, what they averaged to, and every
step in between.
The app has two tabs. My handicap is one golfer's page — the two figures, the trend
chart, the course handicap and the full list of rounds. Leaderboard is everybody at
once (see The leaderboard).
The header's controls and the tabs are each one line that scrolls sideways, at every
window size (2026-09-14). The controls stay beside the app's name and you flick or scroll
them there to reach the rest; only on a phone held upright, where the name itself takes two
lines, do they sit on one line underneath it. With a mouse or trackpad, ‹ › arrows
appear at the end of a row whenever something is off an edge, and moving along a row with
Tab or the arrow keys always brings the control you land on fully into view. The header
stays pinned to the top of the window at every size, phones included, and anything the
keyboard scrolls to lands below it rather than behind it. The controls used to wrap onto as
many as four lines, pushing the page down.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
