Skip to main content
Clever Ops

Hover Peek Link

Inline link that floats a structural preview card on hover or focus, title, description, and meta from props, with intent delay, close grace, and viewport-edge flip.

Preview & code

Loading Hover Peek Link preview

Installation

pnpm dlx shadcn@latest add @cleverui/hover-peek-link

Requires the @cleverui registry in your components.json, a one-off, two-line setup.

Usage

tsx
import { HoverPeekLink } from '@/components/ui/hover-peek-link'
Exampletsx
import { HoverPeekLink } from '@/components/ui/hover-peek-link'

export default function HoverPeekLinkDemo() {
  return (
    <div className="mx-auto max-w-2xl px-4 py-16 sm:px-6 sm:py-20">
      <p className="text-muted-foreground font-mono text-[11px] uppercase tracking-[0.2em] sm:text-xs">
        Field notes · Meridian design system
      </p>
      <h2 className="text-foreground mt-3 text-balance text-2xl font-semibold tracking-tight sm:text-3xl">
        How teams adopt the registry
      </h2>
      <div className="text-muted-foreground mt-6 space-y-5 text-base leading-relaxed sm:text-lg">
        <p>
          Most product teams start with the token layer, then wire a single
          marketing surface before expanding. The recommended path is documented
          in the{' '}
          <HoverPeekLink
            href="https://docs.cleverui.dev/guides/adoption"
            title="Adoption playbook"
            description="A staged path from tokens to production surfaces, includes checklist, role ownership, and the three-week pilot cadence used by Meridian."
            meta="docs.cleverui.dev · 6 min read"
          >
            adoption playbook
          </HoverPeekLink>
          , which walks through theme injection, registry install, and the first
          hero swap.
        </p>
        <p>
          When you need a deeper dive on motion, the{' '}
          <HoverPeekLink
            href="https://docs.cleverui.dev/motion/standards"
            title="Motion standards"
            description="Directed choreography for entrances, springs, and reduced-motion fallbacks. Copy these constants into self-contained components."
            meta="docs.cleverui.dev · 4 min read"
          >
            motion standards
          </HoverPeekLink>{' '}
          cover easing curves, stagger budgets, and when to drop a spring under{' '}
          <code className="text-foreground bg-muted rounded-md px-1.5 py-0.5 font-mono text-sm">
            prefers-reduced-motion
          </code>
          .
        </p>
        <p>
          Shipping a compare surface? Start from the neutral{' '}
          <HoverPeekLink
            href="https://docs.cleverui.dev/components/image-compare-frame"
            title="Compare Frame"
            description="A keyboard-first before/after slider for any two children, catalog-plate framing, no autoplay, no network imagery."
            meta="docs.cleverui.dev · Component"
          >
            Compare Frame
          </HoverPeekLink>{' '}
          rather than bolting photos onto a marketing block.
        </p>
      </div>
    </div>
  )
}

API reference

HoverPeekLink accepts the following props.

PropTypeDefaultDescription
href*string
children*React.ReactNode
title*stringpreview card heading
description*string1–2 sentence summary, clamped to two lines
metastringmono meta row, e.g. 'docs.cleverui.dev · 4 min read'
openDelaynumber350hover intent delay in ms before the peek opens; focus opens immediately

…plus everything from Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'href' | 'title'>: className, event handlers, aria attributes and the rest pass straight through.

Frequently asked questions

How do I install the Hover Peek Link component?

Register the @cleverui registry in your components.json ("@cleverui": "https://cleverops.com.au/r/{name}.json"), then run `npx shadcn@latest add @cleverui/hover-peek-link`. The shadcn CLI copies the source into your project, you own the code from that point. You can also copy the source directly from this page.

What dependencies does Hover Peek Link require?

Hover Peek Link uses motion on top of React and Tailwind CSS. You don't need to install it manually, the shadcn CLI resolves and installs npm dependencies automatically when you add the component.

Can I theme Hover Peek Link to match my brand?

Yes. The component is styled entirely with Tailwind utilities over standard design tokens (primary, background, muted, border), so it inherits your existing shadcn/ui theme automatically. Change your CSS variables and the component follows, no source edits needed for palette, radius, or fonts.

Want this built for you?

CleverUI is built by the Clever Ops web team. If you'd rather ship a hand-coded, fast, custom website than assemble one, we build them for Australian businesses every week.

Explore web development services