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
Background + border, no shadow.
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.Radius Scale
Padding Scale
Color Scoping
surfaceColor overrides the neutral scale within the surface, recoloring bg-surface, border-border, and all children that use neutral tokens.Polymorphic Element
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
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 • ghostShape + Depth
7 + 5
radius levels + shadow levelsComposition First
Responsive Ready
1 → 2 → 12
mobile, tablet, desktop flowVariant 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
Elevated
Filled
Ghost
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
Shadow Scale
Padding Density
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
Alex Rivera
Product Design Lead
Design systems + product UX.
Activity Stream
Shipped onboarding flow
2m agoUpdated marketing copy
11m agoPayment webhook retry
38m agoInvited 4 teammates
1h agoWeekly KPI up 14%
3h agoResponsive 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% MoMPipeline 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
Maya posted release notes
Jon closed QA cycle
Nora adjusted onboarding UX
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.