dark mode

[jwogrady]

I am requesting a dark mode version of the website and documentation. It's not about my personal style preference. It's a usability issue since I am presently dealing with cataracts.

A dark theme can be easier to read because it reduces light and improves contrast. An alternate solution would be having the ability to change the style.

I want to thank you for Flask. It's incredible.

[ThiefMaster]

I'm sure a contribution to https://github.com/pallets/pallets-sphinx-themes that adds a dark mode would be welcome :)

[davidism]

I don't personally use dark mode much, I find it harder to read paragraphs in (code is a different story, but the docs and website are mostly prose). If someone wants to contribute a dark theme, that's fine, but it needs to integrate with the system preference as well as be toggleable (with the preference stored in local storage).

local storage user choice > system preference > light mode default

[yuxiaoy1]

Hi, I'm working on this feature.
Do we need configuration to enable/disable the dark mode (show/hide the switch)?

[ThiefMaster]

I think giving users the option to toggle it (persistently - save it e.g. in localStorage) is enough.

[yuxiaoy1]

Got it.
One more question, the themes/babel folder is unused, right? I checked the conf.py of babel, and it didn't involve the pallets-sphinx-thmes.

[davidism]

We're planning to switch to Furo as a base theme, which will provide a dark mode.