v1.5.1

Fixed

• Course ratings (course rating and slope) are now checked to make sure they are valid numbers before saving. This prevents a crash in the handicap calculation if an invalid value ever slipped through, such as from a bad AI ratings lookup.
• Linking two nine-hole halves into one course no longer risks silently merging an unrelated existing course's rounds and ratings into the group if the names happened to match.

Both are internal safety fixes with no change to how the app is used day to day.

v1.5.0 — Player Profile

What's new in v1.5.0

New features

• Player profile — a new profile page where you can record your background and let the AI coach tailor its advice to you. Set your age, dominant hand, and golf history (including a long break and return), your typical practice frequency and preferred format, whether you are currently taking lessons, and your own self-assessed areas to work on. Your tracked club distances are shown automatically from your shot data. Everything feeds into the AI's round debriefs, performance summaries, and practice plans when you choose to include it.
• Profile privacy controls — a single toggle decides whether your profile is shared with the AI, available both on the profile page and in Settings, kept in sync. When it is off, none of your personal details are sent.

Fixes and improvements

• Longer AI analyses no longer cut off partway through — the response limit has been doubled.
• The Regenerate button now always produces a fresh analysis instead of occasionally reporting nothing to do.
• A subtle blinking cursor now shows while an AI analysis is still being written, so it is clear the app is working.
• Your saved settings are now backed up automatically on every change, guarding against accidental data loss.

v1.4.0

What's new in v1.4.0

New features

• Round notes on import — add context notes before your round is imported, so they are included in the AI debrief without needing a second generation. Includes a per-import privacy toggle to exclude notes from AI analysis.
• Stale analysis warning — the dashboard now shows a yellow badge when a new round has been imported since the AI analysis was last generated, with a direct link to regenerate.
• Improved import progress indicator — AI generation after import now shows a step-by-step progress display with a pulsing indicator and elapsed timer, so it is clear the app is still working. On completion, the app navigates directly to the imported round.

Fixes and improvements

• Fixed round notes not appearing in round history after import — the notes column was missing from the list query.
• Improved round notes placeholder text with specific coaching prompts to encourage more useful context.
• PDF export redesigned: Inter sans-serif font, clean branded header, duplicate title removed, browser URL and timestamp suppressed.
• Switched to Waitress WSGI server with 8 threads — eliminates the Flask development server warning and prevents queue depth warnings on startup.

---

Note: restart the app after updating to pick up the new version label.

v1.3.1

What's new in v1.3.1

Fixes

• Replaced Flask's built-in development server with Waitress, a production-grade WSGI server. This removes the "do not use in production" warning that appeared in the terminal on every start.

Documentation

• Updated README with accurate feature descriptions, UK English throughout, and WHS handicap disclaimer clarifying that the index is an unofficial estimate using the WHS formula.
• Added UI screenshots to the README.

---

Note: restart the app after updating to pick up the new version label.

v1.3.0 — Smarter AI, Privacy Controls & UI Polish

What's new in v1.3.0

Smarter AI analysis

• Location-aware coaching — the AI now detects the region your course is in (UK/Ireland, Continental Europe, North America, Australia, etc.) from GPS coordinates and factors in the local climate when assessing conditions. A cold, windy morning in Scotland will not be flagged as difficult in the way it might be for a course in Florida.
• Handicap trajectory — the AI now receives your full WHS index history so it can contextualise rounds against your actual ability and improvement arc, not just your current index.
• Per-hole breakdown — round debriefs now include a full hole-by-hole table covering strokes, putts, GIR, FIR, penalties and bunker shots. Holes with two or more penalties are flagged as likely stroke-and-distance situations (OOB or lost ball) so the AI can identify tee accuracy issues on specific holes.

Privacy controls

• Notes opt-out toggle — each round's notes section now has an 'Exclude from AI analysis' checkbox so you can keep sensitive notes private.
• Global privacy default — a new Privacy section in Settings lets you set your default preference for all future rounds. Individual rounds can still be overridden independently.
• AI anonymisation — when notes are included, the AI is instructed to use them for performance context only and will never reference personal names or identifying details.

UI improvements

• Notes auto-save — notes save automatically when you click away. An 'Unsaved changes' indicator appears while typing, and 'Saved' confirms once complete.
• Scorecard table restyled — cleaner light design with a subtle header, hover rows and a bold total row, consistent with the rest of the UI.
• Settings modal — now scrolls correctly on smaller screens instead of overflowing the page.

Updating

Download the latest zip, extract it over your existing installation, and restart the app. Your data is stored separately and will not be affected.

v1.2.0 — Weather, Conditions & Smarter AI Analysis

