Writing good component API

When it comes to React components, props are the API that developers consume.

A good API should be obvious, something the developer can guess. You want to make it easier for the developer to implement their feature and move on. This is valid not just for developers creating component libraries, but also for developers building applications. Your team mates have to use the component API you create.

This series is inspired by the talks and articles of Sebastian Markbåge, Brent Jackson, Jenn Creighton and A. Jesse Jiryu Davis
After consuming a bunch of articles + talks and building a design system for more than a year, I've come up with a few guidelines.