Skip to content

feat(browser): native tooltips on toolbar controls #60

Closed

Description

@trmosala

What to build

Browser toolbar and menu-trigger controls show native tooltips instead of OS title tooltips. Tooltips are placed so they never overlap the native page area. Hovering a control therefore never blanks the browser, even after the overlap-aware hiding from #42.

Acceptance criteria

  • Every browser toolbar control and browser menu trigger that currently relies on a title attribute shows a native tooltip with the same localized text.
  • No tooltip overlaps the native page area at any panel size. Hovering any control leaves the page visible.
  • Where a control has a browser shortcut, its tooltip shows the keybind hint in the native style.
  • Accessible names are unchanged, and no control shows both a title tooltip and a native tooltip.
  • Mounted UI coverage confirms that hovering toolbar controls does not hide the native page.
  • LTR and RTL both render correctly.
  • Scoped lint passes. Package typecheck passes where dependencies are installed.
  • Before/after screenshots are attached for each layout touched.

Blocked by

Context

Source: browser panel native-styling audit, 2 October 2026. Coordinate with ongoing browser changes in #37–#48. Operation, busy, error and recovery states belong to #43 and are out of scope. Another agent owns the tab-strip alignment; do not restyle the strip in this slice.

Activity

  1. added
    enhancementNew feature or request
    ready-for-agentScoped work with acceptance criteria and recorded blockers
    on Oct 2, 2026
  2. trmosala commented on Oct 2, 2026

    @trmosala
    OwnerAuthor

    Closing at the user's request after implementation and review.

    Toolbar, menu, accounts, Go, New tab and All tabs controls use native tooltips. Tooltips stay above the native viewport; 168 mounted hover checks passed across layouts, directions and widths.

    Validation: 18 tests pass with 514 assertions; app package typecheck passes; scoped lint reports 0 errors and 25 warnings; formatting and diff checks pass. Mounted Chromium fixtures cover both layouts, light/dark themes and LTR/RTL. They do not verify native Electron corners.

    Implementation remains uncommitted in the isolated browser-gaps worktree. Closure records completion of the local implementation, not a merge or release.

    Full screenshot and validation archive

    classic, light, ltr

    Before

    Before: landing, classic, light, ltr

    After

    After: landing, classic, light, ltr

    classic, dark, rtl

    Before

    Before: landing, classic, dark, rtl

    After

    After: landing, classic, dark, rtl

    new, light, ltr

    Before

    Before: landing, new, light, ltr

    After

    After: landing, new, light, ltr

    new, dark, rtl

    Before

    Before: landing, new, dark, rtl

    After

    After: landing, new, dark, rtl

    168 tooltip hover checks

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestready-for-agentScoped work with acceptance criteria and recorded blockers

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions