Skip to content

Add inline subtitles to menu items and field descriptions#276

Merged
wpfleger96 merged 2 commits into
mainfrom
sprout-ux/menu-tooltips
Apr 10, 2026
Merged

Add inline subtitles to menu items and field descriptions#276
wpfleger96 merged 2 commits into
mainfrom
sprout-ux/menu-tooltips

Conversation

@wpfleger96

@wpfleger96 wpfleger96 commented Apr 8, 2026

Copy link
Copy Markdown
Collaborator

This PR adds inline subtitle text to dropdown menu items and descriptive helper text to advanced dialog fields, making the agents UI more discoverable.

The agents screen had no contextual help — actions like "Mint token", "Spawn", and "Deploy" gave no hint of what they did. Advanced fields in the create-agent dialog (relay_url, ACP command, MCP command, turn timeout) had no descriptions. HTML title attributes don't render in Tauri's WKWebView, so a visible approach was needed.

  • Add a muted subtitle <span> below each action label in AgentActionsMenu (ManagedAgentRow.tsx), PersonasSection.tsx, and TeamsSection.tsx — always visible, works with keyboard nav, no Radix portal conflicts
  • Add inline <p> description text below advanced setup fields in CreateAgentDialogSections.tsx
  • Wire aria-describedby on all form inputs linking to their helper text for screen reader accessibility
  • Strip literal backtick characters from JSX help strings (rendered as plain text in the browser, not markdown)

@wpfleger96 wpfleger96 requested a review from wesbillman as a code owner April 8, 2026 22:29
@wpfleger96 wpfleger96 changed the title Add hover tooltips to agent menu items and dialog fields Add inline subtitles to menu items and field descriptions Apr 8, 2026
Dropdown items in the agents screen gave no hint about what they did,
making the interface opaque for new users and reducing accessibility for
screen reader users relying on title text. Advanced dialog fields also
had no descriptions, leaving users to guess what Relay URL, ACP command,
MCP command, and turn timeout actually control.

Radix DropdownMenuItem doesn't support Radix Tooltip natively (portal
layering conflicts), so title attributes are used on all dropdown items
as a lightweight, reliable fallback that works without any Radix portal
workaround. Tooltip components were already in place for icon-only
buttons in these sections.
HTML title attributes don't render in Tauri's WKWebView, making
dropdown tooltips invisible. Switch to two-line menu items with
muted subtitle text. Also add aria-describedby links for helper
text and strip literal backtick characters from JSX strings.
@wpfleger96 wpfleger96 force-pushed the sprout-ux/menu-tooltips branch from aca61d8 to 860d965 Compare April 9, 2026 20:12
@wpfleger96 wpfleger96 merged commit a791566 into main Apr 10, 2026
9 checks passed
@wpfleger96 wpfleger96 deleted the sprout-ux/menu-tooltips branch April 10, 2026 01:15
@wesbillman

Copy link
Copy Markdown
Collaborator

@wpfleger96 just a heads up, I reverted the menu items subtitls, they were a bit too noisy
Screenshot 2026-04-10 at 9 32 57 AM

PR: #289

tlongwell-block added a commit that referenced this pull request Apr 11, 2026
…ona-migration

* origin/main:
  feat(desktop): add Pulse social notes surface (#296)
  Fix flaky desktop smoke tests (#294)
  Add agent lifecycle controls to channel members sidebar (#291)
  Update nest_agents.md tagging info (#292)
  feat: add Sprout nest — persistent agent workspace at ~/.sprout (#290)
  Fix auth and SSRF vulns (#261)
  Add per-agent MCP toolset configuration to agent setup (#279)
  feat(desktop): team & persona import/edit flows (#288)
  Remove menu item subtitles and fix persona card overflow (#289)
  feat: Phase 1 video upload support (Blossom-compliant-ish) (#285)
  Add inline subtitles to menu items and field descriptions (#276)
  Improve ephemeral channel affordances and hide archived sidebar rows (#286)
  Fix @mention search to use word-boundary prefix matching (#278)
  Allow bot owners to remove their agents from any channel (#284)
  [codex] Polish agent selectors and settings layout (#283)

# Conflicts:
#	desktop/scripts/check-file-sizes.mjs
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants