Card Flip
Card that flips in 3D between a front and back face. Install Card Flip from the VLLNT UI registry with the shadcn CLI.
Card that flips in 3D between a front and back face. Part of the utility family in VLLNT UI, it ships as a machine-readable registry entry — copy the source directly into your app with the shadcn CLI and own it, no runtime dependency on a component library.
Preview
Switch between light and dark to inspect the embedded Storybook preview.
Installation
Add Card Flip to your project with the shadcn CLI. The source lands in your codebase, ready to adapt:
pnpm dlx shadcn@latest add https://ui.vllnt.ai/r/card-flip.jsonSource
"use client";
import * as React from "react";
import { cn } from "../../lib/utils";
/** Props for {@link CardFlip}. */
export type CardFlipProps = React.ComponentPropsWithoutRef<"div"> & {
/** Content shown on the back face. */
back: React.ReactNode;
/** Whether hovering flips the card. Click toggles when disabled. Defaults to `true`. */
flipOnHover?: boolean;
/** Content shown on the front face. */
front: React.ReactNode;
};
function Inner({
back,
flipOnHover,
flipped,
front,
}: {
back: React.ReactNode;
flipOnHover: boolean;
flipped: boolean;
front: React.ReactNode;
}) {
return (
<div
className={cn(
"relative h-full min-h-40 transition-transform duration-500 [transform-style:preserve-3d] motion-reduce:transition-none",
flipOnHover && "group-hover:[transform:rotateY(180deg)]",
!flipOnHover && flipped && "[transform:rotateY(180deg)]",
)}
>
<div className="absolute inset-0 [backface-visibility:hidden]">
{front}
</div>
<div className="absolute inset-0 [backface-visibility:hidden] [transform:rotateY(180deg)]">
{back}
</div>
</div>
);
}
/**
* Card that flips in 3D between a front and a back face on hover or click.
*
* Respects `prefers-reduced-motion`: the flip happens without a transition.
*
* @example
* ```tsx
* <CardFlip front={<p>Front</p>} back={<p>Back</p>} />
* ```
*/
export const CardFlip = ({
back,
className,
flipOnHover = true,
front,
ref,
...props
}: CardFlipProps & { ref?: React.Ref<HTMLDivElement> }) => {
const [flipped, setFlipped] = React.useState(false);
const base = cn(
"relative min-h-40 [perspective:1000px]",
flipOnHover && "group",
className,
);
if (flipOnHover) {
return (
<div className={base} ref={ref} {...props}>
<Inner back={back} flipOnHover={true} flipped={flipped} front={front} />
</div>
);
}
return (
<div
className={base}
onClick={() => {
setFlipped((current) => !current);
}}
onKeyDown={(event) => {
if (event.key === "Enter" || event.key === " ") {
event.preventDefault();
setFlipped((current) => !current);
}
}}
ref={ref}
role="button"
tabIndex={0}
{...props}
>
<Inner back={back} flipOnHover={false} flipped={flipped} front={front} />
</div>
);
};
CardFlip.displayName = "CardFlip";
Stories
Explore every variant and state in the interactive Storybook:
Preview
Switch between light and dark to inspect the embedded Storybook preview.