A small floating callout anchored to a target with a directional pointer; ships in eight pointer positions.
Superseded by Tooltip
Superseded by Tooltip. The version suffix is gone, the four pointer booleans became a single
Placement enum, the leading placeholder and CTA moved into ⤷ AssetSlot and ⤷ ActionSlot, and the raster pointer and close image were replaced with a vector and a DS icon instance. Kept as a record of the assessment that drove the consolidation.In Context
Tooltips sit over a target element (tab, button, icon, card) with a pointer aimed at the thing they describe.
Live Preview
Header
Description goes here. This is the second sentence. The third sentence.
Next
Content
header
description
icon
cta
Placement
pointer
DS Health
Reusable
Partial
Covers the main in-product tooltip pattern across onboarding, tips, and nudges. But because 3 siblings exist for 3 skins, consumers have to hunt for the right one — the primitive is fragmented. C1
Self-contained
Warn
Surface, type, and spacing bind to
main/nudge/* + space/* tokens. But the pointer arrow is a raster image (4 rotated copies of one shape) and the leading icon is a gray placeholder circle, not a slot. C6Consistent
Warn
Component is named
Tooltip V2 — version suffixes don't belong in production DS names. Pointer direction is 4 separate booleans rather than one enum, letting consumers set nonsensical combinations (e.g. all 4 pointers on). C2Composable
Warn
No Figma Slot for leading icon or body content. CTAs are baked Button instances that re-implement pill padding rather than composing the Button component consistently across variants (one variant uses px-16 / py-12, another uses px-8 / py-6). C4
Behavior
| State | iOS | Android | Figma Property | Notes |
|---|---|---|---|---|
| Show / hide | Yes | Yes | Not annotated | Expected: fade + slight scale-in anchored on the pointer side. |
| Tap close (X) | Yes | Yes | Close layer | Dismiss icon is present in markup but not wired to a property or interaction. Contract should be explicit. |
| Tap outside | N/A | N/A | Not defined | Standard tooltip contract — tap-outside dismisses. Should be documented on the component. |
| Primary CTA | Yes | Yes | CTA=one / two | Advances in onboarding or performs the tip's primary action. |
| Secondary CTA | Yes | Yes | CTA=two | "Back" in onboarding; "Learn more" in tips. |
| Pressed / Focused | N/A | N/A | Not built | CTAs and close have no pressed/focused treatment on the tooltip component itself. Inner Button instances handle their own press, but close + the tooltip surface do not. |
2.0.0 — August 2026Major
Consolidated into Tooltip · node 6295:79647
Superseded by Tooltip —
ConsolidatedTooltip V2 was consolidated into the unified Tooltip set (node 6295:79647) alongside its two siblings. Verdict changed to Remove; open issues and recommendations cleared, since they are resolved on the successor.
Resolved1.0.0 — April 2026Major
Initial Assessment · node 70:14908
Verdict: Restructure — Consolidate 3 sibling Tooltip components; drop the
ArchitectureV2 suffix; replace 4 pointer booleans with one placement enum; replace raster pointer with vector; replace placeholder icon with a Figma Slot. OpenC1 — 3 siblings for 1 primitive — Tooltip V2, Onboarding - Tooltip, Tooltip Blurred and Transparent. Merge via
C1appearance enum. OpenC2 — Version suffix in name —
C2Tooltip V2 shouldn't exist in production; no V1 surfaces in the file. OpenC2 — Pointer is 4 booleans — Replace
C2pointerTop/Right/Bottom/Left with a single placement enum. OpenC4 — CTA padding drift — Same XSmall Button, three different paddings across variants. Normalize. Open
C4C5 — No dismiss/focus states — Close is decorative; Pressed / Focused / Lifecycle not modeled. Open
C5C6 — Raster pointer + placeholder icon — 4 raster images for the pointer; gray circle for the leading icon. Vector + slot. Open
C6C7 — Code Connect — Blocked on the architectural changes above. Open
C7Tokens ✓ — Surface / border / label / description / CTA colors all bound to
Praisemain/nudge/* and main/button/*. Spacing via space/*. Noted