🏆 Tournaments-Bracket

Tournaments-Bracket is a modern React library for generating and rendering tournament brackets with minimal configuration. Create structured tournament grids without complex logic or manual coding.

🏆 Single Elimination format ⚛️ Built for React 🎨 Customizable match styles 🌙 Light & Dark themes support ⚡ Fast bracket structure generation 📦 Clean and scalable architecture 🔜 Future support for HTML + Vanilla JS

📦 Installation Using npm npm install tournaments-bracket

Using yarn yarn add tournaments-bracket

🚀 Quick Start 1️⃣ Prepare teams import type { Team } from "tournaments-bracket";

export const teams: Team[] = [ { id: 1, name: "Team A", logo: "../public/logo.png" }, { id: 2, name: "Team B", logo: "../public/logo.png" }, { id: 3, name: "Team C", logo: "../public/logo.png" }, { id: 4, name: "Team D", logo: "../public/logo.png" }, ];

2️⃣ Generate bracket structure npx tournaments-bracket-generate

3️⃣ Render in React import { TournamentBracket } from "tournaments-bracket"; import "tournaments-bracket/dist/tournaments-bracket.css"; import { rounds } from "./bracket/rounds";

function App() { return ( ); }

export default App;

🧱 Supported Formats Currently supported: Single Elimination Planned: Double Elimination Round Robin HTML + Vanilla JS support

🎮 Playground & Demo The official website includes: 📘 Documentation 🧪 Interactive Playground (Bracket Builder) 🎨 Live Demo

🛠 Customization You can configure: Tournament format Match spacing Styles and layout Match display options Full customization guide available in the documentation.

🤝 Contributing Tournaments-Bracket is an open project and welcomes contributions. You can help by: Reporting bugs Suggesting new features Improving documentation Submitting pull requests Before submitting a PR: Follow the project code style Test your changes

💖 Donations If you find this project useful, you can support development via donations. Your support helps improve features, maintain the project, and build new formats.

https://yoomoney.ru/to/4100119449126215

📄 License This project is licensed under the MIT License. Copyright (c) 2025–2026 iDfiz See the LICENSE file for details.

🚀 Future Vision Tournaments-Bracket aims to become a flexible, cross-platform tournament engine supporting: React HTML Vanilla JavaScript Advanced tournament formats Exportable bracket configurations