One badminton group, one link. Players book from WhatsApp, scan a QR at the door, and their phone tells them when they're next. The coordinator runs the whole night from one screen and stops being the person everybody asks "when am I playing?"
1. The five-minute version
Tuesday — organizer opens smashq.aiopsgroup.ai/admin, creates the session, copies the link, drops it in WhatsApp.
Tuesday to Saturday — players tap Join session. Once it's full, the next taps land on the waitlist. Somebody cancels, the top of the waitlist moves up automatically and nobody has to notice.
Saturday 6:50 PM — coordinator opens the QR code on a phone and props it at the door. Players scan as they walk in. The session goes live on the first scan.
Saturday 7:00 PM to 10:00 PM — coordinator opens the court board. For every free court it shows four players, already split into teams, with a line saying why those four. Tap Start game. When they're done, tap Finish game, type the score or skip it. That's the entire job.
Saturday 10:00 PM — tap Close session. You get the summary: games played, fairness score, who still owes money.
2. For players
Your account
Sign in with just your email — Sign in at the top. We send a four-digit code; type it and you're in. New here? The same code creates your account. No password, ever.
The first time, you'll pick the name other players know you by, and you can set a four-digit PIN for this phone. After that, signing in on this phone is just the PIN. On a new phone it's the email code once more. Five wrong PINs and the phone goes back to email — that's on purpose.
Everyone gets a player number, like #1047, shown on your profile. Give it to an organizer and they can invite you straight in.
Been playing on this phone without an account? Register on the same phone and your games, ratings and communities come with you. If that history isn't actually yours (a borrowed phone), tap That isn't me — start fresh on the welcome screen.
Your profile (tap your name at the top) shows every community you're in, what you are in each, and your record — overall and community by community. Only you see it all together.
Joining a community
Everything belongs to a community — one badminton crowd with its own venues, sessions, members and money. You only see the sessions of communities you've joined.
| You have… | What to do |
|---|---|
| An invitation in your app | It's on your profile — tap Join |
An invitation link (/i/…) |
Open it and tap Accept |
| The community's share link or 4-character code | Open the link, or type the code under Communities → Got a code? |
| Nothing, but it's a public community | Find it under Communities, then Join or Ask to join |
If the community approves new members by hand you'll see Request sent; once you're let in it appears on your profile and home screen.
Each community keeps its own rating for you, from games played there only. A community never sees your record from another one.
Want to help run your community? On your profile, under that community, tap Help run this community? — the request goes to its owner.
First time with the group
Open the link from WhatsApp and tap Pick your name. If you're already on the list, tap your name once and your phone remembers it from then on. There's no password and nothing to install.
If you're new, use New here? at the top: type your name, tap Add me, and you're on the list for good. A phone number is optional and only the organizer sees it — worth adding if someone else in the group shares your first name.
If the name you type already exists, the app won't create a second you. It shows the existing person and asks whether that's you. Say yes and you're signed in as them; say no by adding a surname or an initial. This matters more than it sounds: games played, the fairness score, ratings and history all hang off one record per person, and two records for the same player quietly breaks all four.
Turned up at the venue without booking? The QR code at the door has the same Add me box, so you can join the group and check in from the same screen.
Booking
Once the app knows who you are:
Then tap Join session.
- If there's space, you're confirmed straight away.
- If it's full, the button says Join waitlist and you'll see your number in the queue.
- Changed your mind? Cancel my slot. Do it early — it's what lets the next person in.
Booking also creates your fee record, so the coordinator can tick you off when you pay.
Checking in
At the venue there'll be a QR code on a phone or a printout by the door. Point your camera at it, tap your name, done. You're in the queue from that second.
If your phone is dead or the code won't scan, tell the coordinator — they can check you in by hand in two taps. You can also open the session link and tap I'm at the venue.
The QR code only works for tonight's session and only for 24 hours, so a screenshot from last week won't do anything.
During the session
Your session page is the answer to every question you'd normally ask the coordinator:
- Waiting with your place in the queue — "Next 1 to 2 games", "About 3 games away"
- Games you've played, Waiting how long you've been sitting, and how many people have had fewer games than you
- When you're picked, the screen switches to You're up with your court, your partner, and who you're against
The page refreshes itself every few seconds. You don't need to pull down.
Two buttons matter:
- Sit out a game — taking a break, getting a drink, phone call. You stay checked in and the engine skips you until you tap I'm back in. Sitting out also resets your back-to-back counter, so you're not penalised for resting.
- Heading home — you're leaving. Tap it before you go so the rotation adjusts for everyone still there.
Scores
Optional, always. If your group wants them, anyone in the game can add the score from the Games tab afterwards. Scores feed your win rate and your rating, so they're worth doing once the habit sticks.
Your fee
Your session page shows whether your fee is paid or pending. The coordinator marks it when you hand over the cash or send the transfer.
Your profile
Tap your name in the top right. Sessions attended, games played, win rate, recent form, your most frequent partner and opponent, and your rating.
Edit profile adds the rest, all optional: gender, year of birth, playing level (Beginner D, Intermediate C, Advanced B, Expert A), nationality, which hand you play with, and a phone number. Only you see it — except gender and level, which the organizers of a tournament see once you enter it. Gender and level are required before you can enter a tournament; if they're missing, the app takes you to fill them in and straight back.
Preferred partners are people you like to play with, added by player number. They appear as one-tap picks when you enter a doubles category. The list is private: nobody is told they're on it.
3. For the coordinator
Getting in
Two ways, and the fast one is deliberate.
The session PIN. Ask the organizer, type it once, and that phone stays unlocked. This covers the court board, check-in, payments and the QR code — everything you need with a game waiting. It is one short number because the alternative, mid-session on bad venue wifi, is you running the night on paper.
Or an account. Tap Sign in with email instead and you get a four-digit code and a link. Either signs you in; both expire in fifteen minutes and work once. Worth doing if you help out regularly, because it survives a PIN change.
Whichever you use, the screens are the same. If the board asks you to sign in and offers no PIN box, the owner has switched the shared PIN off for this community: sign in with your own account, and ask them for the coordinator role if you don't have it yet.
Before the first game
Open QR code from the session tabs and leave it on screen at the door. Check the Check-in tab now and then to see who's booked but hasn't arrived.
You can check anyone in manually from that tab, squeeze someone off the waitlist, or add a walk-in who never booked. All of it is one tap.
The court board
This is the screen you live on. Four numbers across the top: checked in, waiting, courts in use, and the fairness score. If that fairness number starts dropping, something has gone lopsided and you'll want to look at the Next players list.
Each court is either playing or open.
A playing court shows both teams and a running clock. When the game ends, tap Finish game. Type a score or tap Completed, no score — both are fine, and the engine doesn't care either way.
An open court shows the four players the engine picked, already split into Team A and Team B, with a short explanation underneath: who has the fewest games, who's been waiting longest, whether it's a fresh combination, how evenly matched the teams are.
Three buttons:
- Start game — you agree. Done.
- Switch teams — same four players, different pairing. Cycles through all three ways.
- Swap players — tap any player's name to drop them, then pick a replacement from the waiting list. Tap Reset to go back to the engine's suggestion.
You are never fighting the system. Whatever is on the card when you tap Start game is what gets played. If you changed it, that gets recorded quietly so you can look later at whether the engine keeps getting the same thing wrong.
Pairing preferences
Two people want to play together. Two people should probably not be on the same court tonight. Add either as a preference on the board — they last for this session only.
These are preferences, not rules. Fairness still wins: if honouring a "keep apart" would leave a court empty, the engine relaxes it and tells you it did.
Money
The Payments tab lists everyone with Cash, Transfer and Waive buttons. Tap one, it's recorded with your name and the time. The top of the page shows expected, collected and outstanding, and the unpaid names are listed so you can read them out once instead of chasing on WhatsApp for three days.
You can also log court hire, shuttles and anything else under Session costs to see whether the night actually broke even.
Closing the night
Tap Close session on the board. Finish or cancel any live games first — it'll tell you if something's still running.
Closing marks anyone who booked but never scanned in as a no-show, and takes you to the summary.
4. For the organizer
Creating a session
Organizer → New session. Name, date, start and end time, venue, number of courts, max players, fee, game type, points per game.
You get a short code and a link like smashq.aiopsgroup.ai/s/K4M2XP. That's what goes in
WhatsApp. The QR check-in code is generated from the same session automatically, and it
always points at whatever domain the app is served from — so it stays correct if the address
ever changes.
Game type is worth a thought:
| Type | What it does |
|---|---|
| Casual | Maximum mixing, teams only loosely balanced |
| Casual balanced | The default. Fair rotation, teams roughly even |
| Competitive | Ratings matter, teams matched as closely as possible |
| Social | Pushes hardest to avoid repeating the same four |
Fairness works identically in all four. The setting only changes how hard the engine pushes on team balance and on mixing people up.
Members
By default, anyone who opens the session link can add themselves to the group. That's the right setting for a WhatsApp group where the link only goes to people you know, and it means you're not the bottleneck on a Saturday evening. Duplicate names are refused, so nobody ends up with two records.
If you'd rather vet everyone, turn Anyone with the link can join off at the top of the Members page. New players then see "ask the organizer" instead of a sign-up box, and you add them by hand.
Names usually come straight out of the WhatsApp group. Add them under Members. Rating is optional — leave it at 1200 and it settles itself once scores start going in.
Roles: Player, Coordinator, Organizer, and they now decide real things.
| Role | Can reach |
|---|---|
| Player | Their own screens. No account, no password, nothing to forget. |
| Coordinator | Court board, check-in, payments, QR — with an account or the PIN |
| Organizer | All of the above, plus members, venues, fees, settings and statistics |
Anyone with the PIN can still run tonight's session. Nobody reaches the organizer screens without an account, whatever the PIN is.
Inviting people
Organizer → Members → Invite people has three ways in:
- Share a link. One link for the group chat. Whoever opens it signs in and joins the way your How people join setting says — straight in, or waiting for you. If it ends up somewhere it shouldn't, tap Replace the shareable code.
- By player number. For someone already on Smash Queue — ask for the number on their profile. The invitation waits in their app and they skip the queue. You're not told whose number it was; you'll see them when they accept.
- By email or as a link. For someone not on Smash Queue yet. Single-use, two weeks.
Owners can also pick a role when inviting — coordinator, organizer or co-owner. Unused invitations are listed underneath, with Withdraw.
Players without an account
Some people will never register. Members → Add someone without an account puts their name on the roster so they can be booked, checked in and put on court. If they later register on a phone they've been using as that name, their history comes with them.
Venues
Name, address, court count. Sessions pick a venue and inherit nothing else, so you can run three courts at one place and four at another without any fuss.
Money and statistics
The organizer dashboard shows sessions run, average attendance and total collected. Statistics gives you the group leaderboard — doubles Elo, win rate, recent form, and who plays with whom most often.
Changing the PIN
Organizer → Members → Group. Type a new 4 to 8 digit PIN and save. Nobody gets signed out: a coordinator who already unlocked their phone stays unlocked until they tap Lock.
Change it when a coordinator stops helping out, and change it from whatever you were given at setup. Assume it leaks eventually — it gets read out at venues and pasted into group chats — and treat it as tonight's door code rather than a password.
What it costs you if it does leak is bounded now: the PIN reaches the court board, check-in and payments for a session, and nothing that spans sessions. Your member list, fees, venues and the leaderboard need an account. Ten wrong guesses in an hour lock the PIN for everyone until the hour is up, so it can't be guessed at the door.
Switching it off. Owners can turn the shared PIN off entirely under Members → Shared coordinator PIN. Every phone that unlocked with it loses the board straight away, and your coordinators sign in with their own accounts. Switch it back on whenever you like.
Notifications
Me → Notifications → Turn on notifications. After that your phone buzzes when you're put on court, when a waitlist spot opens for you, when your community posts a notice or invites you, and on the day of a session you booked. On iPhone, add Smash Queue to your home screen first (Safari → Share → Add to Home Screen) and turn it on from there; Apple doesn't allow it from a normal Safari tab. Send a test checks it works.
4a. Owning a community
If you asked for a community and it was approved, you are its owner. The first time you open the organizer screens you'll see a short notice — read it, it matters:
- The community, its members and their records are yours.
- Smash Queue will not share your members' details with any other community, will not contact them about anything you didn't trigger, and has no access to your community — platform administrators can't add organizers, remove members or take it over.
- That also means there is no admin rescue. If you want a backup, make someone a co-owner under Members.
Only owners can:
- make someone an organizer, coordinator or co-owner (Members → the role next to each name),
- approve "Help run this community?" requests from members,
- choose whether the community is public — findable by any Smash Queue member, who can see when and where you play but never who — or private,
- delete the community: type its name to confirm. It disappears for everyone at once, any owner can restore it from their profile for 30 days, and after that it is erased for good.
The last owner can't be removed or demoted — appoint another owner first.
Starting a community
Profile → Start a community, or Communities → Start a community. Tell us the name, where and when you play.
Your first community is free and instant. It's created the moment you fill the form, you own it, and you can add venues, sessions and members straight away.
Want a second one? That goes to the platform for a quick look. Same form; the answer shows up on your profile, and when it's approved that community is yours in exactly the same way. Communities you've deleted don't count, so your first one is always on the house.
4b. For the platform admin
The platform admin approves new communities, and that is almost all. Open Platform from
your profile (or go to /hq):
- Start a community for someone — name, area, and the owner's player number (from their profile; they need an account first). They become its only owner and see the ownership notice when they next open the app. You get no access inside it. Enter your own number to start one you'll run yourself.
- Requests for a second community — everybody's first community is created without you, so these are people who already run one and want another. Approve or decline, with an optional note back.
- Totals — how many communities, members and sessions. Counts only; no names.
- Suspend — hides a community being used for something it shouldn't be, without touching anything inside it. Restore undoes it.
There is deliberately no way from here into any community.
4c. Tournaments
A community can host tournaments: announce one, take entries and fees, make the draws and record results, all in the app. Open Tournaments from the home page to see what's on.
Entering one
Open the tournament, pick a category and tap Enter. You need your gender and level on your profile first. Men's and women's categories check both players; mixed needs one man and one woman. For doubles, pick a preferred partner or type your partner's player number (it's on their profile). They get a request on their profile page and in Tournaments, and the entry only counts once they accept. Nobody can put your name down without you saying yes.
Some tournaments are for members only; others are open to every SmashQ player and listed publicly. Entering an open one doesn't make you a member of the host community, but its organizers do see your name and player number, because you entered.
The fee and how to pay it are on the tournament page. The organizer marks you paid. You can withdraw from Your entries until the draw is made.
Running one (organizers)
Organizer → Tournaments → New tournament. It starts as a draft only organizers see.
- Setup. Dates, venue, who can enter (members only or anyone), when entries close, and whether you confirm each entry or they're in straight away. Add how to pay and the rules.
- Categories. One per event: Men's Doubles A, Women's Doubles B, Mixed Open, Open Singles... Each has its own fee (per player or per pair), entry limit, format and scoring. Formats: groups then knockout (the usual), straight knockout, or round robin.
- Prizes. Cash, trophies, medals, vouchers or gifts, for winner, runner-up and third in each category, plus special awards like best newcomer.
- Publish. Your members get a notification. From here the tournament has its own link,
/t/CODE, to share anywhere. - Entries & fees. Confirm, waitlist or reject entries, and mark fees paid, waived or unpaid. When a confirmed entry drops out, the first on the waiting list moves up.
- Draws. Close entries, set seeds if you want (1 and 2 can only meet in the final; blank seeds go by rating in your community), then Make the draw. Groups are spread so the top seeds aren't together. After the groups, Draw the knockout takes the top teams from each group and keeps group-mates apart in the first round.
- Results. On the tournament page, every match has Enter result, for organizers and anyone running the court. Enter the game scores, or give a walkover. Winners move through the bracket on their own, and the page shows the winner, runner-up and thirds at the end.
- Finish marks the results final.
5. How the queue decides
Worth reading once, because somebody will ask you.
Games played is not a preference, it's a rule. Players are grouped by how many games they've had. The engine works from the bottom up: if everyone on 2 games fits on the court, they all go on. It only gets to choose when it reaches a group with more people in it than there are spots left.
Inside that group everyone has played the same number of games, so nobody is being jumped. Only then do the other four things get a say:
| What it means | |
|---|---|
| Waiting time | Longest sitting goes first |
| Rest | Played back-to-back? You drop down. Just walked off court? Four-minute breather before you're considered again |
| Fresh combinations | Avoids the same four people, weighted so last game matters more than five games ago |
| Team balance | Splits the chosen four into the two evenest pairs |
The effect over a real three-hour session: everyone ends within one game of everyone else, and average waiting time sits around seven minutes.
Someone arriving late gets priority until they catch up, but with the four-minute rest between games so they're not run into the ground. If they walk in an hour late they will finish the night behind — the clock, not the engine, is the limit there.
Why didn't I get picked? Almost always: you've had one more game than the people who did, or you came off court less than four minutes ago. Both are visible on your own screen.
6. Statuses, decoded
Booking
| Status | Meaning |
|---|---|
| Confirmed | You have a slot |
| Waitlisted | Full; you move up automatically when someone drops |
| Cancelled | You gave the slot back |
| No show | Booked, never scanned in. Recorded when the session closes |
During the session
| Status | Meaning |
|---|---|
| Available | In the queue |
| Playing | On court right now |
| Resting | Sitting out by choice; skipped until you come back |
| Left | Gone home; out of the rotation |
Payment
| Status | Meaning |
|---|---|
| Unpaid | Owes the fee |
| Paid | Cash, transfer or online, with a timestamp and who recorded it |
| Waived | No charge this time |
Fairness score
100% means everyone played exactly the same number of games. Above 88% is excellent, and in practice means a spread of one game. Below 70% means somebody got noticeably more court time than somebody else — look at the games-per-player bars in the summary to see who.
7. When things go sideways
Nobody can scan the QR. Check-in by hand from the Check-in tab. Two taps per player, and the session runs exactly the same.
A player's phone is dead all night. Fine. Nothing about the rotation depends on the player's phone — only the coordinator's screen matters. They just have to ask you when they're next, the old-fashioned way.
Someone has to leave mid-game. Tap Cancel on that court, then assign a fresh four. The cancelled game isn't counted for anyone.
Only three players free. The court card says so instead of suggesting a game. Someone resting can tap I'm back in, or you can check in a walk-in.
A game was finished by mistake. Fix the score from the Games tab. The game itself stays counted — which is the right call, since they did play it.
The wrong player got checked in. Mark them Gone in the check-in list. They leave the rotation immediately.
Somebody registered twice under slightly different names. The app blocks exact repeats, not "R Shankar" versus "Ravi Shankar". Deactivate the spare under Members and ask them to tap the original from now on.
The fairness score is dropping. Usually means a lot of people arrived late or several people are sitting out. Open Next players — the list is ordered exactly as the engine sees it, so the people at the top are the ones owed a game.
Two people keep getting drawn together. Add a Different games preference for them on the board. It lasts for tonight only.
The sign-in email hasn't arrived. Check spam first. If it still isn't there, the address may not be on the staff list — the form says "a code is on its way" to any address typed into it, deliberately, so that it cannot be used to work out who plays here. Ask the organizer to confirm the address on your member record.
The code says it didn't work. They expire in fifteen minutes and work once, so an older email in the thread will fail — use the newest. Five wrong tries kills that code for good; request a fresh one. And if you already tapped the link in that same email, the code from it is spent, because both are the same key.
You tapped the link and it signed you in, but the tab you were using is still asking. Mail apps often open links in their own built-in browser, which is not the browser you started in. Use the four-digit code instead — you type it where you already are.
You're locked out of the organizer screens entirely. The PIN will not get you in there by design. Somebody who still has organizer access can add or correct your email under Members. If nobody does, that is a job for whoever runs the deployment.
Quick reference
| I want to | Where |
|---|---|
| Join the group for the first time | Session link → Pick your name → New here? |
| Book a slot | Session link → Join session |
| Check in | Scan the QR, or Check-in tab |
| See when I'm next | Session link → Your status |
| Start or finish a game | Court board |
| Swap a player | Court board → Swap players |
| Take money | Payments tab |
| Add a walk-in | Check-in tab → Walk-in |
| Close the night | Court board → Close session |
| See the fairness score | Summary tab |
| Unlock the court board | Session PIN, or sign in with email |
| Sign in as staff | Session link → Sign in with email |
| Change the session PIN | Organizer → Members → Group |
| Switch the shared PIN off | Organizer → Members → Shared coordinator PIN (owner) |
| Turn on notifications | Me → Notifications |
| Create a session | Organizer → New session |
| Add a member | Organizer → Members |
| See the leaderboard | Organizer → Statistics |
| Report something broken | [email protected] |
| Open the app | smashq.aiopsgroup.ai |
Telling us something is wrong
Everything described here works and is tested. What has not happened yet is thirty people, one Saturday, and bad venue wifi all at once — so if something behaves oddly, it is worth reporting rather than working around. Mail [email protected] with what you were doing and roughly when, and it gets looked at.
The queue weights especially are expected to want tuning once a few real sessions have been played. If the rotation feels wrong to the people actually standing on court, that is the single most useful thing you can send.
Built and maintained by AIOps — vendor-independent forward deployed engineering for the GCC.