Velocity X Components

Cards & Expandables

Link Preview Card

The shared-link unfurl people already expect from iMessage, Slack and Notion — thumbnail, favicon, source and description in one clickable card, dropped into any feed or share surface.

Subscription Included with the Velocity Components subscription.
bash
$ velocityx add link-preview-card

Built for react. Needs react already installed as a peer dependency. An Astro-only project needs @astrojs/react wired up first — this won't run on its own in plain Astro.

Full docs for Link Preview Card →

Needs a licence key — subscribe here, then velocityx loginonce.

react v1.0.1 react

Props

NameTypeRequiredDefaultDescription
hrefstringYesrequired, the link destination
sourcestringYeshostname shown next to the favicon
faviconstringYes16–64px icon src
thumbnailstringYes16:9 preview image, omitted renders no image row
titlestringYes
descriptionstringYes
classNamestringNo''

File this creates

The CLI writes this path into your project, relative to its root — nothing else moves.

text
components/velocity/link-preview-card/LinkPreviewCard.jsx

Using the Link Preview Card component

Install it with velocityx add link-preview-card. The CLI writes the source straight into your project — no runtime dependency, no registry lock-in, and it themes itself from the same primary-*/accent-* scale as the rest of the library.

More from Cards & Expandables.