How do I install Background Overlay Card?

Run npx shadcn@latest add @aceternity/cards-demo-1 in your terminal. Before installing, add the Aceternity Pro registry to your components.json and set your API token as the ACETERNITY_PRO_TOKEN environment variable. The CLI automatically installs all required dependencies including Tailwind CSS plugins and Framer Motion.

Is Background Overlay Card responsive and accessible?

Yes. The component is fully responsive across mobile, tablet, and desktop breakpoints. It uses semantic HTML elements, proper heading hierarchy, and accessible color contrast ratios. Touch targets are appropriately sized for mobile interactions, and all interactive elements are keyboard-navigable.

Can I customize the colors, fonts, and layout?

Everything is built with Tailwind CSS utility classes and Framer Motion animations. You can change colors, spacing, typography, border radius, shadows, and animation timing directly in the JSX — no separate CSS files to manage. The component uses your project's Tailwind theme, so it automatically adapts to your design system.

What frameworks does this work with?

Background Overlay Card is built for React and Next.js (App Router and Pages Router). It requires Tailwind CSS v4 and Framer Motion. It works with any React-based framework including Remix, Gatsby, and Vite — just ensure Tailwind CSS and Framer Motion are configured in your project.

Cards

1 / 4

Background Overlay Card

A card with a static background image that swaps to an animated GIF on hover. Includes a dark overlay that appears during the hover state.

Background Overlays

This card is for some special elements, like displaying background gifs on hover only.

The card displays a static background image by default. On hover, the background-image property transitions to an animated GIF. A pseudo-element preloads the GIF using a before rule positioned off-screen, preventing the flash that would otherwise occur on first hover.

An after pseudo-element creates a semi-transparent black overlay on hover, fading in at 50% opacity. This improves text readability against the animated background. The transition duration is set to 500ms for smooth state changes.

Text content sits above both the background and overlay using relative positioning and z-index. The card has a fixed height with content aligned to the bottom using flexbox.

Good for creative portfolios, entertainment sites, gaming landing pages, and any design where you want surprise and delight on hover.

More from Cards

Included with All-Access

One payment unlocks the code for this block and every other block, template and page.

Get All-Access

Explore more

Content Card Feature Block Animated Card Expandable Card On Click Cards Hero Sections

About this block

Text content sits above both the background and overlay using relative positioning and z-index. The card has a fixed height with content aligned to the bottom using flexbox.

Good for creative portfolios, entertainment sites, gaming landing pages, and any design where you want surprise and delight on hover.