What's new in v1.2.0

Weather and conditions

• Weather data on every round — temperature, wind speed, precipitation and sky conditions are automatically fetched from Open-Meteo's free historical weather API when you import a round, using the course GPS coordinates and your tee time.
• Tee time stored — extracted from Hole19 data and displayed alongside your round stats.
• Round history chips — each round card now shows tee time, temperature, wind and weather condition at a glance.
• Conditions card — a new card in the round detail view shows the full weather breakdown, including precipitation.

Smarter AI analysis

• AI reports now factor in weather at the time of the round, time of day (morning/afternoon/evening), days since your last round (with rustiness flags for long gaps), and playing frequency (rounds per month, average and longest gap).
• The performance summary now includes a dedicated conditions and frequency analysis point.
• The practice plan now accounts for rustiness — it recommends a pre-round warm-up if you have had a long break.

No re-import needed

On startup, the app silently backfills weather and tee time for any existing rounds that are missing them. No action required.

Bug fixes

• Pickup (dot) holes now display correctly as a muted bullet (•) on all scorecard views, with a tooltip showing actual strokes taken.
• Fixed Python version check failing for Python 3.10 and above (affected users on 3.10, 3.11, 3.12 and 3.13).
• Mac: terminal window now closes cleanly after errors instead of waiting for a keypress.
• Suppressed pip version update notices in all start and update scripts.
• Fixed the winget Python install command in the README.

Updating

Download the latest zip, extract it over your existing installation, and run the app. Your data is stored separately and will not be affected.

v1.1.0 — Easier updates & Stableford fixes

What's new

Easier updates — no more copying your data folder

Your round data is now stored in a standard location on your computer, separate from the app itself. Updating is now as simple as downloading the new zip and running it — your data carries over automatically.

• Mac: ~/Library/Application Support/strokeindexr/
• Windows: %APPDATA%\strokeindexr\
• Linux: ~/.local/share/strokeindexr/

If you are updating from v1.0.x, the app will migrate your existing data automatically on first run. Nothing to do on your end.

Stableford scoring fixes

• Correct gross score for rounds with a pickup (dot) — strokes taken on a hole before picking up were previously being dropped from the total. Scores are now correct.
• Stableford rounds now count towards your handicap trend — rounds played in Stableford format are included in the handicap index calculation and labelled clearly on the round card.

Upgrading

Download the zip below, unzip it anywhere, and run the start script. If you have a round affected by the score bug, delete it and re-import it from the import page.

v1.0.2 — Stableford scoring fixes

This release fixes two bugs affecting rounds played in Stableford format.

Bug fixes

• Correct gross score for Stableford rounds with a pickup (dot) — when a player picks up on a hole and records a dot, the actual strokes taken were previously being dropped from the total. The round now records the correct gross score including all strokes played.
• Stableford rounds now count towards your handicap trend — previously, Stableford rounds were excluded from the handicap index calculation. Since this is an informal tracker and many players use Stableford for all their casual rounds, excluding them would leave those players with no handicap trend at all. Stableford rounds are now included and labelled clearly on the round card.

Upgrading

If you have a round affected by the score bug, delete it and re-import it — the correct score will come through. Your data folder is otherwise unaffected.

v1.0.1 — UI overhaul & public release polish

This release is the first public version of StrokeIndexr, following a significant visual refresh and a round of pre-release fixes.

What's new

• New colour scheme — deep navy sidebar and headers derived from the app logo, replacing the all-green palette. Cleaner and more distinct.
• Round history redesign — each round now shows a full mini scorecard (hole numbers, par, and colour-coded scores) rather than a plain list row. Birdie, bogey, eagle and par are all immediately visible at a glance.
• Courses page redesign — course cards now show a proper stat grid (best score, average, putts, GIR) in a structured layout. Child courses (front/back 9) are nested inside the parent card rather than listed separately.
• Page headers — section titles now sit in a full-width gradient banner for a more polished feel.
• Update notifications — the app will now quietly check for new releases and show a small banner in the sidebar when one is available.
• Better first-run experience — start scripts now detect if Python is missing and give clear instructions rather than crashing silently.

Bug fixes

• Fixed a crash on fresh installs where the data folder did not exist yet.
• Removed leftover references to the old app name in start scripts.
• Fixed the back button being hidden behind the page header on round and course detail views.

v1.0.0 - Initial release

StrokeIndexr: add CONTRIBUTING.md and issue templates

Covers bug reports, feature requests, PR guidelines, code style,
Docker/cloud direction, and licence agreement for contributors.
GitHub issue templates for bug reports and feature requests.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>