From 8741220c8b43079c0fa7e6120f2a8d8d7630ae05 Mon Sep 17 00:00:00 2001 From: Andrew Ronaldson Date: Fri, 14 Aug 2026 12:46:19 -0300 Subject: [PATCH 1/2] docs(theming patterns): add best practices --- .../img/theme-switcher-masthead-menu.png | Bin 0 -> 65619 bytes .../img/theme-switcher-preferences.png | Bin 0 -> 54658 bytes .../styles/theming/theming.md | 43 ++++++++++++++++++ 3 files changed, 43 insertions(+) create mode 100644 packages/documentation-site/patternfly-docs/content/foundations-and-styles/styles/theming/img/theme-switcher-masthead-menu.png create mode 100644 packages/documentation-site/patternfly-docs/content/foundations-and-styles/styles/theming/img/theme-switcher-preferences.png diff --git a/packages/documentation-site/patternfly-docs/content/foundations-and-styles/styles/theming/img/theme-switcher-masthead-menu.png b/packages/documentation-site/patternfly-docs/content/foundations-and-styles/styles/theming/img/theme-switcher-masthead-menu.png new file mode 100644 index 0000000000000000000000000000000000000000..ce57d672ac417061da1016f68ec98ac026f7c363 GIT binary patch literal 65619 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 }-k=s7RoF}+ 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�OF^p4_aqd*1x)cucCNcAO~+RBWoEBH_<$B9kF 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 literal 0 HcmV?d00001 diff --git a/packages/documentation-site/patternfly-docs/content/foundations-and-styles/styles/theming/theming.md b/packages/documentation-site/patternfly-docs/content/foundations-and-styles/styles/theming/theming.md index b1236c3748..d3c4d55394 100644 --- a/packages/documentation-site/patternfly-docs/content/foundations-and-styles/styles/theming/theming.md +++ b/packages/documentation-site/patternfly-docs/content/foundations-and-styles/styles/theming/theming.md @@ -119,6 +119,49 @@ The following table outlines the availability and compatibility of PatternFly fe | Branded icons | Optional (Manual) | Default | High contrast support | Yes | Yes | +## Theme controls + +Because theme, color scheme, and contrast mode affect both personalization and accessibility, products should give users an easy, discoverable way to adjust them. We recommend exposing these controls from the masthead, using one of the following patterns. + +### Preferences page or modal + +The masthead's [settings icon or user menu](/components/masthead#elements) opens a dedicated preferences page or modal, where theme, color scheme, and contrast mode controls appear alongside other application-level preferences, such as language or notification settings. + + +
+![Placeholder screenshot of a preferences page with a Theme dropdown and a Contrast mode dropdown, shown alongside other unrelated application settings like search and project defaults.](./img/theme-switcher-preferences.png) +
+ +Use this pattern when: +- Theming is one of several account- or application-level preferences you want to expose in a single, dedicated location. +- Your product already has an established settings or preferences experience that you want to extend, rather than introduce a new masthead item. +- You want to pair each control with additional context, like descriptive helper text, without crowding the masthead. + +### Masthead theme switcher + +A persistent icon toggle, commonly represented by a sun or moon icon, sits directly in the masthead. Selecting it opens a menu with expanded controls for theme, color scheme, and contrast mode, letting users adjust their preferences without leaving their current page. + + +
+![Placeholder screenshot of a masthead icon toggle opening a menu with toggle groups for Theme, Color scheme, and Contrast mode.](./img/theme-switcher-masthead-menu.png) +
+ +Use this pattern when: +- You want theme controls to be reachable from anywhere in the product, in a single click. +- Color scheme is the control most users will reach for, with theme and contrast mode as secondary, expanded options. +- Your product doesn't already have a dedicated settings page or modal, and you don't want to introduce one solely for theming. + +### Best practices for theme controls + +Regardless of which pattern you use, keep the following guidelines in mind: + +- **Default to the system setting:** Provide a "System" option for color scheme and contrast mode, and select it by default, so your product respects the user's OS- or browser-level preferences until they choose to override them. +- **Persist user selections:** Store each user's choice, for example in `localStorage` or their account settings, so their preferences are remembered across sessions. +- **Apply changes immediately:** Update the UI as soon as a user makes a selection, without requiring a separate save or submit action. +- **Group controls by tier:** Present Theme, Color scheme, and Contrast mode as distinct, clearly labeled groups so users understand how each layer affects their experience. +- **Match the control to the option count:** Use a toggle group for a small, fixed set of options (like Light, Dark, and System) and a dropdown or select list if you expect to support more options in the future. +- **Keep accessibility controls easy to find:** Don't bury Contrast mode behind extra steps or unrelated settings. Users who need High contrast, or who need to turn off Glass, should be able to do so quickly. + ## Best practices To ensure your application is robust, maintainable, and adaptable across different themes, we recommend following these best practices. From 21b9e710bec3e52beb52029b828f41ad40cdaf03 Mon Sep 17 00:00:00 2001 From: Andrew Ronaldson Date: Fri, 14 Aug 2026 14:25:09 -0300 Subject: [PATCH 2/2] docs(theme controls): minor changes --- .../foundations-and-styles/styles/theming/theming.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/packages/documentation-site/patternfly-docs/content/foundations-and-styles/styles/theming/theming.md b/packages/documentation-site/patternfly-docs/content/foundations-and-styles/styles/theming/theming.md index d3c4d55394..92970a7c59 100644 --- a/packages/documentation-site/patternfly-docs/content/foundations-and-styles/styles/theming/theming.md +++ b/packages/documentation-site/patternfly-docs/content/foundations-and-styles/styles/theming/theming.md @@ -123,9 +123,9 @@ The following table outlines the availability and compatibility of PatternFly fe Because theme, color scheme, and contrast mode affect both personalization and accessibility, products should give users an easy, discoverable way to adjust them. We recommend exposing these controls from the masthead, using one of the following patterns. -### Preferences page or modal +### User preferences page or modal -The masthead's [settings icon or user menu](/components/masthead#elements) opens a dedicated preferences page or modal, where theme, color scheme, and contrast mode controls appear alongside other application-level preferences, such as language or notification settings. +The masthead's [Settings button or User menu toggle](/components/masthead#elements) opens a menu with a dedicated **User preferences** item. This will trigger either a page or modal, where theme, color scheme, and contrast mode controls appear along with other application-level preferences, such as language or notification settings.
@@ -133,7 +133,7 @@ The masthead's [settings icon or user menu](/components/masthead#elements) opens
Use this pattern when: -- Theming is one of several account- or application-level preferences you want to expose in a single, dedicated location. +- Theming controls are one of several User preferences that could be exposed in a single, dedicated location. - Your product already has an established settings or preferences experience that you want to extend, rather than introduce a new masthead item. - You want to pair each control with additional context, like descriptive helper text, without crowding the masthead. @@ -151,7 +151,7 @@ Use this pattern when: - Color scheme is the control most users will reach for, with theme and contrast mode as secondary, expanded options. - Your product doesn't already have a dedicated settings page or modal, and you don't want to introduce one solely for theming. -### Best practices for theme controls +### Best practices for Theme controls Regardless of which pattern you use, keep the following guidelines in mind: