Welcome to SunCity Battle
SunCity Battle (SCB) is a web-based platform designed to manage breaking (breakdancing) championship events from start to finish â registration, brackets, judging, live scoring, and results.
This guide is written for everyone involved in a breaking event â whether you're an administrator setting up a championship, a judge scoring battles, a participant competing, or a spectator watching live results. No technical knowledge is required.
Roles on the Platform
đ
Admin / Organizer
Creates events, manages everything
âī¸
Judge
Scores battles and picks winners
đ¤
Participant
Registers and competes
đ
Spectator
Watches live results
The platform is available in English and Lithuanian. You can switch languages at any time using the language dropdown in the top navigation bar.
Getting Started
Accessing the Platform
Open your web browser (Chrome, Firefox, Safari, or Edge) and go to:
https://your-domain.com/
Bookmark this address for quick access on event day!
Creating an Account
- Click "Register" in the top-right corner of the navigation bar.
- Fill in your username, display name, email (required), and password. You can also add your crew name and country.
- Click the "Register" button to create your account.
- Check your email for a verification link â click it to verify your account.
- Log in with your new credentials.
The registration page â email is now required for account verification
A valid email address is required. You'll receive a verification link to confirm your account. Without verification, some features may be restricted.
Logging In
- Click "Login" in the top-right navigation.
- Enter your username and password.
- Click the "Login" button.
The login page
Understanding the Home Page
After logging in (or even as a guest), you'll see the home page listing all upcoming and current events.
The home page â your gateway to all events
From here you can:
- Browse available events
- Click an event to see details, categories, and register
- Access live battle views
- Switch between English and Lithuanian using the language dropdown
Navigation Bar
When logged in, the top navigation bar shows additional links:
- My Events â View your participation history across all events
- Your Name âž â A dropdown menu with links to My Profile, Change Password, and Logout
The navigation bar for logged-in users â access your profile and events from any page
Account Registration & Email Verification
Creating an account on SCB is quick and straightforward. Your account lets you register for events, track your participation history, and manage your profile.
Registration Form
The registration form includes the following fields:
- Username * â Your unique login name (cannot be changed later)
- Display Name â How your name appears on the platform (your dancer name / alias)
- Email * â Required for account verification and password recovery
- Password * and Confirm Password * â Choose a secure password
- Crew â Your crew name (optional)
- Country â Your country (optional)
Email Verification
After registering, you'll receive a verification email at the address you provided.
- Check your inbox (and spam/junk folder) for the verification email.
- Click the verification link in the email.
- Your account is now verified â you can log in and use all features.
If you don't receive the verification email within a few minutes, check your spam folder. Make sure you entered the correct email address during registration.
Your Profile
Your profile page lets you view and edit your personal information. Access it from the user dropdown menu in the navigation bar â My Profile, or go directly to /profile.
Your profile page â edit your personal information and see your events
Editable Fields
- Username â Displayed but cannot be changed
- Display Name â Your dancer alias / stage name
- Email â Your contact email
- Crew â Your crew affiliation
- Country â Your country
- Bio â A short description about yourself
Click "Save Changes" to update your profile.
Locked Fields (Active Events)
When you are registered in an event that is currently running (live), some profile fields may be locked to prevent changes that could affect your event registration. Locked fields appear grayed out and cannot be edited until the event is finished or archived.
Your profile page also shows a "My Events" summary at the bottom, listing your current and past event registrations with their status.
Change Password
Click the "Change Password" button in the top-right corner of your profile page to navigate to the password change form. See Password Management for details.
Password Management
Changing Your Password
To change your password while logged in:
- Go to your Profile page and click "Change Password", or navigate directly to
/profile/password. - Enter your current password.
- Enter your new password and confirm it.
- Click "Change Password" to save.
The change password form â accessible from your profile
Forgot Your Password?
If you've forgotten your password, you can reset it via email:
- Go to the Login page.
- Click the "Forgot Password?" link.
- Enter the email address associated with your account.
- Check your email for a password reset link.
- Click the link and set a new password.
The forgot password form â enter your email to receive a reset link
Make sure to use the same email address you registered with. The reset link is valid for a limited time.
Browsing Events
Click on any event from the home page to see its full details â date, location, categories, and registration status.
Event detail page with categories and registration information
From the event detail page you can:
- See all available categories and participant counts
- Register for categories (when registration is open)
- View brackets and results (when the event is running or finished)
- Access the live view for real-time battle updates
Registering for Events
How to Register
- Open the event you want to join.
- Click the "Register" button on the event page.
- Select the category you want to compete in (e.g., B-Boy, B-Girl, Crew).
- Fill in the registration form. If you're logged in, your details (dancer name, email, crew, country) will be pre-filled from your profile.
- Click "Submit Registration" to send your registration.
The event registration form â fields are pre-filled when you're logged in
Log in before registering! Your profile information will automatically fill the form, saving you time and reducing errors.
Already Registered?
If you've already registered for a category, the registration form will show which categories you're already signed up for. You won't be able to register for the same category twice.
Your registration may need to be approved by the event organizer before it's confirmed. Check your registration status on the event detail page or in My Events.
Registration Status
After registering, your status will be one of:
- Pending â Waiting for organizer approval
- Approved â You're confirmed for the event
- Rejected â Your registration was denied (e.g., category is full)
- Checked In â You've been marked as arrived on event day
My Events / Participation History
The My Events page shows your complete participation history across all events. Access it from the "My Events" link in the navigation bar.
My Events â track all your registrations and participation across events
For each event, you can see:
- Event name â with a link to the event detail page
- Event date and current status (Running, Finished, Archived)
- Categories you registered for
- Your dancer name used for that event
- Registration status â Approved, Checked In, etc.
- Bracket link â quick access to view your bracket placement
Use My Events to quickly check your status before event day, or to look back at your competition history.
Viewing Brackets & Results
Once an event starts and brackets are generated, you can view the tournament bracket to see match-ups and track progress.
The bracket view â see who faces who and follow the results
For real-time updates during battles, visit the Live page (click Live in the top navigation).
The live view â follow battles in real time
What to Expect on Battle Day
- Arrive early â you'll need to check in with the organizers.
- Check-in â the organizer will mark you as checked in on the platform. If you don't check in, you may be replaced or given a walkover (automatic loss).
- Watch the brackets â use your phone to follow the bracket page and see when your battle is coming up.
- Battle! â when your name is called, step up and compete.
- Results â scores appear on the platform shortly after each battle.
Live Viewing Guide
This section is for spectators, stakeholders, and anyone watching the event â in person or remotely.
How to Access the Live Page
- Open your browser on your phone or laptop.
- Go to
https://your-domain.com/live - Select the event you want to follow.
- No login required!
What the Displays Mean
- Current Battle â Shows who's battling right now. The battle card takes full width with large, easy-to-read names. A subtle background image adds atmosphere.
- Round Results â Green and red dots below each participant show round wins and losses at a glance. Round badges display dancer nicknames instead of generic "RED"/"BLUE" labels. Active round badges are highlighted in yellow with a white border and are slightly larger for visual emphasis, while completed/pending rounds appear in gray.
- Scores â As judges submit votes, you'll see the results appear.
- Auto Bracket â When no battles are currently live and a phase is running, the tournament bracket automatically displays using a responsive SVG that scales to fit any screen. Winners are marked with a green â checkmark. When a battle goes live, the bracket hides and the battle card appears.
- Phase indicator â Shows which stage of the tournament you're in (Top 16, Semifinal, etc.).
Projector Mode for Venue Screens
If you're setting up a display at the event venue:
- Open the live page on a laptop connected to a projector or TV.
- Click the "Projector Mode" or full-screen button.
- The display will auto-update as battles progress â no interaction needed.
The projector view is optimized for large screens:
- Slim info bar fixed at the bottom of the screen for a clean look.
- Bracket auto-displays between battles â no manual switching.
- Projector language can be set independently by the admin.
Connect the laptop to the venue's WiFi network. The live page updates automatically â just set it and forget it.
Frequently Asked Questions
Go to the Login page and click "Forgot Password?". Enter the email address you registered with, and you'll receive a reset link. You can also change your password from your Profile â Change Password page while logged in.
Yes! You can register for as many categories as the event offers (e.g., Solo BBoy and 2v2 Crew). Just submit a separate registration for each category.
The platform has an automatic tiebreaker system. When judges vote equally (a tie), the system creates an extra tiebreaker round. All judges see a confirmation modal, and once everyone confirms, they vote on the tiebreaker round. If the tiebreaker also ties, another one is created automatically. The admin sees a âī¸ badge indicating tiebreaker rounds. See the Tiebreaker System section for details.
No. Once a judge submits their vote or score, it is final. This ensures fairness and integrity. Double-check your decision before clicking submit.
Go to Admin â your event â Scores. Click the "Export Results" button to download a file with all battle results, scores, and rankings.
Projector mode displays the current battle in a large, easy-to-read format â participant names, round results, and live scores. Between battles, the tournament bracket automatically appears. A slim info bar sits at the bottom of the screen. The projector language can be set independently from the admin panel. It's designed for big screens at event venues.
Yes. Any user with the Superadmin or Organizer role can manage any event. You can have multiple people helping run the event from different devices.
The platform runs on the local network (your-server), so it works even without internet as long as all devices are on the same WiFi/LAN. If a device disconnects temporarily, refresh the page once connectivity is restored.
We recommend 3 or 5 judges per category. Using an odd number prevents ties in vote mode. For larger events or finals, 5 judges adds more credibility.
Yes, the platform supports multiple simultaneous events. Each event has its own set of categories, participants, judges, and brackets. Just make sure you have enough judges for all active events.
Click the language dropdown (showing "EN" or "LT") in the top navigation bar. Select your preferred language. The entire interface will switch immediately.
No! The live page and bracket views are fully public. Just share the link and anyone can follow the event â no registration needed.
A BYE means a participant advances to the next round without battling. This happens when the number of participants isn't a perfect power of 2 (e.g., 12 participants in a Top 16 bracket â 4 participants get a BYE in the first round).
You can edit basic event details (name, description, location) at any time. However, be careful about changing categories or phases after battles have started, as this may cause data inconsistencies.
SCB works on any device with a modern web browser â phones, tablets, laptops, desktop computers. The interface is responsive and adjusts to your screen size. We recommend Chrome, Firefox, Safari, or Edge.
Go to Admin â your event â Participants. Click the "Import CSV" button. Your CSV file should have columns for participant name and category. Follow the on-screen template for the correct format.
The lock screen is a dark overlay that appears when you first open a battle. It prevents accidental votes while you're watching performers. Tap "Unlock" when you're ready to score, and use the đ icon in the header to re-lock between rounds.
No. Judge notes are saved only in your browser's local storage. They are never sent to the server and are completely private. Note: clearing your browser data will erase them.
This means your login session has ended. The page will automatically refresh after 3 seconds. Simply log in again. Judge sessions last 24 hours, so this is rare during a single event day.
The âī¸ badge with a +N number indicates that tiebreaker rounds have been added to the battle. For example, âī¸ +1 means one extra tiebreaker round was created due to a tied vote.
Glossary
Key terms used throughout the platform:
| Battle | A head-to-head competition between two participants (or crews). The core unit of a breaking championship. |
| Bracket | The tournament tree showing all match-ups and how winners progress through phases to the final. |
| BYE | When a participant automatically advances to the next round without battling, usually because there's an uneven number of competitors. |
| Category | A competition division within an event (e.g., Solo BBoy, Solo BGirl, 2v2 Crew). |
| Check-in | Confirming that a registered participant has arrived at the venue and is ready to compete. |
| Cypher | A preliminary round where dancers perform in a circle. Judges observe and select who advances to the bracket stage. |
| Event | A complete championship or competition â the top-level container for categories, participants, and battles. |
| Heat | A group of battles within a phase that happen at the same stage of competition. |
| Phase | A stage of the tournament (e.g., Top 16, Quarterfinals, Semifinal, Final). Each phase has its own bracket and settings. |
| Round | One turn for each participant within a single battle (e.g., "3 rounds" means each dancer goes 3 times). |
| Seed | A ranking given to participants before the bracket is generated, ensuring top-ranked dancers don't face each other in early rounds. |
| Walkover | An automatic win given when the opponent doesn't show up, withdraws, or is disqualified. |
| Vote Mode | A judging mode where each judge simply picks a winner â no detailed scoring. |
| Criteria Mode | A judging mode where judges rate participants on customizable criteria. Defaults: technique, originality, musicality, execution, battle. Admins can change criteria and score range per category. |
| Head Judge | A designated lead judge who may have tiebreaking power or additional authority. |
| Projector Mode | A special full-screen display view designed for big screens at the event venue. |
| Tiebreaker | An extra round automatically created when judges' votes result in a tie. All judges must confirm before the tiebreaker round activates. |
| Lock Screen | A dark overlay on the judge's battle page that prevents accidental interactions. Tap "Unlock" to score, and đ to re-lock. |
| Judge Notes | A personal notes area on the judge page, saved locally in the browser. Not visible to anyone else. |
| Score Audit | A detailed admin view showing each judge's vote with dancer nicknames, color badges, and comments. |
| Flash Message | A temporary notification banner shown after admin actions (e.g., saving settings) that disappears on the next page load. |