Skip to content

[Feature]: Make mobile pairing easy to find in Control UI #100154

Description

@steipete

Summary

Make mobile-device pairing easy to discover from the Control UI's primary navigation and Quick Settings.

Problem to solve

The pairing flow added in #94672 is currently available only inside the Devices card on the Nodes page. That card sits below the longer execution-approval and binding controls, so users can reasonably search Settings and the main UI without finding it.

Proposed solution

  • Add a subtle phone action to the persistent lower-left sidebar footer.
  • Add a clear Mobile app row to Quick Settings.
  • Open the same app-level QR setup dialog from the sidebar, Quick Settings, and existing Nodes action.
  • Keep pending pairing-request feedback live while the dialog is open.

Alternatives considered

  • Move the existing Devices card higher on Nodes: improves one page but remains undiscoverable from the main UI and Settings.
  • Add only a Settings link: better searchability, but pairing is an infrequent global action that also benefits from a persistent, compact shortcut.

Impact

Affected: operators connecting the iOS app or another mobile client.

Severity: medium usability issue; the supported flow exists but is difficult to locate.

Frequency: every first-time mobile setup.

Consequence: users assume web pairing is unsupported or require documentation/support to find the Nodes card.

Evidence/examples

The original feature is #94672. Current source and rendered-UI inspection confirm the only trigger is inside the Devices card on Nodes, below unrelated controls.

Additional information

The action still requires administrator access and uses the existing device.pair.setupCode Gateway method.

Metadata

Metadata

Assignees

Labels

P2Normal backlog priority with limited blast radius.clawsweeper:fix-shape-clearClawSweeper found a clear likely implementation shape for this issue.clawsweeper:linked-pr-openClawSweeper found an open linked pull request for this issue.clawsweeper:needs-maintainer-reviewClawSweeper marked this issue as needing maintainer review before automation.clawsweeper:needs-product-decisionClawSweeper marked this issue as needing a product or behavior decision.clawsweeper:no-new-fix-prClawSweeper does not recommend queueing a new automated fix PR for this issue.clawsweeper:source-reproClawSweeper found a high-confidence source-level issue reproduction.enhancementNew feature or requestimpact:auth-providerAuth, provider routing, model choice, or SecretRef resolution may break.impact:ux-frictionUser-facing flow adds avoidable confusion or support burden without fully blocking progress.issue-rating: 🦞 diamond lobsterVery strong issue quality with high-confidence source-level or clear reproduction.maintainerMaintainer-authored PRmaturity:stableIssue affects a taxonomy feature currently scored M4/M5.

Type

No type

Fields

Priority

None yet

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions