https://github.com/chef0111/tku-sparring

A modern, user-friendly web application for managing Taekwondo sparring matches.
https://github.com/chef0111/tku-sparring

scoreboard shadcn-ui taekwondo tailwindcss tanstack-start tournament-manager

Last synced: 5 days ago
JSON representation

A modern, user-friendly web application for managing Taekwondo sparring matches.

• Host: GitHub
• URL: https://github.com/chef0111/tku-sparring
• Owner: chef0111
• License: mit
• Created: 2025-03-15T15:29:06.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2026-05-17T12:33:38.000Z (11 days ago)
• Last Synced: 2026-05-17T14:48:10.027Z (10 days ago)
• Topics: scoreboard, shadcn-ui, taekwondo, tailwindcss, tanstack-start, tournament-manager
• Language: TypeScript
• Homepage: https://tku-sparring.vercel.app
• Size: 22.5 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          
# TKU Sparring System • ![License](https://img.shields.io/badge/License-MIT-blue)

A modern, user-friendly web application for managing Taekwondo sparring matches of UIT Taekwondo Tournaments.

## 🚀 Installation Guide

### Option 1: Direct access (Recommended)

Simply visit [TKU Sparring App](https://tku-sparring.vercel.app/) in your web browser to start using the application immediately.

### Option 2: Setup the project locally

Refer to [DEVELOPMENT.md](./DEVELOPMENT.md) for detailed instructions on how to set up the project locally.

## 🔋 Features

  

    Feature

    Description

  

  

    Match Configuration

    Customizable player names, round duration (10-300s), break time, health points, up to 3 rounds

  

  

    Scoring System

    6-point scoring (6/4/3/2/1 points), automatic health updates, visual feedback on critical hits

  

  

    Penalty & Mana System

    Gam-jeom tracking, 5-point mana system, penalties reduce mana and can end match

  

  

    Timer & Scoring

    Round timer with countdown, break time between rounds, scoring enabled only during active rounds

  

## 📋 Restrictions

  

    Restriction

    Details

  

  

    Scoring Disabled

    Match not started, timer paused, break time active, player health = 0, time expired, max rounds reached

  

  

    Penalty Rules

    Max 5 penalties per player, penalties reduce mana, match ends if mana = 0

  

  

    Winner Determined

    Health depletion (KO) → Mana depletion → Remaining health → Fewer penalties → Technique points

  




> [!NOTE]

>

> - User can still operate a match without configuration

> - Timer must be started before using any feature

> - User cannot reset the previous round's stat during break time

> - The system is web-base and **only supports PC resolution**.

## 📊 Stats

![Stats](https://repobeats.axiom.co/api/embed/bab8fc528b5de608bc6d757a16fbef110695eead.svg 'Repobeats analytics image')

## 📃 License

Licensed under the [MIT License](./LICENSE).