Skip to content

npilk/openyardage-web

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OpenYardage

Generate printable golf yardage books directly in your browser using course data from OpenStreetMap. This is a Javascript port of Hacker Yardage.

Features

  • Search for any golf course by name and auto-fit a bounding box, or draw one manually
  • Customizable colors for fairways, greens, water, sand, trees, and more
  • Distance annotations: carry distances, feature-to-green distances, 50-yard arc rings
  • Green close-up inset with 3-yard grid on every hole page
  • Exports a print-ready PDF
  • Works with any course that has golf=hole ways tagged in OpenStreetMap

Usage

  1. Select Course — Search by name or draw a rectangle on the map around the course
  2. Generate — Adjust colors, units (yards/meters), and options
  3. Review and Export — Tweak individual holes as needed, then export to PDF

Running Locally

The app uses ES modules, so it must be served over HTTP (not opened as file://):

cd openyardage-web
python3 -m http.server 8080
# then open http://localhost:8080

Any static file server also works: npx serve, VS Code Live Server, Caddy, nginx, etc.

OSM Data Quality

Output quality depends on how well the course is mapped in OpenStreetMap. A well-mapped course will have:

  • golf=hole ways for each hole (tee → green node order)
  • golf=fairway, golf=green, golf=bunker, golf=tee polygons
  • natural=water, natural=wood / landuse=forest for hazards

If the course you want isn't mapped, you can sign up yourself at openstreetmap.org and map it directly — see this guide for more information.

Attribution

Map data © OpenStreetMap contributors (ODbL)

About

Generate golf yardage books from open data. JS port of hacker-yardage (python).

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors