Skip to content

skrodahl/NewTon

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

1,118 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

NewTon DC Tournament Manager

Version License Docker Pulls GHCR Docker Image Size GitHub Stars

Action Shot

Changelog | Release Notes | Official Website

โžท NewTon DC Tournament Manager provides a clean, professional interface with offline-first design for reliable single and double-elimination darts tournaments. It runs entirely in your browser โ€” no server, database, Internet connection, or installation required.

๐ŸŽฏ NewTon Chalker is a companion x01 scoring app designed for tablets at the dartboard. Crash-proof with persistent match data, match history, and live statistics. Install as a PWA for a native app experience.

๐Ÿ”’ Total Privacy: Your tournament and match data live in your browser's localStorage, period. We have a demo site, but even there your data never leaves your device. Complete privacy by architecture, not by policy.

Download for offline use, double-click tournament.html to get going. Or self-host with Docker.


See It in Action

Official Website and Apps

Visit the official NewTon DC Tournament Manager Website.

Fully functional versions of the latest Tournament Manager and Chalker apps are available for use and testing.

๐ŸŽฏ https://newtondarts.com

All data stays in your browser - nothing is stored on the server or shared with anyone else.

Screenshots

Player Registration, Saved Players, and Dynamic Help:

Player Registration and Dynamic Help

Tournament Setup:

Tournament Setup

16-player Tournament Bracket Showing "Match Card Magic Zoom" and Status Bar:

16-player bracket with "Match Card Magic Zoom"

Match Controls with Referee Suggestions and Match/Referee Conflict Detection:

Match Controls

Celebration:

Celebration

Configuration Page:

Configuration Page

Developer Console:

Configuration Page

๐Ÿš€ Getting Started

  1. Download the latest official release (Run git clone or download ZIP for the latest beta)
  2. Double-click tournament.html to open NewTon DC Tournament Manager, and you're up and running
  3. Visit our User Guide to learn how to run and manage tournaments, or press F1 for help

All NewTon DC Tournament Manager's features are described in detail in the User Guide.

No installation, no servers, no complexity โ€” just pure tournament management.


๐Ÿณ Docker Deployment (Self-Hosting)

Want to host NewTon Tournament Manager on your own server? Docker makes it effortless.

Get running in under 2 minutes:

# Download docker-compose.yml
curl -O https://raw.githubusercontent.com/skrodahl/NewTon/main/docker/docker-compose.yml

# Start the container
docker compose up -d

# Access at http://localhost:8080

What's Included:

  • โœ… Lightweight Alpine container (~60MB)
  • โœ… PHP REST API for tournament sharing
  • โœ… nginx + PHP-FPM for optimal performance
  • โœ… Multi-architecture support (Intel/AMD + Apple Silicon/Raspberry Pi)
  • โœ… Persistent storage for tournaments
  • โœ… Custom logo and payment QR code support
  • โœ… Optional SEO landing page (NEWTON_LANDING_PAGE=true)

Documentation:


โœจ Key Features

See the NewTon DC Tournament Manager User Guide to learn how to use these features to manage your own tournaments.

More on the architecture and focus on resilience here.

๐Ÿ† Tournament Management

  • Multiple Tournaments: Create, save, and load with automatic browser storage
  • Import/Export: JSON-based backup and sharing between computers
    • Tournament Protection: Completed tournaments loaded from file are read-only to protect data integrity
  • Tournament History: Complete match records with lane and referee assignments
  • Crash Resilient: Automatic saving prevents data loss
  • Optional Server Features: Sharing completed tournaments if hosted on a webserver with PHP, using REST API

