Elevation

Shadow Scale

Three levels of elevation for clear visual hierarchy.

Token	Use
--shadow-performance-scale-sm	Buttons, inputs, subtle lift
--shadow-performance-scale-md	Cards, dropdowns
--shadow-performance-scale-lg	Modals, popovers

Shadow Values

--shadow-performance-scale-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
--shadow-performance-scale-md: 0 4px 6px -1px rgba(0, 0, 0, 0.1),
             0 2px 4px -1px rgba(0, 0, 0, 0.06);
--shadow-performance-scale-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.1),
             0 4px 6px -2px rgba(0, 0, 0, 0.05);

Usage Patterns

Cards

.card {
  box-shadow: var(--shadow-performance-scale-md);
}

.card:hover {
  box-shadow: var(--shadow-performance-scale-lg);
  transform: translateY(-2px);
}

Modals

.modal {
  box-shadow: var(--shadow-performance-scale-lg);
}

Buttons

.button {
  box-shadow: var(--shadow-performance-scale-sm);
}

.button:active {
  box-shadow: none;
}

Z-Index Scale

Consistent stacking order for overlapping elements.

Token	Value	Use
--z-performance-dropdown	100	Dropdowns, tooltips
--z-performance-modal	200	Modal dialogs
--z-toast	300	Toast notifications
--z-performance-tooltip	400	Tooltips on top

Best Practices

1. Use sparingly - Not every element needs elevation
2. Maintain hierarchy - Higher z-index = more shadow
3. Animate transitions - Smooth shadow changes on hover
4. Dark mode - Shadows less visible; use borders instead

/* Elevation transition */
.card {
  transition: box-shadow var(--duration-performance-fast) var(--ease-performance-standard),
              transform var(--duration-performance-fast) var(--ease-performance-standard);
}