Skip to content

Colors

Semantic colors for content, controls, feedback and materials.

One semantic color system

The supplied iOS/iPadOS 27 Figma file defines the available light/dark colors and Elevated backgrounds. Missing increased-contrast, placeholder and system-link roles temporarily use explicitly documented UIKit 26.5 samples; missing Web states retain Lenso recipes. These are fallbacks, not verified iOS 27 native values. All sources resolve into one token matrix, with no selectable legacy palette.

RoleUse
--lenso-label-primary, -secondary, -tertiary, -quaternaryOrdinary text hierarchy
--lenso-label-placeholderInput placeholder
--lenso-background-primary, -secondary, -tertiaryStandard content layers
--lenso-background-grouped-primary, -secondary, -tertiaryGrouped content layers
--lenso-fill-primary, -secondary, -tertiary, -quaternaryControl shapes, not interchangeable page backgrounds
--lenso-separator, --lenso-separator-opaqueTransparent / opaque division
--lenso-tint, --lenso-label-on-tint, --lenso-tint-textAction fill, paired foreground, text action
--lenso-linkNavigation link
--lenso-action-destructive, --lenso-action-destructive-textDestructive action fill / text
--lenso-status-{success,warning,error,info}-{indicator,text,fill,on-fill,border}Business feedback; choose the role for the actual use
--lenso-focus-ring, --lenso-focus-ring-backingKeyboard focus and backing
--lenso-selection-fill, --lenso-selection-textSelected content
--lenso-scrimModal backdrop

A status indicator is not necessarily suitable for normal-sized text. status-*-text is measured against sampled ordinary backgrounds; status-*-on-fill is paired with the corresponding status fill. Content images, user-selected colors, chart series and syntax highlighting retain their own content meaning.

Materials

Material foregrounds depend on blending and the backdrop. Do not use an ordinary label color as a substitute for a material foreground recipe. Reduced transparency and high-contrast material fallbacks are Web adaptations, with opaque surfaces and ordinary foregrounds. System forced colors take precedence over brand colors.

Customization

Configure colors with the theme API. The Theme Builder changes the same semantic configuration as application code. There is no alternative Apple palette to enable and no legacy palette to maintain. Verify custom colors against actual content, including focus, disabled states, transparency and both appearances.