Skip to content

feat!: migrate Tooltip from Ariakit to Base UI - #1099

Draft
frankieyan wants to merge 1 commit into
mainfrom
frankie/baseui-tooltip
Draft

feat!: migrate Tooltip from Ariakit to Base UI#1099
frankieyan wants to merge 1 commit into
mainfrom
frankie/baseui-tooltip

Conversation

@frankieyan

@frankieyan frankieyan commented Jul 22, 2026

Copy link
Copy Markdown
Member

What

This is a spike to reimplement Tooltip with @base-ui/react instead of @ariakit/react.

Breaking changes

1. The ref type changed

Tooltip's ref exposed Ariakit's entire TooltipStore. It now exposes only two methods:

type TooltipHandle = { show(): void; hide(): void }

2. withArrow has been removed

This was broken in the existing implementation, so we won't be supporting it for now.

Behaviour changes

  • Clicking the trigger now dismisses the tooltip (Base UI's closeOnClick) while Ariakit kept it open.
  • The tooltip stays open when hovered, with a safe-polygon exit path. Ariakit closed on leaving the trigger.
  • Tooltips no longer open on touch devices. Base UI's trigger is mouseOnly.
  • TooltipProvider is now recommended at the app root. Without it, tooltips require the full delay when hovering from one trigger to the next.
  • We documented that aria-described by was applied, but this was behaviour implemented by a previous version of Ariakit, and no longer applies in the current version

Co-Authored-By: Claude <noreply@anthropic.com>
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.

1 participant