← NewTon DC Tournament Manager

User Guide

Everything you need to run a darts tournament with NewTon DC Tournament Manager.

Quick Start

NewTon DC Tournament Manager runs entirely in your browser — no installation, no account, no internet required after the first download.

  1. Download — Get the latest release from github.com/skrodahl/NewTon/releases/latest. Unzip and place the folder anywhere on your computer.
  2. Open — Launch tournament.html in your browser. No server needed — double-clicking the file works.
  3. Configure — Visit the Config tab to set your club name, logo, point values, and leg counts. You only need to do this once.
  4. Create — Click New Tournament and enter a name and date.
  5. Register — Add players by name. Mark payment status as players arrive. NewTon DC Tournament Manager remembers names across tournaments via the Saved Players registry.
  6. Generate — Choose Single or Double Elimination and the bracket size, then click Generate Bracket. The draw is randomised automatically.
  7. Run — Manage matches from the bracket view. Assign lanes, record results, and track the tournament in real time.

Tournament Formats

Double Elimination (DE)

Every player gets two chances before they are eliminated. The bracket is split into a Frontside (winners) and a Backside (losers). A player who loses on the Frontside drops to the Backside and can still win the tournament.

Single Elimination (SE)

One loss and you're out. Straightforward bracket where winners advance and losers are eliminated immediately.

Which to Choose?

When in doubt, use Double Elimination. It rewards consistency, keeps more players engaged throughout the evening, and produces a more meaningful result. Single Elimination is the right call when you're short on time or boards.


Configuration

The Config tab stores global settings that apply across all tournaments. Changes take effect immediately and persist across browser sessions.

Club Identity

Point System

NewTon DC Tournament Manager calculates tournament standings automatically from tournament results. Configure point values to match your club's rules:

Match Configuration

Set the number of legs per round independently for both formats:

Lane Management


Managing a Tournament

Creating a Tournament

Click New Tournament from the tournament list. Enter a name and date — both appear on exports. Select your format (DE or SE) and bracket size before generating the bracket.

Registering Players

Add players from the Players tab before generating the bracket. Type a name and press Enter or click Add. The order of entry doesn't matter — the draw is randomised when you generate the bracket.

Saved Players Registry

NewTon DC Tournament Manager maintains a persistent registry of player names across all tournaments. When you start typing a name, matching suggestions appear from previous tournaments — select one to add without retyping. The registry grows automatically as you run tournaments.

Player names in the registry can be managed from the Config tab — remove old or misspelled entries to keep suggestions clean.

Payment Tracking

Each player has a payment status indicator on the Players list. Toggle it to mark who has paid the entry fee. Payment status is visible at a glance and included in the player list — useful for the person collecting fees at the door.

Generating the Bracket

Once all players are registered, click Generate Bracket. NewTon DC Tournament Manager randomises the draw and sets up all matches. If your player count doesn't fill the bracket exactly, byes are distributed automatically — bye winners advance without playing.

The bracket cannot be regenerated once matches have started. Double-check your player list before generating.


Running Matches

The Bracket View

The bracket is the main view during an active tournament. It displays the full draw — Frontside and Backside — with all matches and their current status.

Navigation

The left-hand panel provides quick access to all sections:

Pan & Zoom

The bracket can be panned freely by clicking and dragging. Use the mouse wheel or the + / buttons in the top-right corner to zoom in and out. The home button between them resets the view to the default zoom and position.

Match Status

Matches progress through four states:

Status Panel

The bottom-right corner shows a live summary of the tournament: name, elapsed time, completed match count, bracket size, total matches, player count, date, application version, and current status (Active / Completed).

Match Controls

The Match Controls panel is the command center for running the tournament. Open it by clicking the Match Controls button at the top of the bracket view, or enable Automatically open Match Controls to have it open whenever a match completes and new ones become ready.

The panel shows all active and ready matches in two columns — Frontside on the left, Backside on the right — sorted by round. Live matches appear at the top, sorted by lane number. Each match card shows the match ID, where the winner and loser will advance to, and the Best of X format configured for that round.

Everything you can do in Match Controls — starting matches, assigning lanes and referees, declaring winners, entering scores and stats — can also be done directly from the bracket view by clicking individual match cards. The one thing exclusive to Match Controls is the Referee Suggestions panel.

Starting a Match

Ready matches show a lane dropdown, a referee dropdown, and a Start Match button. Select a lane and optionally a referee, then start the match. The match moves to Live status and lane is locked in.

