---
url: /handbook/advisors/phones-and-notifications.md
description: >-
  What changes at phone width, how advisors get phone notifications, how to
  share private links, and where the Companion phone app stands.
---

# Phones and notifications

An advisor can run most of an engagement from a phone. Every advisor page works at phone width, phone notifications tell the advisor when something comes back, and **Share…** sends private links from the phone's share sheet.

## What changes at phone width

The desktop layout does not change. Below 760 pixels wide:

* A **bottom tab bar** replaces the left rail: Home, Inbox, Companies and the current company's Overview.
* The **company sidebar** becomes a drawer, opened by the menu button in the header.
* The **Next** action becomes a small indicator beside search, such as "4 to review" or "Follow up". It runs the same action. The Inbox tab's badge is the notification.
* **Tabs** scroll sideways. Long names get short ones, for example Opportunities shows Team, Agents, Constraints and Changes.
* The **Overview** opens on a row of quick actions: **Ask DutyGraph Agent**, waiting answers, section jumps, Work Map, Opportunities, Agent requests (when governance is set up) and **Send an ask**.
* **Tables become cards**, and long pages fold behind disclosures.
* The **Repo** opens a file full screen with a back bar. DutyGraph Agent opens as a sheet.
* An **approver** gets a slim bar with the three decisions.
* The **Inbox** groups cards as Fix, Review, Decide, Send / Chase and New leads.

Between 760 and 1,279 pixels, the company sidebar collapses to icons.

The pages that clients and team members open from a private link, such as the sponsor packet, team asks, the proposal and the agent plan, are built for a phone first.

## Phone notifications for advisors

DutyGraph can send web push notifications to an advisor's phone or computer. A notification shows the company and what happened, for example "`<company>`: sponsor package returned". It never shows answers, people's words or a link to send. Tapping it opens the Inbox.

Notifications cover the same events as the advisor's email notices: a returned sponsor package, a team answer, an answer to an agent plan and the other Inbox items.

### Turn them on

### Check the server

The server operator must set the push keys first. Without them, the panel says notifications are not set up on the server. Email notices and the Inbox still work.

### On an iPhone or iPad, add DutyGraph to the Home Screen

In Safari, tap Share, then **Add to Home Screen**. Open DutyGraph from the Home Screen. This needs iOS 16.4 or later.

### Turn them on

Open **Settings › Workspace › Phone notifications** and select **Turn on notifications on this phone**. The first time you open Home or the Inbox on a phone, a card also offers **Get notified on this phone**.

The panel lists each device that has notifications on, and can send a test or remove a device. If the browser blocked notifications, the panel says how to allow them.

::: warning
Notifications were tested with a mocked push sender. Delivery through a real browser push service has not been tested yet.
:::

## Share… on private links

When email is not set up, or the advisor prefers to send it themselves, DutyGraph creates a private link. **Share…** sends it:

* On a phone, **Share…** opens the system share sheet: Messages, Mail and other apps.
* Where the browser has no share sheet, it offers **Copy link**, **Email** and **Text message**.
* **Share…** sends nothing itself. The advisor chooses where the link goes.

**Share…** is on the private links in the Discovery composer (first touch and team questions), on the kickoff pre-read links and in the Companies outreach composer. In the team composer, **Create links for all (N)** creates every waiting person's link at once, each with **Share…** and **Copy**, plus **Copy all**. Each link is shown once.

## The Companion phone app

The Companion is a separate phone app for team members, not for advisors. It lets a person answer work questions and check Task Cards on their phone. This repository holds its server side: the phone API, not the app itself.

* A team member connects by scanning a QR code or opening an app link from their private invitation. Connecting uses up that invitation, so the browser link then closes.
* The phone gets its own session. DutyGraph stores the session and refresh tokens only as hashes.
* Leadership, first-touch, setup, company-picture and proposal links always open in the browser, never in the app.
* The advisor sees each person's connected phones in team discovery and can revoke one. Closing the account also revokes them.
* Push to team members' phones is off unless the server turns it on.

::: info
**Status.** **Built**: phone layouts on every advisor page, advisor web push (off until the server has push keys), **Share…** and **Create links for all**, and the Companion phone API with connected-phone revoke. The Companion app is a separate app outside this repository; testing it on physical devices is not recorded here. **Planned**: an advisor phone app, a sponsor role in the Companion, and a way to reconnect a phone without a new invitation.
:::
