Appearance
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
Step 1
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.
Step 2
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.
Step 3
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.
Source: gitbook/product/advisors/phones-and-notifications.md in the DutyGraph repository.