NewTon DC Tournament Manager flags conflicts with a ⚠️ warning on the player's name — for example, if a player is currently serving as referee for another match and has a new match ready to start. The conflict is informational; you can still proceed once the referee situation is resolved.

Lane & Referee Conflict Management

NewTon DC Tournament Manager tracks all lane and referee assignments in real time:

Referee Suggestions

The right-hand panel shows referee suggestions in priority order:

This makes it easy to pick a fair referee quickly without having to track who's free manually.

Recording Results

Click a winner button on a Live match. The Confirm Match Winner dialog appears, showing the declared winner, the opponent, and the match ID. A Match Progression box confirms exactly where each player goes next — the winner's next match and the loser's next match — so you can verify before committing.

Below that, enter the Final Score (optional) — the number of legs won by each player (e.g. Christian: 2, Timothy: 0). The score must give the winner more legs than the loser.

Player names in the dialog are clickable — clicking a name opens the Statistics dialog for that player:

Stats are saved per player. Click Confirm Winner when done — NewTon DC Tournament Manager advances the winner and loser to their next matches automatically.

Leaderboard

The Leaderboard button at the bottom of the Match Controls panel opens the current standings mid-tournament. Click any player in the leaderboard to open their Statistics dialog and add stats that were missed when the match result was recorded.


Results & Export

Live Standings

The Results tab shows current standings and point totals as the tournament progresses. Final placements are confirmed when the Grand Final (DE) or Final (SE) is completed.

CSV Export

Export results as a CSV file for use in spreadsheets, season standings trackers, or club management systems. The export includes player names, placements, points earned, and achievement counts.

Tournament Export (JSON)

Export the full tournament as a JSON file — a complete snapshot including all matches, results, and transaction history. Use this to:

Importing a Tournament

Import a previously exported JSON file to restore a tournament — useful for recovering from a browser data clear, moving to a different device, or loading a shared tournament. NewTon DC Tournament Manager validates the file before importing; invalid files are rejected without affecting existing data.


Developer Console

The Developer Console provides two categories of tools: diagnostics that monitor tournament health in real time, and commands that act directly on the bracket structure and transaction history. Because these commands can modify the actual tournament data, the Developer Console is deliberately hidden from the normal operator workflow — it must be enabled in Global Settings first, then opened by clicking the version number in the bottom-right corner of the bracket view.

Statistics — updated live as the tournament runs:

Commands — diagnostic and recovery tools:


Tips & Tricks

Undo

Made a mistake recording a result? NewTon DC Tournament Manager supports surgical undo — you can reverse a match result without affecting the rest of the tournament. Click the undo button on a completed match to revert it. Matches that have already fed players into subsequent completed matches cannot be undone.

Late Registration

A player arrives after the bracket has been generated? Use Late Registration — accessible from the Players tab via the amber "Player arrived late?" button (visible on active tournaments). NewTon DC Tournament Manager finds a suitable bye slot and places the late arrival without disturbing existing matches.

Built-in Help

Press F1 at any time inside the tournament manager to open context-sensitive help. The help panel explains the current view and available actions.

Offline Use

NewTon DC Tournament Manager works entirely offline. Download the release once, copy it to a USB drive, and run it at any venue without internet. All data is saved automatically in your browser's localStorage — it survives browser restarts and reboots and new versions brought in on the next USB drive.

Multiple Tournaments

NewTon DC Tournament Manager supports multiple tournaments side by side. Switch between them from the tournament list on the home screen. Each tournament has its own isolated data — deleting one doesn't affect the others.

Data Safety

LocalStorage is tied to your browser profile. Export tournaments regularly and keep the JSON files somewhere safe — treat exports as your permanent backup and localStorage as working storage. Clearing your browser data will clear localStorage too. See the Privacy page for full details on how NewTon stores and handles your data.

Self-Hosting

Want to run NewTon DC Tournament Manager for your whole club from a central server? See the Docker Quick Start guide. Self-hosting enables shared tournament access across devices via the optional REST API.

Lollipops 🍭

Scoring a 3 — three ones — in darts is known as a lollipop. Many clubs mark the occasion by handing the guilty player an actual lollipop. NewTon DC Tournament Manager supports this tradition: open any player's Statistics dialog during or after a tournament and use the Lollipops counter to record their shame. Players with one or more lollipops will have a 🍭 icon and count displayed next to their name in the Leaderboard.