v3.8.0

3.8.0 (2025-10-06)

Highlights

• ⚙️ Configurable Header Position
  You can now customize the header's position on the page using the $wgCitizenHeaderPosition setting. Supported values are top, bottom, left, and right. (Thanks, @Vonavy!)

• ⚡️ New Performance Mode
  A new performance mode has been added to improve responsiveness by disabling frosted glass and transition effects. The skin automatically enables this mode on page load and disables it if GPU acceleration is detected. You can manually enable or disable it using the Performance mode button in the preferences.

• 🖼 Improved Page Backgrounds
  Backgrounds applied to the .citizen-page-container are now correctly displayed underneath the header. This should benefit those who are using semi-transparent header backgrounds.

Changelog

Features

• core: ✨ make site header position configurable (by @Vonavy) (ff2f22a)
• header: ✨ use CSS variables to define header behavior (5b611c5)
• header: ✨ use padding instead of margin for page container (41a472f)
• pref: ✨ add performance mode client preferences (0a01979), closes #1151
• pref: ✨ apply performance mode if it is not set and GPU accel is not avaliable (22ae76f)

Bug Fixes

• CodeMirror: 🐛 fix the misaligned CodeMirror v6 overlay on VE (by @xtexx) (#1139) (555babe)
• commandPalette: 🐛 use page.key for id (by @TiggeZaki) (bbd9e1d)
• debugToolbar: 🐛 fix ToC button above the debug toolbar (ada6352)
• overflow: 🐛 add inline margin to prevent clipping borders (68325a0)
• prefs: 🐛 fix incorrect opacity and backdrop filter for performance mode in dark mode (f8c3cf9)
• search: 🐛 fix double escaping in legacy search box (by @SomeMWDev) (#1135) (abbee1d)
• search: 🐛 remove aria-details if using command palette (by @TiggeZaki) (3fda30f)
• sidebar: add icon to special pages link in sidebar for MW 1.44+ (05a4fbe)
• SyntaxHighlight: 🐛 remove background color that exceeds the border (by @TiggeZaki) (#1145) (3c083f0)
• tokens: 🐛 include unit in CSS variables with zero as value (77d7c09), closes #1152

Performance Improvements

• preferences: ⚡️ only load preferences module when preference button is clicked (9fe31f4)

Miscellaneous Chores

• composer: 🔧 sync package description (6e0cb50)
• deps-dev: 🔗 pin ESLint to 8.57.0 (e7c8264)

New Contributors

• @xtexx made their first contribution in #1139

Full Changelog: v3.7.0...v3.8.0