Foundation

Surface

The base elevation primitive. Surface handles background, shadow, dark-mode overlay, and border — nothing else. Card, Dialog, Drawer, and Popover all build on top of this single foundation.

Variant Comparison
elevated

Background + shadow + dark overlay.

outlined

Background + border, no shadow.

filled

Background only, no border or shadow.

Elevation Scale (0–24)
25-level shadow system from Material Design 3. Toggle dark mode to see the overlay.
0
elevation
1
elevation
4
elevation
8
elevation
12
elevation
16
elevation
24
elevation
Radius Scale
radius="none"
radius="sm"
radius="md"
radius="lg"
radius="full"
Padding Scale
padding="none"
padding="xs"
padding="sm"
padding="md"
padding="lg"
Color Scoping
surfaceColor overrides the neutral scale within the surface, recoloring bg-surface, border-border, and all children that use neutral tokens.
primary

Neutral tokens remap to the primary scale.

accent

Neutral tokens remap to the accent scale.

info

Neutral tokens remap to the info scale.

success

Neutral tokens remap to the success scale.

Polymorphic Element
as="div"
as="section"
as="article"

SurfacesCardResponsive by default

Card is the core surface primitive.

One composable surface for dashboards, settings, profiles, analytics, action panels, and content groupings. Use one system and scale it cleanly from compact mobile layouts to spacious desktop views.

Quick Build Pattern

1. Card shell

2. Header + Content

3. Actions


minimalresponsivecomposable
Card System

Card At A Glance

Card gives you a compact API with broad visual range. You can move from simple structural containers to branded, expressive surfaces without changing architecture or adding custom one-off wrappers.

Visual Variants
4
outlined • elevated • filled • ghost
Shape + Depth
7 + 5
radius levels + shadow levels
Composition First
HeaderContentActions
Responsive Ready
1 → 2 → 12
mobile, tablet, desktop flow

Visual Modes

Variant Gallery

Keep the same content structure and switch visual tone by variant. This makes it easy to create hierarchy and emphasis in the interface while preserving consistency in spacing, composition, and behavior.

Outlined

Crisp and balanced
default

Elevated

Floating emphasis
high emphasis

Filled

Soft color grouping
grouping

Ghost

Structure only
layout helper

Surface Controls

Shape, Depth, and Density

Refine how a card feels by tuning only three dimensions: corner shape, elevation depth, and internal spacing density. These controls are enough to shift from technical and tight to soft and editorial.

Radius Scale
none
sm
md
lg
xl
2xl
full
Shadow Scale
shadow="none"
shadow="sm"
shadow="md"
shadow="lg"
shadow="xl"
Padding Density
padding="none"
padding="xs"
padding="sm"
padding="md"
padding="lg"

Composition

Composable Anatomy

Compose cards with predictable regions for title, body, and actions. This keeps the UX stable for users and fast for developers while still allowing rich, custom content inside each section.

Team Profile

AR
Alex Rivera

Product Design Lead

Design systems + product UX.

Design SystemsAccessibilityUX Strategy

Activity Stream

Shipped onboarding flow

2m ago

Updated marketing copy

11m ago

Payment webhook retry

38m ago

Invited 4 teammates

1h ago

Weekly KPI up 14%

3h ago

Breakpoint Demo

Responsive Real-World Layout

This example shows the same card ecosystem adapting across breakpoints: single-column flow on mobile, split panels on tablet, and dashboard-level composition on desktop with explicit grid spans.

Revenue Snapshot

$128,440

+18.2% MoM
Healthy

Pipeline Notes

  • Enterprise lead: security review.
  • Pilot extended to next quarter.
  • Pricing test B: +9%.

Quick Actions

Open analytics
Funnel, retention, A/B.
Invite collaborator
Role-based access.
Create campaign
Launch across channels.

Team Pulse

M
Maya posted release notes
4 updates shipped.
J
Jon closed QA cycle
Mobile + tablet QA clear.
N
Nora adjusted onboarding UX
Completion: 61% → 74%.
Quick Rules

Production Tips For Great Card UX

Use these practical defaults to keep card systems cleaner, more readable, and easier to scale. They help teams build faster without losing visual consistency or interaction quality.

Keep hierarchy consistent.

Align actions across sibling cards.

Use Grid spans for breakpoint control.

Prefer CardActionArea for clickables.