# The Dashboard, the phone and car mode

Andon has three ways to keep up with the board when you aren't at your desk. The **Dashboard** is a screen to leave
open on an iPad or a spare monitor: it answers "does anything need me?" from across the room. The **phone layout**
puts Needs you, the board, Start work, the chat and Activity under five tabs. **Car mode** reads out what needs you
while you drive and takes your answers by voice. **Settings → You** holds the options for all three.

## The Dashboard

Open it with **Dashboard** in the sidebar, or press `D` on the board. **Exit dashboard** (the × at the top right)
goes back to the screen you opened it from; opened from a link, it goes to the board (Needs you on a phone). On a
phone the Dashboard stays full screen, and **Back** at the top left does the same.

The Dashboard shows a lamp: three rings with a lit centre.

- **Quiet.** A green lamp, "All quiet.", how many agents are working, and a tile for each card with a run going (its
  state, how long it has run and its machine). Tap a tile to open the card. System notices, such as an overdue card in
  Working or a machine offline, are one quiet line linking to Needs you. They never light the lamp.
- **Calling.** When something needs you, the lamp turns amber and pulses. The page says "Andon is calling", how many
  need you, what kinds of item they are, and names the first. Under it are the next few items; tap one to start
  there.

The count is the same as the Needs you count in the sidebar. The top bar also shows the current cycle and its days
left when the team has cycles.

### Work through what needs you

When the lamp calls, you have three choices:

- **Start with the first** shows one item at a time: what it asks as the headline, the card under it, and its own
  actions as large buttons, with **Open card** and **Skip**. Swipe, or use ← and →, to move between items, and Esc to
  go back to the lamp. After each action, the page says what was done and how many are left: **Continue**, or
  **That's enough for now**.
- **See all** lists every item, each with its own actions and **Later**, which snoozes it for an hour. **Snooze the
  rest until tomorrow** snoozes them all until 8:00 tomorrow, for you only, after asking. Where voice is set up,
  **Talk me through them** starts car mode.
- **Not now** keeps the lamp amber and says "N waiting." until something new arrives.

A failure is the only thing shown in red.

### Leave it open

The Dashboard keeps the screen awake where the browser allows it, and says "Screen may sleep" where it can't. It
shifts a few pixels every few minutes to protect the screen. **Night dim**, under **Dashboard settings** (the sliders
button at the top), darkens the page and stills the pulse between two times; it is on from 22:00 to 07:00 by default
and is kept on this device. The Dashboard follows the app's light or dark theme.

## The phone layout

On a screen narrower than 640 px, or a touch screen 500 px tall or less (a phone on its side), Andon switches to
the phone layout. Five tabs run along the bottom:

| Tab | What it is |
| --- | --- |
| **Needs you** | the phone's home: everything waiting for you, with a count on the tab |
| **Board** | one column at a time |
| **Start work** | opens the Start work box over the tab you're on |
| **Chat** | the chat with Andon, full screen. Its pickers are under the line at the top |
| **Activity** | what happened on the cards you follow, with a quiet unread count |

The **Menu** button at the top left opens the same navigation as the desktop sidebar: Views, Teams, Roadmap,
Archive, Machines and the rest. The gear at the top right opens **Settings → You**.

On the **Board** tab:

- The column chips across the top pick a column; swipe left or right to move to the next one. The board opens on
  Working, or on the first column with cards when Working is empty.
- Long-press a card to drag it up or down within its column. To move it to another column, tap its **Move** button and
  pick one under **Move to…**.
- **Select** lets you tap cards to pick them; the selection bar above the tabs then moves, sets, runs or archives
  them.
- Swimlanes, when you've turned them on, show as team or project headings in the list.

A card you open stays under the header, which gains a **Back** button and shows the card's title. Tapping a tab also leaves the card.

Settings, Stats, Roadmap, Archive, a team's or a project's page, and a card opened from a link (`/card/WEB-11`) open
inside the same frame: the header shows **Back** and the page's name, and the tabs stay below. A card from a link
sits over the Board tab. **Back** returns to the screen before; when the page was opened from a link, it goes to
Needs you (the Board, for a card) instead of leaving Andon. Tapping a tab goes to that tab.

## Car mode

Car mode is a voice call for driving. The screen turns into a dark, glanceable view: what is being talked about, how
many decisions are left, and one large **End** button. Andon talks on its own: an opener at the start of the drive,
short briefings as things change, and a soft tone before anything that breaks in.

Car mode needs voice to be set up for your org, and a browser that can do voice.

### Start a drive

1. Tap the car button (**Start car mode**) in the round pill at the bottom right. On a phone, open the **Chat** tab and
   tap it beside the message box. On the Dashboard's **See all**
   list, **Talk me through them** does the same.
2. Say "what needs me" to go through the decisions one at a time.
3. Answer each with a short phrase: "yes", "no", "skip", "later", "tell me more", "repeat", "next" or "undo". Say
   "brief me" for a status update.
4. Say "end car mode", or tap **End**, to finish.

Anything that can't be undone, such as a merge, is read back first and needs "yes, confirm". Anything Andon can't
match to a phrase, or that you put off with "later", goes on a list for when you're parked. Each decision goes to
the audit log, and the drive ends with a written recap in the chat.

### Car mode options

In **Settings → You**, **Car mode** → **Options** sets, for this device:

- **Briefings**: every few minutes when something changed, as soon as something changes, or only at the start and end
  of a drive
- **Only things that need me**: leave out what finished or is still running
- **Quiet hours in the car**: no periodic briefings between two times
- what may break in between briefings: **A run asking a question or for permission**, **A failure on a card marked
  urgent**
- **Teams in a drive**: which teams a drive covers

A web page can't start car mode when the phone connects to the car, and it can't hear the phone's own calls or
navigation prompts.

## Settings → You

**Settings → You** holds what is yours alone:

| Row | What it does |
| --- | --- |
| **Email** | the address you sign in with |
| **Org** | switch org, when you belong to more than one |
| **Notify me when a run needs me** | push notifications for questions, permission requests and failures. **Turn on for this device** adds the device you're on (its browser's own push service: Chrome's, Firefox's, Safari's or Edge's); **Devices** picks, for each device, what it is told about (mentions, activity on cards you follow, failed runs and more) |
| **Quiet hours** | no pushes between two times, on every device of yours in this org |
| **Review pull requests GitHub asks me to review** | your machine reviews them and posts the findings as a comment in your name. It never approves, changes or merges someone else's pull request |
| **Sign-in** | **Manage** opens passkeys, an authenticator app and recovery codes |
| **Car mode** | **Options**, above |
| **Theme** | System, Light or Dark, on this device |
| **More** | the voice call language, and what machines may do for you from a chat |

**Sign out** is at the top of the page.
