[docs] [Joy-UI] Theme colour specifications and accessibility guidelines
@siriwatknp is already working on this.
Since Jun 9, 2025.
- Dominant language
- JavaScript
- Stars
- 99.1k
- Forks
- 32.5k
- Avg merge
- 2d 17h
- Merged PRs (30d)
- 106
Description
Related page
https://mui.com/joy-ui/customization/theme-colors/
Kind of issue
Missing information
Issue description
The documentation does not seem to include any information regarding the accessibility specifications of the colour palette used when customising the theme with extendTheme(...). This is confusing, since it mentions several improvements made to the default colour palette in v5.0.0-beta.0 but does not dive deeper into details such as:
- minimum contrast ratio between each hue
- min and max luminance
- handling of cases where the primary colour is similar to a semantic one such as green, yellow or red
Context
I am trying to implement a custom theme including my company's brand colour as primary, but cannot find any relevant tools to generate the palette, nor do I see any specs regarding its creation.
Search keywords
colours, theme, accessibility, material palette, hues, wcag, palette generation, specifications
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.