Primitives

Card

Content surface for panels, tiles, and settings groups.

Pro plan

Everything you need to ship agents.

Popular

$29/mo

Billed monthly. Cancel anytime.

Composition

Panel anatomy

<Card>
- <CardHeader>
  - <CardTitle />
  - <CardDescription />
  - <CardAction />
  </CardHeader>
- <CardContent />
- <CardFooter />
</Card>

Installation

First install and activate one skin. Core deliberately contains no visual token defaults.

The Control UI source installs this primitive from src/registry/sources/control-ui/ui/card.tsx.

Registry command

npx shadcn@latest add https://control-ui.dev/r/card.json

See registry manifest

Raw code

Primary installed source

src/registry/sources/control-ui/ui/card.tsx

"use client";

import { useRender } from "@base-ui/react/use-render";

import type { ComponentProps, CSSProperties } from "react";

import type { RenderProp } from "@/components/control-ui/control-props";

import type { CardKnobStyle } from "@/components/control-ui/knob-contracts/card-knobs";

import { cn } from "@/components/control-ui/lib/cn";

export type CardVariant = "default" | "sectioned";

export type CardProps = Omit<ComponentProps<"div">, "style"> & { style?: CSSProperties & CardKnobStyle } & { variant?: CardVariant };

export type CardHeaderProps = ComponentProps<"div"> & { style?: CSSProperties & CardKnobStyle };

export type CardTitleProps = Omit<ComponentProps<"div">, "style"> & {

render?: RenderProp<ComponentProps<"div">>;

style?: CSSProperties & CardKnobStyle;

};

export type CardDescriptionProps = ComponentProps<"div"> & { style?: CSSProperties & CardKnobStyle };

export type CardActionProps = ComponentProps<"div"> & { style?: CSSProperties & CardKnobStyle };

export type CardContentProps = ComponentProps<"div"> & { style?: CSSProperties & CardKnobStyle };

export type CardFooterProps = ComponentProps<"div"> & { style?: CSSProperties & CardKnobStyle };

export function Card({ variant = "default", className, ...props }: CardProps) {

return (

<div

data-control-ui="card"

data-control-family="card"

data-slot="root"

data-surface="panel"

data-variant={variant}

className={cn("flex flex-col", className)}

{...props}

/>

);

}

export function CardHeader({ className, ...props }: CardHeaderProps) {

return (

<div

data-control-ui="card"

data-control-family="card"

data-slot="header"

      className={cn("grid auto-rows-min grid-rows-[auto_auto] items-start has-data-[slot=card-action]:grid-cols-[1fr_auto]", className)}

{...props}

/>

);

}

export function CardTitle({ render, ...props }: CardTitleProps) {

return useRender({

defaultTagName: "div",

render,

props: { ...props, "data-control-ui": "card", "data-control-family": "card", "data-slot": "title" },

});

}

export function CardDescription({ className, ...props }: CardDescriptionProps) {

  return <div data-control-ui="card" data-control-family="card" data-slot="description" className={className} {...props} />;

}

export function CardAction({ className, ...props }: CardActionProps) {

return (

<div

data-control-ui="card"

data-control-family="card"

data-slot="action"

className={cn("col-start-2 row-span-2 row-start-1 self-start justify-self-end", className)}

{...props}

/>

);

}

export function CardContent({ className, ...props }: CardContentProps) {

return <div data-control-ui="card" data-control-family="card" data-slot="content" className={className} {...props} />;

}

export function CardFooter({ className, ...props }: CardFooterProps) {

return (

<div

data-control-ui="card"

data-control-family="card"

data-slot="footer"

className={cn("flex items-center [.border-t]:pt-6", className)}

{...props}

/>

);

}

Knobs

Typed custom properties the recipe paints with. Set one on the root — style, a utility class, or a skin — and every slot inherits it.

--cui-card-* · 6 knobsHow the cascade resolves

--cui-card-radius<length-percentage>var(--radius-lg)

--cui-card-background<color>var(--card)

--cui-card-border-color<color>var(--border)

--cui-card-border-width<length>var(--control-rim-width)

--cui-card-shadow*var(--shadow-sm)

--cui-card-backdrop-filter*none