Skip to content

Design system

Documentation

DesignFoundations / Border & Radius

Foundations / Border & Radius

Stable

Border & Radius

Borders establish ownership; radius tells the eye which pieces belong together. Keep both quiet and predictable.

On this page

Radius scale

Controls use the smaller corners, cards and previews use the middle of the scale, and larger corners are reserved for a contained feature surface.

--radius-sm6px
--radius-md8px
--radius-lg10px
--radius-xl14px
--radius-2xl18px

Border scale

TokenValueUse for
--border-width-thin1pxDefault boundaries, dividers, and fields.
--border-width-strong2pxKeyboard focus markers or deliberate emphasis.
solidDefaultStable ownership between a surface and its content.
dashedExceptionDrop zones, previews, or an unfinished boundary that needs explanation.

Guidance

Do

Use one radius for the outer surface and a smaller radius for controls inside it.

Do not

Mix several unrelated corner values in one component or use a pill shape for a rectangular action.

Radius is deliberately separate from Spacing. A larger gap does not imply a larger corner.