๐ŸŽฏ Single and Double Elimination Brackets

  • Professional Structure: Single and Double elimination brackets for 8, 16, and 32 players, facilitates tournaments for 4-32 players.
  • Smart Generation: Prevents two walkovers from meeting in first round
  • Fair Draw: Byes randomly distributed to prevent unfair advantages and minimize walkover chains
  • Interactive Visualization: Zoom, pan, click-to-select winners with complete progression lines and placement indicators
  • Match Card Magic Zoom: Auto-zoom on individual matches when zoomed out too far to read and control the matches
  • Automatic Advancement: Walkovers advance real players intelligently
  • Undo: Reverse recent match results (staged undo prevents accidentally clearing large portions of the bracket)
  • Contextual Status: Hover over tournament matches to show status, tournament progression, and undo

๐ŸŸข Match Color Coding

Intuitive traffic light system for instant priority assessment:

  • ๐Ÿ”ด Orange/Red = "DO THIS NOW" (LIVE matches, current focus)
  • ๐ŸŸก Yellow = "READY FOR ACTION" (can be started, next up)
  • ๐ŸŸข Green = "COMPLETED" (done and archived)
  • โšช White/Gray = "NOT READY YET" (pending, no action possible)

๐ŸŽฎ Match Management

  • Centralized Control: Manage entire tournament from Match Controls interface
  • Clear Progression: Each match shows exactly where winners and losers advance ("Leads to...")
  • Lane Assignment: Assign matches to dartboard lanes (1-20 with exclusions, configurable)
  • Referee System: Referee suggestions, and select referees with conflict prevention
  • Real-time Updates: Live standings and bracket progression

๐Ÿ‘ฅ Player & Statistics

  • Player List Registry: Maintain a persistent list of regular players for consistency across tournaments
    • Alphabetically sorted for easy scanning
    • Quick-add players to new tournaments
    • Import/export with tournament data
  • Registration: Add players and track payment status
  • Late Registration: New players can be added to a tournament if there are any walkover spots available
  • Comprehensive Stats: Short legs, high outs, tons, 180s with configurable points
  • Live Rankings: Real-time 1st through 32nd place calculation
  • Export Results: CSV and JSON export with full tournament history

โš™๏ธ Configuration

  • Custom Branding: Add club logo, favicon, and customize title
  • Flexible Scoring: Configurable points for participation, placements, and achievements
  • Match Formats: Best-of legs for rounds, semifinals, and finals
  • UI Preferences: Confirmation dialogs and interface behavior

Official User Guide


๐Ÿ—๏ธ Technical Details

Architecture:

  • Pure HTML5, CSS3, and JavaScript (ES6+) โ€” zero dependencies
  • Browser LocalStorage for offline persistence
  • Hardcoded progression tables for bulletproof match advancement
  • Transaction-based history system with complete undo functionality

Browser Compatibility:

  • Chrome 80+, Firefox 75+, Safari 13+, Edge 80+
  • Requires JavaScript and LocalStorage support

The architecture and resilence of NewTon DC Tournament Manager is documented on our official web site.


๐Ÿ’พ Data Management

  • Automatic Saving: All changes saved immediately to browser storage
  • Import/Export: JSON files for backup and computer-to-computer transfers
  • Privacy: Complete local storage, no cloud or external data sharing
  • Undo System: Reverse recent match results with transaction history
  • Developer Console: Manage late registrations, debug, view tournament health, transaction log management

๐ŸŽฏ Use Cases

  • Tournament Organizers: Professional dart tournament management
  • Dart Clubs: Regular tournament nights and member ranking systems
  • Event Management: Pub tournaments, corporate events, charity fundraisers

๐Ÿ†˜ Troubleshooting

Common Issues:

  • Ensure JavaScript is enabled in your browser
  • Clear old tournaments if storage becomes full
  • Close other browser tabs for optimal performance with large tournaments

Data Recovery:

  • Use the undo system to reverse recent changes
  • Import from exported JSON backup files
  • Reset tournament to bracket generation if needed

๐Ÿ“„ Credits

Created by Hรฅvard Skrรถdahl NewTon DC Malmรถ

License: Open source (BSD 3-Clause License) project for dart tournament management