Hover cardPro
Preview a person, agent or source on hover or focus: a short delay, a grace period while you travel into it, and a fast warm re-open.
oxyn add hover-cardReviewed by Owns the sandbox fleet and the agent permission model.
The preview stays free for everyone. Pro opens the code of every Pro component, screen, agent-app template, block and kit, plus the Pro CLI.
Rendered from Rust at build time · goes live when visible
When to use
- Preview a teammate, an agent or a cited source without leaving the transcript.
When not to use
- A small label for one control: use Tooltip instead.
- Cited sources under an answer: use Source cards instead.
- An app sidebar: use Sidebar instead.
Installation
Hover card is part of Oxyn Pro; the preview is free. Pro items install with the oxyn CLI once your licence is signed in; until then Pro members copy the code from this page.
oxyn add hover-cardUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Person
A person preview.
Reviewed by Owns the sandbox fleet and the agent permission model.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Agent
An agent with its identity ring (Oxyn plus).
Reviewed by Writes and fixes code in the Atlas repository. Asks before pushing.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Source
A citation source preview (Oxyn plus).
Reviewed by Defines a profile for issuing OAuth access tokens in JWT format…
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
HoverCard
| Prop | Type | Default | Description |
|---|---|---|---|
triggerrequired | String | — | Trigger text. |
profile | Option<Profile> | Default::default() | Person preview. |
source | Option<(String, String, String)> | Default::default() | Oxyn plus: a source preview (title, domain, snippet). |
side | String | "bottom" | `top` · `bottom` · `left` · `right`. |
align | String | "start" | `start` · `center` · `end`. |
open_delay | u64 | 500 | Open delay ms. |
close_delay | u64 | 140 | Close grace ms. |
open | bool | Default::default() | Start open (no focus moves; nothing covers the page). |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| Tab | Focus opens the card at once |
| Enter | Open without the delay |
| Escape | Close and stay closed while hovering |
Accessibility
- role=tooltip; the trigger gets aria-describedby while open.
- Focus never moves into the card.
From the spec
Focus never moves into the card (read-only content). aria-describedby only while open.
Motion & interaction
Grows from the trigger edge (0.96 → 1, 4 px) with a separate fade; warm opens fade only. Bio and stats settle in with a small stagger.
Timing
| Transition | Duration | Easing | Reduced motion |
|---|---|---|---|
| Open delay | 500 ms (80 warm) | — | same |
| Close grace | 140 ms | — | same |
| Grow | 220 ms | ease.out | fade 120 ms |
Responsive behaviour
- 18.5rem wide, capped to the viewport; taps toggle on touch.
Edge cases (spec)
Touch taps toggle. Long names ellipsize; stats wrap. Card width caps to the viewport minus 24 px.
Notes for AI
- Import
HoverCard,Profilefromoxyn_dioxusand includePRIMITIVES_CSSplus the token stylesheet once. - A GPUI version exists:
HoverCardElinoxyn_gpui. - Props to set first:
trigger. - Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.