v3.3.0

3.3.0 (2025-06-07)

Highlights

📖 Typography Makeover

We've updated our typography to be more consistent and beautiful, aligning with the wider MediaWiki ecosystem and Codex 2.0.

• Easier on the eyes: Text is now more readable and pleasant.
• Go big or go home! Want larger text? You can now select an "extra large" font size from your preferences.
• No more broken UI: These font changes are contained to the page content, so the rest of the interface remains pristine.
• For the developers: We've added new font utility classes: .citizen-text-heading-1, .citizen-text-heading-2, .citizen-text-heading-3, .citizen-text-heading-4, .citizen-text-body, .citizen-text-small, .citizen-text-overline

⚠️ Important Note: --font-size-x-small is now 0.75rem by default, which is smaller than before. You might want to adjust it if you use the variable.

🚀 A Smoother, Faster Sticky Header

Say goodbye to janky scrolling! The sticky header has been completely rebuilt for maximum performance. It's now a separate element, which means no more annoying layout shifts or lag.

⚠️ Important Note: This is a behind-the-scenes HTML change. To enjoy the new super-smooth sticky header, you might need to clear your wiki cache. Nothing will break if you don't, but you'll be missing out on the magic!

🎂 And Other Goodies!

We've sprinkled in a few more treats for you:

• Hover no more! No need for custom CSS! You can now disable the image hover effect using the --transform-image-hover CSS variable. Just set it to none!
• When did I join? Your registration date is now proudly displayed in the user menu.
• Happy Wiki Cake Day! 🎂 Celebrate your wiki anniversary with a cute cake icon next to your registration date.

Changelog

Features

