Press ⛳️

Press is a mobile-first web app for tracking golf side-games. One scorekeeper enters scores for the whole group on a single phone, and Press does the math — live leaderboards and running money totals while you play, then a settle-up summary at the end.

No accounts, no sign-up, nothing to install from a store. It runs entirely in your browser, works offline, and keeps everything on your device — see PRIVACY.md for exactly what leaves it and when.

▶️ Live app: pressgolf.netlify.app 📺 Walkthrough: youtu.be/YDgTmnR_1eo — a full round in under six minutes

_{Real screenshots of the production build at phone width — npm run screenshots:capture regenerates them. The full Results screen shows the settle-up and the awards.}

Games

• Stroke play — gross or net
• Match play — 1v1 and 2v2 best-ball
• Skins
• Stableford
• Wolf
• Vegas — 2v2, scores written side by side, with an optional birdie flip
• Quota — beat your own points target, set by your handicap
• Nassau — 1v1 and 2v2, with manual presses
• Golf League — Thursday-night format (A/B singles + combined team match, league points)

Net scoring with per-hole handicap strokes is supported throughout — one stroke per hole down the stroke index, and a second on the hardest holes when a handicap exceeds the hole count. Match Play and Nassau follow the Rules of Handicapping (Appendix C): the lowest handicap in the match plays off scratch and the others receive the difference, cut to 90% in a four-ball. Save a course's pars and stroke indexes once and reload them with a tap, or pull them live from course search (course data © OpenStreetMap contributors, ODbL 1.0, via OpenGolfAPI).

Settling up

Set a stake per game and Press tracks everyone's net result live during the round — a money ticker and per-game breakdown on the Hole and Board tabs — then resolves the final total into the fewest payments needed to settle the whole group (exactly, for up to twelve people with money to move; past that, at most one payment per person).

Awards

A finished round hands out a few superlatives — Shot of the Day, The Snowman, The ATM, Sandbagger, Wolf's Gamble — ranked by how notable they are and capped so no one player takes the whole card. They show on the Results screen and on the shared scoreboard image, and each one cites the number behind it.

Sharing a round

Results can go out as a scoreboard image, a scorecard image, or plain text — and the round itself can be handed to another phone by link or QR code. The whole round is packed into the link's fragment, so it is decoded by the other person's copy of Press and never touches a server: no account, no backend, and it opens with no signal. A round that arrives is held behind a "Keep it" button rather than being saved onto someone's device unasked.

Saved courses can be sent the same way — the other phone gets the pars and stroke indexes you checked, sees the card laid out before saving anything, and is told if it differs from one they already have.

Mid-round, the same link hands the card over: the other phone carries on scoring from where you left off. If both phones end up scoring the same round, Press compares the two and asks which card is the real one — or keeps both — rather than picking one on a timestamp.

Getting started

Requires Node 24+ (see .nvmrc).

npm install
npm run dev            # local dev server
npm run dev -- --host  # expose on your LAN to test on a phone

Other scripts:

npm run test       # run the scoring-engine test suite
npm run typecheck  # tsc -b --noEmit
npm run lint       # oxlint
npm run build      # production build

Auditing the rendered app

npm run audit:a11y drives every screen in a real browser at 390px and 360px and reports what a diff cannot show: controls with no accessible name, controls whose name says nothing ("1, button"), text clipped by its own box, sideways overflow, tap targets under 24×24, skipped heading levels, duplicate ids. It exits non-zero on anything that is wrong at any size, and merely lists targets between 24 and 44px — some of those are justified, and a gate that cries wolf is a gate somebody turns off.

Playwright is deliberately not a dependency; install it when you want to run this:

npm install --no-save playwright && npx playwright install chromium
npm run preview        # in one terminal
npm run audit:a11y    # in another

The accessible-name half of the same check runs in CI without a browser, in src/a11y.dom.test.tsx.

The link-preview card

public/og.png is what a shared pressgolf link unfurls into. It is drawn by scripts/og-image.mjs from the brand art in BRAND.md and the app's own Oswald, and committed, since crawlers need a PNG. Regenerate it when the mark, the colours or the tagline change:

npm run og:image   # uses Playwright if installed, else a Chromium/Chrome on PATH

The README screenshots

docs/screenshots/*.png are taken from the production build in a headless Chromium at phone width, seeded with an invented four-ball (scripts/capture-screenshots.mjs):

npm run build
npm run screenshots:capture   # needs Playwright (see above) or PLAYWRIGHT_CHROMIUM=/path/to/chrome

How it's built

Vite + React + TypeScript, shipped as an installable PWA. Each game is a pure-function scoring engine in src/games/, kept separate from the UI so the math is unit-tested independently. Deployed to Netlify on every push to main.

Feedback setup (Netlify)

In-app feedback posts to Netlify Forms. Form detection is OFF by default on every new Netlify site. Three settings live in the Netlify UI, not in this repo, and without the first every submission is lost:

1. Site configuration → Forms → enable Form detection. Off is the default — this is the step that's easy to skip.
2. Forms → Form notifications → add an email notification for the press-feedback form.
3. Redeploy. Detection runs at deploy time; enabling it does not retroactively scan the previous build.

The form definition lives in public/__forms.html. It is the POST target as well as the definition — posting to / would hit the catch-all rewrite in netlify.toml, which returns the app shell with HTTP 200 and would make a lost report look like a successful one. Because __forms.html is itself a real static file, a site with detection off (or not yet redeployed) also answers POST with 200 and the stub's own HTML instead of a 404 — postFeedback in src/feedback.ts checks the response body for the stub's title and treats that as a failure rather than delivery, so a report is only counted as sent once Netlify's actual form handler accepts it.

Free tier allows 100 submissions/month. Reports that fail to send stay queued in the browser and retry — a report is only counted as sent once Netlify's form handler actually accepts it. The queue holds up to 20 unsent reports; beyond that, the oldest is discarded to make room for the newest.

License

Press is released under the PolyForm Noncommercial License 1.0.0 — free to use, modify, and share for any noncommercial purpose (play all the golf games you want). Commercial rights are reserved.

Why this license? It matches how Press is meant to be used today — shared freely with friends for their rounds — while keeping the door open to a paid product later. As the sole copyright holder I can always loosen this to a fully open license (e.g. MIT), but a permissive release can't be taken back, so starting protective costs nothing and preserves every option.