Velocity X Components

Heroes & Sections

Hero — Video Background

Full-bleed autoplaying muted video hero with a solid scrim and reduced-motion fallback to the poster frame.

Subscription Included with the Velocity Components subscription.
bash
$ velocityx add hero-video-background

Built for astro.

Full docs for Hero — Video Background →

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

astro v1.0.0
Hero — Video Background

Showreel

Motion-first brand storytelling

Autoplaying, muted, and reduced-motion safe — the scrim keeps copy readable regardless of footage.

Props

NameTypeRequiredDefaultDescription
eyebrowstringNo
titlestringYes
substringNo
headingLevel1 | 2 | 3 | 4 | 5 | 6Yes
primaryCta{ label: string; href: string }No
secondaryCta{ label: string; href: string }No
videoSrcstringNo
posterstringNo
classNamestringNo''

File this creates

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

text
components/velocity/hero-video-background/HeroVideoBackground.astro

Using the Hero — Video Background component

Install it with velocityx add hero-video-background. 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 Heroes & Sections.