Skip to results

Design Component APIs

Components · components

Updated 2026-07-28

Components should be flexible without becoming unpredictable.
Good components expose meaningful decisions:

Example:

Size.
Variant.
State.
Content.

Avoid exposing every visual detail:

Random padding controls.
Custom colors everywhere.
Unlimited variations.

The goal:

Easy to use.
Hard to misuse.

A component API is a UX contract between design and engineering.

Related guides