🎳 Bowling Brackets

A static web app for running 8-bowler single-elimination bowling brackets. No server, no build step — it runs entirely in the browser and is ready for GitHub Pages.

How it works

1. Entries — paste the list of bowler numbers, one per line. Add a count for multiple entries:

   101        (1 entry)
   102 3      (3 entries — also 102x3, 102,3, 102:3)
   

   Repeating a bowler adds to their total. The preview shows how many brackets the entries fill.
2. Create brackets — bowlers are drawn into as many full 8-bowler brackets as possible. A bowler is never in the same bracket twice; seats are random. Entries that can't fit in a full bracket are listed as refunds.
3. Scores — make one pass over the bowlers per game:
   • Game 1 → quarterfinals, Game 2 → semifinals, Game 3 → finals.
   • Type a score and press Enter to jump to the next bowler.
   • "Only bowlers still alive" hides bowlers already knocked out of every bracket.
4. Brackets — live view of every bracket. Ties show buttons to pick the winner (e.g. after a roll-off). Use Find bowler to highlight someone, and Print brackets for paper copies.
5. Results — what each bowler is owed, winners per bracket, and a CSV download.

Entry fee and 1st/2nd payouts are set on the Entries tab (default $5 entry, $30 / $10).

Saving

Everything saves automatically in the browser (localStorage) on that device. Use Save file to download the tournament as a .json file and Open file to load it on another device or keep a backup.

Run locally

Open index.html in a browser — that's it.

Logic tests (needs Node):

node tests/bracket-logic.test.js

Host on GitHub Pages

1. Create a GitHub repository and push this folder to it.
2. In the repo, go to Settings → Pages.
3. Under Build and deployment, choose Deploy from a branch, pick main and / (root), and save.
4. The site will be live at https://<your-user>.github.io/<repo-name>/ in a minute or two.

Files

• index.html — page layout
• css/style.css — styles (light/dark mode, print layout)
• js/bracket-logic.js — bracket drawing, scoring and payout logic (no DOM; tested in Node)
• js/app.js — UI