This migration guide focuses on the process of migrating from Orbit v10.3.0 to v11.0, as some breaking changes were introduced. The best part is, migrating to v11 is incredibly simple! We’ve streamlined the process to ensure a smooth transition, making it easier than ever to benefit from the latest enhancements.

The readOnly property was passed directly to the native HTML select element as an attribute, which is not supported:

The size property has been removed from the Textarea component to align it with other input components that have also had the size property removed.

The color property of Separator component now accepts only Tailwind color classes, e.g. color=“border-blue-normal”, color=“border-product-normal”, etc. Before it was accepting string values in form of Orbit palette tokens, e.g. color=“paletteProductNormal”.

// before
<Separator color="paletteProductNormal" type="solid" />
// after
<Separator color="border-product-normal" />

The indent property of Separator component was renamed to sideOffset to better reflect its behaviour.

// before
<Separator indent="large" align="left" />
// after
<Separator sideOffset="large" align="left" />

Previously, you had to explicitly set the type property to “solid” to use a custom color for the Separator. Now, it’s no longer required as the type property defaults to “solid”.