The Lobby

Share the code, ready up and start the game from the lobby


The lobby is the waiting room. The host shares the code, players arrive and tap Ready, and the host starts the game.

The lobby with the share code card, QR code, setting pills, host buttons and the players list

What You See in the Lobby

Everyone, host and players, sees:

  • Session title — in the top bar
  • Share this code card — the 6-character code (tap to copy), the join link with a copy icon, and a Scan to join QR code. On a phone, tap the people icon in the top bar to open the same details in a Share Code sheet.
  • Setting pills — for example 10 Q, 20s, Medium and Leaderboard (or No Board if the live leaderboard is off)
  • Players — one card per person with their rank number, avatar and name, plus Ready, Not Ready or Left the session. The host's card has a Host tag. A header shows "N online · N/10 joined".

The code and link are copy-to-clipboard only. Tapping them shows "Join code copied to clipboard" or "Join link copied to clipboard", and you paste them into your messaging app.

Host Controls

Start Game

The host's Start Game button is only available when:

  • At least 2 people are connected (counting the host), and
  • Every connected player has tapped Ready

Until then, a dashed box shows Need at least 2 connected players or Waiting for all players to ready up.

When you tap Start Game:

The quiz is generated

The AI writes the questions. The host sees "Generating quiz questions..." and players see "Host is generating the quiz...". If it fails, you'll see "Couldn't create the quiz. Please try again." and stay in the lobby.

Game starts

Everyone sees "Starting Game...".

Countdown

A 3-2-1 countdown plays, then the first question appears.

Refresh the Player List

Tap the refresh icon next to Players to check who's still connected. Anyone who doesn't respond within a few seconds moves to a Disconnected section.

Remove a Player

Tap the X on a player's card, then confirm Remove Player?. They can join again with the code. You can only remove players before the game starts.

End the Session

Tap the red End Session button (or the back arrow) and confirm "End Session?". This ends the session for everyone and can't be undone. Players see "The host has ended this session."

Player Controls

As a player, you can:

  • Tap Ready — it's one-way, so you can't un-ready. You'll see "Waiting for the host to start the quiz..." and then "You are ready!".
  • Leave — tap the back arrow and confirm "Leave Session?". You'll be removed, and you can rejoin using the code.

Only the host can start the game, remove players or end the session.

Tips

  • Share the code early — send it while you're setting up so people can join in advance
  • Check the player count — make sure everyone you expect is in the list before you start
  • Remind players to tap Ready — the host can't start until they all have

Next Steps