Component API Design

guidelines for building shared components

Photo by Daniel McCullough on Unsplash


Make the Correct Choices Easy


High-level Accordion Component Example
High-level FeatureList Component Example
<Button variant="danger">Cancel Your account</Button>
Button Component Example
Alert Component Example
Accordion Header Component Example
Text and Button Example Component Examples



Make incorrect choices obvious


Consistent styling patterns

Deprecation warnings

Provide helpful off-ramps

Handling edge cases


Composable Accordion Component Example

Clear communication

Thanks for Reading!

design systems @workday

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store