feat(theming): support user OS-level dark/light mode configuration

[mistercrunch]

This PR introduce new superset_config settings:

# THEME and THEME_DARK are used for setting a custom theme to Superset,
# it follows the ant design theme structure.
# You can use the AntDesign theme editor to generate a theme structure
# https://ant.design/theme-editor
# The config are set as a callable returning an antd-compatible theme object
# so that themes can be hot-swapped by fetching a theme object definition remotely

# Whether to respect the user's OS dark mode setting. If True, THEME_DARK must be set
THEME_RESPECT_USER_OS_DARK_SETTING = False
THEME: dict[str, Any] = lambda: {}  # NOQA
THEME_DARK: dict[str, Any] = lambda: {"algorithm": "dark"}  # NOQA

Some of the logic:

• the frontend will set a cookie with the os-level preference for dark theme
• on first request, before cookie is set, the backend returns both theme (light and dark) configuration under boostrapData.themes, letting the frontend to pick the right one
• on subsequent request, once the cookie is available, the backend return the right theme under boostrapData.themes

[korbit-ai]

Review by Korbit AI

Korbit automatically attempts to detect when you fix issues in new commits.

Category	Issue	Status
	Unvalidated Cookie Value Setting ▹ view	🧠 Not in scope
	No UI Theme Update ▹ view	🧠 Not in scope
	Missing Fallback Theme Logic ▹ view	🧠 Not in scope
	Documentation Accuracy Issue ▹ view	🧠 Not in standard
	Unnecessary Lambda Functions for Static Config Values ▹ view	🧠 Not in scope
	Missing OS Theme Change Listener ▹ view	🧠 Not in standard

Files scanned

​

File Path	Reviewed
superset-frontend/src/views/RootContextProviders.tsx	✅
superset-frontend/src/setup/setupApp.ts	✅
superset-frontend/src/theme/ThemeController.tsx	✅
superset/views/base.py	✅
superset/config.py	✅

Explore our documentation to understand the languages and file types we support and the files we ignore.

Check out our docs on how you can make Korbit work best for you and your team.

Loving Korbit!? Share us on LinkedIn Reddit and X