Link

Renders link text for URLs or app-owned actions. When href is present, the text is wrapped in an OSC 8 hyperlink for supporting terminals (iTerm2, Ghostty, Kitty, etc.).

Import

import { Link } from "silvery"

Props

LinkProps extends TextProps (excluding children).

Prop	Type	Default	Description
href	string	--	Optional OSC 8 URL; omit for an app-owned action
children	ReactNode	--	Link text content
color	string	"$fg-link"	Link text color
revealColor	string	"$fg-link-hover"	Brighter color used while hovered
underline	boolean	--	Explicit stable choice; otherwise underline appears on hover

All TextProps style props (bold, italic, etc.) are also accepted.

Usage

<Link href="https://example.com">Visit Example</Link>

// Internal link with custom handler
<Link
  href="app://node/abc123"
  onClick={(event) => {
    event.preventDefault()
    navigate("abc123")
  }}
>
  Internal Link
</Link>

// App-owned action with no OSC 8 destination
<Link onClick={() => navigateBack()}>
  Back
</Link>

Behavior

• Plain hover brightens the text with $fg-link-hover and adds an underline. An explicit underline value remains stable and overrides that default.
• Role still derives activation policy: a URL link opens on Cmd/Super-click; an action-only link delegates activation to its onClick handler.
• The onClick callback runs first. If it calls preventDefault(), it owns the activation; otherwise a revealed click emits "link:open" through the app event chain when href is present. An action-only Link with no href never emits "link:open" or paints an OSC 8 destination.

See Also

• Text -- base text component