Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/SdazaP/ruTournament/llms.txt

Use this file to discover all available pages before exploring further.

This page walks you through creating a complete tournament from scratch — from opening the app for the first time to publishing a public results leaderboard. No account, no configuration files, and no server are needed. Everything runs in your browser.
A ruTournament tournament moves through three lifecycle states. Próximamente (Upcoming) is the initial state after creation — the tournament is visible but competition has not started. Activo (Active) means the event is live and results can be entered. Finalizado (Finalized) locks the tournament to read-only mode; no further edits to results or participants are allowed. You can advance the state from the tournament dashboard.
1

Open the App

Navigate to the ruTournament application in your browser. If you are using the hosted version, open the public deployment URL. If you are running it locally after following the installation guide, open:
http://localhost:5173
You will land on the home page. Click Ir al Dashboard (Go to Dashboard) or navigate directly to /dashboard to reach the main tournament list. No login or account creation is required — the app is immediately ready to use.
2

Create a Tournament

From the dashboard, click Crear nuevo torneo (New Tournament) to launch the 3-step creation wizard.Step 1 — Basic InfoFill in the tournament’s core details:
  • Name — the public-facing tournament title.
  • Location — select the Mexican state where the event will take place using the state selector dropdown.
  • Description — a short summary shown on the tournament overview page.
Step 2 — Categories & FormatConfigure the competitive events. You can add up to 10 categories per tournament:
  • Choose from 12 predefined WCA events (3x3, 2x2, 4x4, 5x5, 6x6, 7x7, 3x3 OH, Clock, Megaminx, Pyraminx, Skewb, Square-1) or define a custom category with a free-form name.
  • Select either WCA format (multi-round averages: ao5 or ao3, with +2/DNF penalty support) or Red Bull format (direct elimination bracket with optional seeding round).
  • Configure the number of rounds and how many competitors advance between rounds.
Step 3 — CompetitorsRegister the participants who will compete:
  • Add competitors by name using the registration form.
  • Assign each competitor to one or more of the categories configured in Step 2.
  • Competitors can be added or edited later from the tournament’s Participants page.
Click Crear Torneo (Create Tournament) to save. The tournament is created in IndexedDB and you are redirected to its dashboard.
3

Run the Tournament

Once inside the tournament dashboard, the left sidebar gives you access to every management section. Work through them in order as the event progresses:Competidores (Participants) Review the registered competitor list, add late registrations, or remove withdrawn participants. Edit category assignments at any time before results are entered.Staffing Assign operational roles to competitors on a per-category basis. Available roles are Judge, Runner, and Scrambler. Staff assignments are visible to the groups engine so you can keep roles and competition slots separated.Grupos (Groups) Automatically divide competitors into competition groups for each round. The groups engine distributes competitors and assigns the configured staff members. Groups can be regenerated until you are satisfied with the layout.Scrambles Generate official scramble sequences for each group and round using the integrated csTimer engine. Scrambles are produced entirely in-browser — no external website visit is required. Generated scrambles are stored in IndexedDB alongside the tournament record.Resultados (Results) Enter individual solve times for each competitor in each round. The app automatically:
  • Applies +2 (+2 second) or DNF (Did Not Finish) penalties when flagged.
  • Calculates ao5 or ao3 averages for WCA-format rounds.
  • Advances qualifying competitors to the next round based on the configured cutoff.
  • Records match wins and advances bracket winners for Red Bull-format rounds.
Cronograma (Schedule) Set precise start times, end times, and room assignments for each category. The schedule is displayed on the public results view so competitors know when their events begin.
4

Publish Results

Navigate to Ver Resultados (View Results) — accessible from the tournament sidebar — to open the public-facing, responsive leaderboard. This page displays:
  • Final standings per category with solve times, averages, and rankings.
  • Round-by-round breakdowns for multi-round WCA events.
  • Bracket outcomes for Red Bull elimination events.
The results view is optimized for both desktop monitors and mobile devices, making it easy to display on a projector or share a device screen with spectators.When the competition is fully complete, use the Finalizar Torneo (Finalize Tournament) action from the tournament overview to transition the tournament to Finalizado status. This locks all data to read-only, preserving the official results permanently in IndexedDB.
Want to run ruTournament on your own machine without relying on a hosted URL? See the Installation guide for step-by-step instructions to clone the repository and start a local Vite development server with two commands.

Build docs developers (and LLMs) love