bracket-creator

bracket-creator is a CLI and web application for generating kendo tournament brackets as Excel spreadsheets. Give it a CSV of participants and it produces a fully formatted, print-ready .xlsx file with pool draws, match schedules, and elimination trees.

Tools

Tool	Command	Use when
Pools & Playoffs	create-pools	Generate a pools + knockout bracket Excel file
Playoffs Only	create-playoffs	Generate a straight knockout bracket Excel file
Bracket generator web UI	serve	Browser-based bracket generation (no CSV editing needed)
Live tournament app	mobile-app	Run pools and scores on the day, live on any device

Quick start

# Install
go install github.com/gitrgoliveira/bracket-creator@latest

# Create a pools + playoffs bracket
bracket-creator create-pools -f participants.csv -o tournament.xlsx

# Or run the bracket generator web UI
bracket-creator serve

# Or run the live tournament app (for use on the day)
bracket-creator mobile-app --folder ./tournament-data

Open tournament.xlsx in Excel or LibreOffice and print.

What you need on tournament day

• A3 printer — for team/player name sheets
• A4 printer — for the bracket trees
• Scoreboards, whiteboard markers, scissors, tasuki

Keeping courts in sync

If you have multiple shiai-jo, upload the Excel file to Google Drive (or similar) so all tables share one live document.

Before the tournament

1. Collect participants — one name per line in a CSV file (input format)
2. Generate the bracket — run create-pools or create-playoffs (commands)
3. Optionally seed top competitors so they land in separate pools/sides of the bracket (seeding)
4. Print — the Excel file is laid out to print cleanly on A4/A3

On the day

Use the live tournament app to manage pools and scores in real time across all devices on your network — no Excel required on the day. See the mobile app guide.