| Do | Provide a visible label so users understand what they are selecting. |
| Do | Use sections and dividers to organize options when the list exceeds ~8 items. |
| Do | Use renderOption for custom option rows. Do not pass SelectorOption directly as JSX children. |
| Do | Set a meaningful placeholder that hints at the expected selection (e.g. "Choose a country" not "Select..."). |
| Don't | Use for action menus; use Dropdown Menu for triggering commands or navigation. |
| Don't | Use when there are only two options; use a SegmentedControl or radio buttons instead. |
| Don't | Use Selector for navigation; links should be links, not dropdown options. |
| Don't | Use for yes/no or on/off choices; use Switch or CheckboxInput instead. |
| Don't | Put more than ~20 options without sections; consider Typeahead for large lists. |