MiHCM
navigation/@mihcm/ui·v0.21.0·stable

Link

Semantic navigation and reference primitive. Seven variants, safe external-link defaults, and tokenized Tailwind overrides. Universal across web and native.

ConfiguratorExamplesUsageAccessibilityApi

Use cases

  • Inline references inside prose.
  • Standalone navigation links in cards and empty states.
  • Product navigation links that should remain semantic anchors.
  • External links with safe browser defaults.

When NOT to use

  • For side effects such as save, delete, open modal, or submit → use Button.
  • For current-page breadcrumb labels → use BreadcrumbPage.

Variants

VariantUse when
inlineDefault prose link.
accentRare orange emphasis. Counts against the 10% accent layer.
mutedSecondary link in metadata or supporting copy.
foregroundStarts as body text and reveals interactivity on hover.
navNavigation links with optional data-active="true".
standaloneLink outside a sentence.
buttonAnchor that navigates but needs compact action styling.

Agent rules

  • Use Link for real navigation. Use Button for side effects.
  • Use external for external destinations; it adds target="_blank" and safe rel.
  • Use token classes only. Do not hardcode colors or arbitrary Tailwind visual values.
  • Normal links belong to the 30% supporting brand-blue layer. Use variant="accent" only for small emphasis.