Cards & Expandables
Media Cover Card
Image or video cover card locked to a fixed aspect ratio with a skeleton placeholder, so the cover never shifts the title or meta row as it loads — the fix for cover-card CLS in blog grids, galleries and video libraries.
$ velocityx add media-cover-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 Media Cover Card →
Needs a licence key —
subscribe here, then
velocityx loginonce.
Shipping the component library
6 min readEngineering
Props
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| coverType | 'image' | 'video' | No | 'image' | |
| src | string | Yes | image src, or video src | |
| poster | string | Yes | video poster (shown until playable) | |
| alt | string | No | '' | image alt text (ignored for video) |
| ratio | '16/9' | '4/3' | '1/1' | '3/4' | No | '16/9' | |
| title | string | Yes | ||
| href | string | Yes | wraps the title in a link | |
| meta | string[] | No | [] | rendered as a "·"-joined row |
| className | string | No | '' |
File this creates
The CLI writes this path into your project, relative to its root — nothing else moves.
components/velocity/media-cover-card/MediaCoverCard.jsxUsing the Media Cover Card component
Install it with velocityx add media-cover-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.
Related components
More from Cards & Expandables.
A stack of independent cards where opening one smoothly expands its detail and closes any other open card, while every card's summary stays legible whether open or closed. Height animates off the panel's real measured content, so there's never a layout jump.
reactThe loading shape for a grid of cards — media block, title line, sub line, sized to match real card dimensions so the grid doesn't shift when data arrives. Ships media, list and stat variants; static (not faster) under reduced motion and hidden from screen readers.
reactA directory entry — avatar, name, role, a short list of real tel/email/location contact methods, and one primary action. Built for a staff directory or "your account manager" block, not a hover-reveal bio tile.
reactCard that expands into a focused overlay on desktop and a draggable bottom sheet on mobile, with three snap points. Portal-rendered, focus-trapped, scroll-locked and reduced-motion aware.
react