Documentation for useSystemColorMode?

Feature request

I can see useSystemColorMode is set to false on this page on the documentation but i don’t see any explanation about what that actually do?

Is your feature request related to a problem? Please describe.

It’s more of a documentation / explanation request than a feature request?

Describe the solution you’d like

Some comment/explanation about that flag on the documentation?

[hems]

Hi - it’s about this section, we definitely clarify that.

useSystemColorMode indicates Chakra to detect the theme via @media (prefers-color-scheme: dark | light).

Thank you for pointing that out!

Note that if you set this to true, it takes priority over a) the default, initialColorMode b) users choice when the user toggled the theme once.

I don’t think a) and b) were clear, all the examples on the website only show it set to false and there is not real explanation of what happens if you turn it to true?

Perhaps a section named “Using System Color Mode” could be added?

Also, i would guess most end-users would only want to use the System Color while the user has not toggled the theme, once the user toggles and it’s saved on localStorag / cookies, then system color mode should not take priority over the user preferences? As in: i would guess the system colour would only be used as a “first guess colour before the user decides”?

Perhaps to make this a little bit more customiseable the system color code could be exposed as a hook or function under theme-tools ?

[stale[bot]]

Hi! This issue hasn’t seen any activity recently. We close inactive issues after 35 days to manage the volume of issues we receive. If we missed this issue or you want to keep it open, please reply here. That will reset the timer and allow more time for this issue to be addressed before it is closed.