Foundation

Effects

Shadow, focus, and layering tokens keep Nerio surfaces precise without tying the system to decorative depth or a specific product category.

Elevation scale

Tokenized
NameTokenUse
None--n-shadow-noneFlat surfaces and controls that do not need elevation.
Extra subtle--n-shadow-xsThe lightest available depth primitive.
Raised--n-shadow-smRestrained separation for raised containers.
Floating--n-shadow-mdOverlays, dialogs, toasts, and floating controls.

Semantic effects

NameTokenUse
Flat surface--n-shadow-surface-flatResolves to no shadow by default.
Control surface--n-shadow-surface-controlKeeps default controls shadow-free.
Raised surface--n-shadow-surface-raisedResolves to the restrained raised shadow.
Floating surface--n-shadow-surface-floatingResolves to the strongest Core elevation.
Focus ring--n-focus-ringTwo-stage visible keyboard focus treatment.
Overlay layer--n-overlay-z-indexPortal stacking contract for menus, popovers, dialogs, and toasts.

Focus

--n-focus-ring combines a 2px surface-colored offset with a 4px soft outer ring. Theme and mode selectors remap the ring colors while controls share the same focus geometry.

RoleToken
Offset--n-color-focus-offset
Soft ring--n-color-focus-ring-soft
Inner width--n-focus-ring-inner-width
Outer width--n-focus-ring-outer-width

Component contracts

ContractToken
Card elevation--n-card-shadow
Card radius--n-card-radius
Overlay elevation--n-overlay-shadow
Overlay backdrop--n-overlay-backdrop
Overlay layer--n-overlay-z-index

Usage

:root {  --n-shadow-surface-raised: var(--n-shadow-sm);  --n-shadow-surface-floating: var(--n-shadow-md);  --n-color-focus-ring-soft: rgb(109 40 217 / 0.26);}.project-card {  box-shadow: var(--n-shadow-surface-raised);}.project-card:focus-visible {  box-shadow: var(--n-focus-ring);}
  • Use semantic elevation aliases in product and component styles.
  • Keep shadows restrained; spacing and surface contrast should carry most hierarchy.
  • Never remove visible focus styles from interactive surfaces.
  • Use overlay z-index tokens for portal-based components and stacked UI.