Skip to content

Correct focus-suppression claims and document tips in Notifications docs#802

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
selfcontained merged 1 commit into from
Jul 20, 2026
Merged

Correct focus-suppression claims and document tips in Notifications docs #802

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 26 additions & 10 deletions apps/web/src/components/app/docs-sections/notifications.tsx
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -34,11 +34,13 @@ export function NotificationsContent() {
<H3>Browser notifications</H3>
<P>
Grant the browser permission, then toggle{" "}
<strong>Enable browser notifications</strong>. When the app is open in
at least one tab, matching events are delivered as native desktop or
mobile banners instead of Slack. If no tab is open to acknowledge the
notification within a few seconds, Dispatch falls back to Slack
automatically.
<strong>Enable browser notifications</strong> — the toggle stays
disabled until permission is granted. When the app is open in at least
one tab, matching events are delivered as native desktop or mobile
banners instead of Slack. If no tab acknowledges the notification
within about three seconds, Dispatch falls back to Slack
automatically. <strong>Send test</strong> fires a sample banner so you
can confirm the setup.
</P>
<P>
On iOS and iPadOS, notifications only work after installing Dispatch
Expand DownExpand Up@@ -78,15 +80,29 @@ export function NotificationsContent() {
</P>
</Section>

<Section>
<H3>Tips &amp; guidance</H3>
<P>
The same settings pane hosts <strong>Tips &amp; Guidance</strong> —
short contextual hints that point out features and link into these
docs. They're per-device like sound cues. Untick{" "}
<strong>Show tips</strong> to turn them off, or use{" "}
<strong>Reset dismissed tips</strong> to bring back everything you've
already dismissed.
</P>
</Section>

<Section>
<H3>Focus-aware suppression</H3>
<P>
Dispatch suppresses browser and Slack notifications for an agent
you're already looking at. Tabs that have an agent selected send
periodic focus heartbeats while the tab is visible and focused;
notifications for that agent are dropped until the heartbeat lapses (a
~30 second TTL after you switch tabs, change agents, or blur the
window). Sound cues are not filtered by focus.
you're already looking at. Tabs that have an agent selected send a
focus heartbeat every 15 seconds while the tab is visible and focused,
and notifications for that agent are dropped while it's live. Blurring
the window, hiding the tab, or switching agents clears focus
immediately, so notifications resume right away; the heartbeat also
expires on its own after 30 seconds if a tab goes away without
reporting. Sound cues are not filtered by focus.
</P>
</Section>

Expand Down
Loading