Band sync

When two or more bandmates open the same setlist on stage, one of them becomes the leader and their song-changes broadcast to everyone else in real time. The leader hits next; everyone's screen advances. The leader claims a different song from the drawer; everyone follows.

It runs over a Cloudflare Durable Object — the same GIG_SYNC channel that carries metronome broadcast.

How leadership works

The first person to open a stage session for a setlist becomes the implicit leader. The Leader pill in the top strip shows your role: solid accent color = you're the leader, muted = you're a follower.

Any band member can claim leader at any time by tapping the Leader pill. The pill shows the connected member count next to it (default 1 if you're solo).

The leader pill also doubles as the sync status indicator: Wi-Fi icon when the connection is open, no-signal icon when it's closed.

[screenshot: Leader pill — solid + member count]

What gets broadcast

Always:

Sequential next/previous — when the leader swipes to the next or previous song, every follower advances.
Line pointer position (Follow mode only) — the active lyric line, so everyone's chart highlights the same line.
Leader handoff — when someone claims leader, the old leader gets demoted.
Metronome state — if the leader has broadcast click enabled (see Metronome on stage).

Configurable per band:

Drawer-jumps — when the leader jumps to an arbitrary song via the drawer (not a sequential next/prev), broadcast that jump. Controlled by the broadcastSetlistJumps band setting (default on). Turn off if you want the leader to be able to peek ahead without dragging everyone with them.

What stays local

Personal transpose — your screen only.
Font scale, hide chords — your screen only.
Autoscroll pause — your screen only.
Settings sheet open/closed — your screen only.

When sync feels off

If the leader's screen and a follower's screen aren't in step:

Check the Leader pill — is the connection actually open? (Wi-Fi icon vs no-signal.)
Check whether the leader was really the leader for that change, or if someone else briefly claimed it.
If a drawer-jump didn't broadcast, check broadcastSetlistJumps in Band settings.
Pull-to-refresh or close and re-open the stage view to force a reconnect.

See band-sync-issues for the full triage.

Single-song mode is unsynced

Stage sessions launched in single-song mode (from the song-detail page or the songs list) do NOT connect to GIG_SYNC — they're private practice sessions. See Single-song stage view.

What's next

Single-song stage view — what stage looks like when it's just you.
Metronome on stage — broadcast click rides the same channel.
Troubleshooting band sync — when something feels off.