• contentEnhancements: ✨ add user anniversary feature and improve registration date display (64cb5d7)
• core: ✨ add --transform-image-hover variable that controls image hover zoom (d84e4c5)
• preferences: ✨ add extra large font size option (dc7d3bd)
• preferences: ✨ restrict font size to body content (2d89125)
• stickyHeader: ✨ add 'Add Section' button to sticky header (0bc62b6)
• stickyHeader: ✨ add language dropdown to sticky header (3260022)
• stickyHeader: ✨ re-implement sticky header (#1073) (fbb1d4f), closes #906
• typography: ✨ add utility classes for typography styles (4251f3c)
• typography: ✨ backport and use Codex 2.0 font tokens (0e13c8e)
• typography: ✨ implement Codex 2.0 font styles across components (bfd7e63)
• typography: ✨ move CJK line-height adjustment to citizen-body styles (111fb03)
• userMenu: ✨ improve user stats layout and add registration date (87eb6c7)

Bug Fixes

• commandPalette: 🐛 fix incorrect msg call for tips (fdee8f4)
• commandPalette: 🐛 use matched title for URL when available (e538bb8), closes #1065
• core: 🐛 correct import path for mixins in edit styles (8b25299)
• core: 🐛 default link to be not underlined (8e7e57b)
• links: 🐛 fix various broken link styles in diff and log pages (066191d)
• toc: 🐛 prevent applying Codex link styles to toc links (15adb98)
• typography: 🐛 citizen-body should use unitless line height (783eb6e)
• VisualEditor: 🐛 allow categories to be clicked (4135a49)

v3.2.0

3.2.0 (2025-05-19)

Highlights

Command Palette

• Now on by default! 🎉
• Find anything with new full-text and media search! 🕵️‍♀️📚
• @ now finds users directly, like magic! ✨👤
• Tips added to make you a wizard! 🧙‍♂️

Footer

• Shiny new design for the footer! ✨💅
• Site icon are now chilling in the footer! 📚👇
• Links now auto-organize into neat columns! 📊

Syntax Highlight

• Line numbers got a cool background color upgrade! 🎨🔢

Changelog

Features

• commandPalette: ✨ add media search action if supported (04157d8)
• commandPalette: ✨ add page edit action (55addaf)
• commandPalette: ✨ add tips for command palette usage (4fa69e1)
• commandPalette: ✨ add user command (#1061) (104adbd)
• commandPalette: ✨ enable command palette by default (a00ebba)
• commandPalette: ✨ improve result action handling (#1064) (5b90efa)
• commandPalette: ✨ improve results transition logic (8ff903d)
• footer: ✨ add wiki icon to footer if avaliable (e431222)
• footer: ✨ update footer styles (6ab4db4)
• search: ✨ add the citizen-search-trigger class to trigger search UI (577788e)
• sectionLinks: ✨ reimplement edit section and use Codex button (2152ac5)

Bug Fixes

• commandPalette: 🐛 always clear the results on new query (1392ae0)
• commandPalette: 🐛 fix incorrect URL generation for RelatedArticles (21bf5f1)
• commandPalette: 🐛 fix incorrect URL generation for REST search (d062fd5)
• commandPalette: 🐛 fulltext search should be updated instantly (814f306)
• CommandPalette: 🐛 ignore trailing space in search query highlight (eca18e3)
• commandPalette: 🐛 prevent duplicate dismiss action in recent items (901935b)
• commandPalette: 🐛 update URL generation for media search to include type parameter (460803b)
• footer: 🐛 fix incorrect footer icon wrapping (73e38ed)
• footer: 🐛 fix incorrect footer styles (66c7253)
• header: 🐛 fix missing home icon in header (9ba86b9)
• SyntaxHighlight: 🐛 add background for line numbers (#1059) (2aabdab)
• toc: 🐛 fix scrolling when sticky header is disabled (#1058) (6ea7a57)
• typography: 🐛 do not use negative top margin for nested elements after paragraphs (bd38820)

Miscellaneous Chores

• Babel: 🔧 remove unnessecary extension styles (ceacb7a)

v3.1.0

3.1.0 (2025-04-27)

Highlights

👋 HEYA! Changelog is tough to read, so we're trying something new for all future releases. Here's a summary of what's new:

Command Palette: Your New Superpower! 🎮

• Experimental feature alert! Toggle it on with $wgCitizenEnableCommandPalette = true
• Soon™ to be your search module's cool replacement
• Learn all the commands with / without going to Hogwarts
• Add your own magic commands via skins.citizen.commandPalette.registerCommand hook in JS
• Zip through namespaces with : or /ns: shortcuts
• Summon actions with > to quickly access special pages and menu items
• Discovers related articles automatically when RelatedArticle is installed
• Template hunting made easy with {{ search prefix

Wikitables Gone Wild! 📊

• Make tables stretch their legs with the new wikitable--fluid class for full-width glory

Navigation That Knows Its Place 📱

• Safe area handling keeps navigation from playing hide-and-seek under iOS home buttons

Dark Mode Glow-Up 🌙

• Enhanced contrast for those late-night wiki sessions

Alert Dots: Now in Attention-Grabbing Red! 🚨

• Echo alerts stand out with stylish red notification dots

Label Text: Easy on the Eyes 👁️

• Refined label text styles for a more pleasant reading experience

Changelog

🧐 If you are an exquisite enjoyer of detail, you can read the full changelog below:

Features

• commandPalette: ✨ add action command (#1049) (a5360c3)
• commandPalette: ✨ add ctrl/cmd+k binding (49961f5)
• commandPalette: ✨ add edit action to page results (85a48c1)
• commandPalette: ✨ add fulltext search as a result (86375c0)
• commandPalette: ✨ add keyboard hints (b482d27)
• commandPalette: ✨ add loading state to command palette search results (#1033) (2389466)
• commandPalette: ✨ add namespace command and various refactor (#1043) (4de089d)
• commandPalette: ✨ add recent search (19ea550)
• commandPalette: ✨ add redirect title to search results (#1032) (4b29b4c)
• commandPalette: ✨ add RelatedArticles to presults if supported (#1048) (cbfb03f)
• commandPalette: ✨ add tab key functionality to close input (8eccfeb)
• commandPalette: ✨ allow : the namespace command (0e6fe57)
• CommandPalette: ✨ allow command to be extensible through mw.hook (#1050) (8b2ef4c)
• commandPalette: ✨ allow recent items to be removed (08425a6)
• commandPalette: ✨ handle wikilink and template syntax in query (a1a38af)
• commandPalette: ✨ improve enter key logic (4adb6c6)
• commandPalette: ✨ improve no results empty state (19f7d86)
• commandPalette: ✨ increase max-height for results container (b49c5ba)
• commandPalette: ✨ initial implementation of Command Palette (55cb33b)
• commandPalette: ✨ make command search case-insensitive (34d9483)
• commandPalette: ✨ set up foundation for result type (b1cc5d7)
• commandPalette: ✨ show command as metadata in result (4c1063d)
• commandPalette: ✨ show keyhints conditionally (32b46a0)
• commandPalette: ✨ tweak various styles (79c4ee7)
• commandPalette: ✨ use Pinia for state management (56a9e91)
• commandPalette: ✨ use prefix search for command list (10d3dfb)
• composer: 🐛 allow Composer v2 for installation (2960a7d)
• core: ✨ add padding for device safe area (9db68fb)
• core: ✨ apply font grade to light mode instead of dark mode (ab3853a)
• core: ✨ drop view transitions (17e76eb)
• core: ✨ reduce spacing between paragraph element and other elements that have top margin (6339841)
• core: ✨ reduce subtle background color brightness (12ce5e4)
• core: ✨ use darker surface colors (c6ec6d8)
• dropdown: ✨ use <kbd> tag for keyboard hint (4128bd4)
• Echo: ✨ use red dot for alert badge (216bdff), closes #1027
• typography: ✨ tweak label text font styles (d753c03)
• wikitable: ✨ add wikitable--fluid utitlity class for full width tables (ff64f43)

Bug Fixes

• commandPalatte: 🐛 fix incorrect list item header color (53e0c55)
• commandPalette: 🐛 add missing components (892ca23)
• commandPalette: 🐛 allow icon prop to accept both String and Object types (5e18f04)
• commandPalette: 🐛 fix conflict with OOUI overlay (be51f79)
• CommandPalette: 🐛 fix incorrect URL for related articles (cf8fe3c)
• commandPalette: 🐛 fix misaligned progress bar (d474817)
• **c...

v3.0.0

3.0.0 (2025-03-28)

Please check out the migration section below if you have run into any issues.

⚠ BREAKING CHANGES

• tokens: All primary colors tokens are renamed.
• tokens: CSS variables that are previously deprecated are now hard-deprecated.
• Citizen is targeting MW 1.43 now and start development on the v3 version

Features

• CodeMirror: ✨ add initial styles for CodeMirror v6 (87fc5ca)
• CodeMirror: ✨ add WikiEditor and VE styles for CodeMirror v6 (b8fa2c7)
• CommentStreams: ✨ update styles for 1.43 (dbb1da0)
• core: ✨ add frosted glass effect to menu cards (c20082c)
• core: ✨ add top margin to mw-content-text (7c6237e)
• core: ✨ adding vertical padding to text editor (1ec112d)
• core: ✨ bump dark border color contrast (f94d0a4)
• core: ✨ drop letter-spacing from legend (85588ff)
• core: ✨ improve site notice handling (7dac6d2)
• core: ✨ only apply main page-specific styles on read view (fb8be79)
• core: ✨ set mwRestApi as the default search gateway (ed5f11a)
• core: ✨ update mw-indicators spacing (cc1843e)
• core: ✨ use mask-image instead of background-image for Citizen UI icons (bc828b3)
• DiscussionTools: ✨ update DiscussionTools styles to 1.43 (9f750be)
• Echo: ✨ add backdrop when modal is opened (6b9fc0a)
• Echo: ✨ improve Echo badge icon replacement logic (86ba574)
• Echo: ✨ update Echo for 1.43 (6740eac)
• header: ✨ simplify header icon color logic (57711a9)
• mediawiki: ✨ add border to mw-tag-marker (3c626d9)
• mediawiki: ✨ adjust installed software cell width (42321c0)
• mediawiki: ✨ allow Special:SpecialPages legends to float (0a4d42e)
• mediawiki: ✨ increase input field height in signup and login pages (898580a)
• mediawiki: ✨ rework login and signup page styles (c10ca94)
• mediawiki: ✨ start-align installed software in Special:Version (f152da9)
• mediawiki: ✨ update styles for Special:Preferences (597abc1)
• MultimediaViewer: ✨ add hover state to description button (ebe1979)
• MultimediaViewer: ✨ add styles for error box (6ea13ff)
• MultimediaViewer: ✨ scale down the description button (99d926f)
• MultimediaViewer: ✨ simplify title max-height calculation (9fb16c6)
• MultimediaViewer: ✨ update styles to 1.43 (4497ac1)
• OOUI: ✨ drop unnessecary OOUI styles for 1.43 (7be2ec1)
• OOUI: ✨ standardize border-radius (6f6d96c)
• Popups: ✨ update Popups to 1.43 (e21d75b)
• RelatedArticles: ✨ update RelatedArticles styles (bd340e7)
• share: ✨ do not show share button if page is not a content page (8c29416)
• stickyHeader: ✨ make sticky header more compact (8e62594)
• stickyHeader: ✨ use fancy frosted glass for page header (ad50e8d)
• TemplateData: ✨ update styles for 1.43 (6110a5d)
• toc: ✨ match ToC link color with color-base (67852e7)
• tokens: ✨ add backdrop-opacity CSS variable (76727b1)
• tokens: ✨ add more saturation to frosted glass (cb14c43)
• tokens: ✨ backport Codex tokens from latest master (6252e24)
• tokens: ✨ revamp colors that are related to progressive/primary colors (a5f5a3c)
• tokens: ✨ update Codex tokens to v1.14.0 (7ef2375)
• tokens: 💥 ✨ drop deprecated tokens (b82923a)
• UploadWizard: ✨ clean up spacing (1a062a8)
• UploadWizard: ✨ update UploadWizard to 1.43 (f241493)
• VisualEditor: ✨ update styles to 1.43 (c91135d)
• WikiEditor: ✨ add responsive handling for advanced toolbar (1f4045a)
• WikiEditor: ✨ update styles to 1.43 (808f7b1)

Bug Fixes

• CodeMirror: 🐛 fix text selection background color for links (#1007) (e66605f)
• CodeMirror: 🐛 override default dark mode color (32e78ff), closes #1001
• core: 🐛 do not invert mw-indicator (6f33824)
• core: 🐛 drop the use of Ski...

v2.40.2

2.40.2 (2025-01-01)

Bug Fixes

• overflowElements: 🐛 fix pinned sticky header on the top of the page (a09193c), closes #991

v2.40.1

2.40.1 (2024-12-31)

Bug Fixes

• CodeMirror: 🐛 fix incorrect highlight for VE CodeMirror (8aa185c)

v2.40.0

2.40.0 (2024-12-30)

🚨 This is the final release for MediaWiki 1.39. 🚨
We will bump the minimum requirements to MW 1.43 and start working on the 3.0 release for Citizen.

Citizen can now handles sticky header in overflow elements (e.g. tables)!
To make a sticky header, simply add the citizen-overflow-sticky-header class to the sticky element (table row if it is a table).
See the wiki for more examples.

Features

• overflowElements: ✨ add sticky header for overflow elements (#989) (dfdb2e6)
• SemanticResultFormats: ✨ add styles for fixedHeader (1c00950)
• SemanticResultFormats: ✨ update DataTables styles to match with current 5.0-dev version (dc49c64)

Bug Fixes

• core: 🐛 remove outline styles for focus-visible as it is not working as intended (f2cc4fd)
• core: 🐛 use break-word for word wrap (e8fc354)
• mediawiki: 🐛 fix hidden MW version in Special:Version (4fc1847)
• mediawiki: 🐛 fix incorrect Codex message wrapping in Special:UserLogin (576bcb6)
• mediawiki: 🐛 fix incorrect message box wrapping in Special:UserLogin (380f360)
• Popups: 🐛 fix Popups text gradient color (985df51)
• TinyMCE: 🐛 prevent TinyMCE editor from expanding limitlessly (a01001e), closes #978
• WikiEditor: 🐛 fix dark on dark link button in MW 1.43 (781822d)

v2.39.4

2.39.4 (2024-12-14)

Bug Fixes

• pageHeading: 🐛 fix incorrect indicator placement when displaytitle is used (504c237)
• pageHeading: 🐛 fix parenthesis for displaytitle (1a6e53c)
• pageHeading: 🐛 remove debug logging (3fe4e3d)

v2.39.3

2.39.3 (2024-12-03)

Features

• dropdown: ✨ use symbol when possible for keyhint (0d19f7f)

Bug Fixes

• DiscussionTools: 🐛 add wrapping hotfixes for DiscussionTools header for MW 1.42 (d71f31d)
• DiscussionTools: 🐛 fix incorrect color for timestamp (c52c1f2)
• header: 🐛 fix misalign home button in Safari (346b25e)
• mediawiki: 🐛 do not override link color on Special:Version (0c7a2d9)

Miscellaneous Chores

• 🔧 release 2.39.3 (d5e8076)

v2.39.2

2.39.2 (2024-11-17)

Bug Fixes

• core: 🐛 use mw.requestIdleCallback for polyfill (daef66f)