dequelabs / dequelabs/cauldron

Add Customizing Documentation

Open
#1,469 0 comments 0 reactions 0 assignees View on GitHub
documentation
Dominant language
TypeScript
Stars
127
Forks
31
Avg merge
2d 12h
Merged PRs (30d)
8

Description

We should document how we expect authors to customize or override Cauldron styles. Some examples:

- https://mui.com/material-ui/customization/how-to-customize/
- https://carbondesignsystem.com/elements/themes/overview/
- https://www.lightningdesignsystem.com/platforms/lightning/styling-hooks/

It's become a somewhat common practice to override styles via CSS specificity:

```css
// in application code
.Component {
background-color: red;
}
```

This can come with its own set of issues if not used correctly as it would be expected that authors would correctly update any styles that need to cascade. There are natural ways to do this with css vars, but we should document each approach and specify how and when an author should override or customize Cauldron styles.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.