Customer Display
The customer display is a secondary screen (monitor or tablet) that shows the customer the current state of their order in real time. The display is read-only — the customer cannot perform any actions on it (except disconnecting with a triple tap).
The customer display is a secondary screen (monitor or tablet) that shows the customer the current state of their order in real time. The display is read-only — the customer cannot perform any actions on it (except disconnecting with a triple tap).
Registration and pairing
The customer display is registered under Settings > Venue > Registers using the + Customer display button. Each display receives a unique code for pairing with the register.
During pairing, a confirmation dialog appears on the main register (a full-screen overlay with a semi-transparent background). The dialog contains:
- A device icon (a TV icon for the customer display)
- The device name (or the code if no name is entered)
- The pairing code
- Reject and Confirm buttons
After confirmation, the display connects to the register and begins receiving data.
How it works
The display communicates with the register over a real-time channel (Supabase Broadcast) on the display:{pairing_code} channel. Data is transferred with a latency of roughly 100–300 ms. The display header always shows the current date and time (updated every second).
Display states
Idle state
When no transaction is in progress, the display shows a welcome message — in large bold type in the center of the screen, in the primary theme color. The welcome message can be customized (it is stored in the display's pairing settings). If no custom text is set, the default welcome message is shown.
Item view
While an order is being built, the display shows:
Header — a colored bar with the heading "Tab" (bold)
Item list (scrollable):
- Quantity and unit (e.g., "2 pcs") — on the left, fixed width
- Item name — the main text (large type)
- Modifiers — with a "+" prefix, each on a new line; the price is also shown for paid modifiers
- Notes — in italics, smaller type
- Discount — bold green, if applied to the item (shows the text "Discount" and the amount with a minus sign)
- Line total — on the right, in larger semibold type
Footer with the summary (gray background with a top border):
- Subtotal — large type
- Discount — shown in bold green only if the total discount is nonzero (with a negative sign)
- Divider line
- Total — in large bold type (headlineLarge)
The display updates instantly with every change — adding an item, changing a quantity, applying a discount.
Message
After a transaction is completed (or another action), a message may appear with a large icon and text in the center of the screen:
- Success (messageType "success") — a green checkmark icon
- Information (other types) — a blue "i" icon
The message hides automatically after the configured time, and the display returns to the idle state.
Disconnecting the display
A triple tap on the welcome message in the idle state (3 taps within 500 ms) disconnects the display from the register — it leaves the broadcast channel, deletes all pairing settings (code, type, company ID, welcome message), and redirects to the onboarding screen for new pairing.