{"id":23972614,"url":"https://github.com/lockframe/firefox-winui","last_synced_at":"2026-05-22T17:02:01.464Z","repository":{"id":270287175,"uuid":"909883637","full_name":"Lockframe/Firefox-WinUI","owner":"Lockframe","description":"A custom CSS theme that transforms Firefox to seamlessly integrate with Windows 11's design language","archived":false,"fork":false,"pushed_at":"2026-03-26T10:44:43.000Z","size":1833,"stargazers_count":120,"open_issues_count":3,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-27T22:58:59.406Z","etag":null,"topics":["css","firefox","fluentdesign","js","mica","windows11","winui"],"latest_commit_sha":null,"homepage":"","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Lockframe.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-12-30T01:12:53.000Z","updated_at":"2026-03-27T18:17:00.000Z","dependencies_parsed_at":"2026-01-19T01:01:04.247Z","dependency_job_id":null,"html_url":"https://github.com/Lockframe/Firefox-WinUI","commit_stats":null,"previous_names":["lockframe/firefox-winui"],"tags_count":24,"template":false,"template_full_name":null,"purl":"pkg:github/Lockframe/Firefox-WinUI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lockframe%2FFirefox-WinUI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lockframe%2FFirefox-WinUI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lockframe%2FFirefox-WinUI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lockframe%2FFirefox-WinUI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Lockframe","download_url":"https://codeload.github.com/Lockframe/Firefox-WinUI/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lockframe%2FFirefox-WinUI/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31381009,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-03T21:40:47.592Z","status":"ssl_error","status_checked_at":"2026-04-03T21:40:05.436Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["css","firefox","fluentdesign","js","mica","windows11","winui"],"created_at":"2025-01-07T03:53:23.713Z","updated_at":"2026-04-03T23:02:23.976Z","avatar_url":"https://github.com/Lockframe.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Firefox-WinUI Theme\n\n*Firefox-WinUI* is a custom CSS theme that applies the Windows 11 design language to Firefox. It allows use of [mica and acrylic materials](https://learn.microsoft.com/en-us/windows/apps/design/signature-experiences/materials), and can extend Firefox with custom tweaks.\n\n![WinUI Firefox Theme Screenshot](screenshots/WinUI-Firefox.png)\n\n## Browser Support\n\nFirefox stable release is supported. Beta and Nightly may work, but support is limited.\n\n## Installation\n\n### Open Firefox profile folder\n\n1. Open [`about:support`](about:support)\n2. Find `Profile Folder` then click on `Open Folder`\n\n### Install Theme Files\n\n1. [Download the files](https://github.com/Lockframe/Firefox-WinUI/archive/refs/heads/main.zip) in this repository and extract the zip file\n2. Install the `spinner-font.tff` font on your system\n3. Copy the `chrome` folder and `user.js` file into your profile folder\n\n---\n\n### Optional Transparency\n\nThe theme allows use of **Mica**, which adds a translucent layer to the UI, and **Acrylic**, which blurs various elements, such as context menus, panels and dialogs.\n\nTo do this, open `about:config` and enable the following keys:\n\n- `widget.windows.mica`\n- `widget.windows.mica.popups` (Set to 1 or 2)\n- `browser.tabs.allow_transparent_browser` (⚠️ Extends the **Mica** backdrop into the new tab page area, but may cause issues in some web pages.)\n\n---\n\n## Settings\n\nCreate the following boolean or numeric keys as required:\n\n### Visual\n\n- `uc.winui.aptos` - Use the new MS Aptos font (Download and install the font from [here](https://www.microsoft.com/en-us/download/details.aspx?id=106087) first)\n- `uc.winui.borderless-bookmarks-bar` - Remove the border between the navbar and bookmarks bar\n- `uc.winui.centered-url` - Center aligns the URL in the URL Bar\n- `uc.winui.centered-url-alt` - Center aligns the URL in the URL Bar but moves it back to the left when selected\n- `uc.winui.extra-highlights` - Adds more highlights to the active tab and context menu\n- `uc.winui.hide-shortcuts` - Hide shortcut hints in menus and panels\n- `uc.winui.more-acrylic` - Extends the Acrylic texture into the navbar, bookmarks bar and the selected tab\n- `uc.winui.navbar-highlights` - Adds a highlight to the top of the navbar\n- `uc.winui.pill-urlbar` - URL bar corners are fully rounded\n- `uc.winui.rounded-corners` - Creates a gap with rounded corners between the web content and the browser frame (⚠️ You will not be able to scroll through the webpage while hovering over the margins. A [.uc.js script](https://github.com/Lockframe/Firefox-WinUI/blob/main/optional-js/scroll-in-browser-margins.uc.js) has been added to fix this)\n- `uc.winui.rounded-navbar` - Rounds the upper corners of the navbar\n- `uc.winui.shorter-titlebar-buttons` - Shrinks the titlebar buttons (close/maximize/restore/minimize) to match WinUI 2 apps\n- `uc.winui.smaller-toolbar-buttons` - Shrinks the toolbar buttons to match certain inconsistent WinUI apps (❌ Deprecated - Will be removed in the next release)\n- `uc.winui.taller-bookmarks` - Increase the size of the bookmarks bar to match File Explorer's toolbar (❌ Deprecated - Will be removed in the next release)\n- `uc.winui.taller-urlbar` - Increase the height of the URL bar to match the early iterations of Windows 11's search bar (❌ Deprecated - Will be removed in the next release)\n- `uc.winui.titlebar-style` - 1 to add rounded corners to the titlebar buttons and 2 to add rounded corners and accent-colored glyphs when hovering over them (⚠️ Incompatible with `uc.winui.shorter-titlebar-buttons`)\n- `uc.winui.transparent-urlbar` - Makes the URL bar transparent\n- `uc.winui.urlbar-extra-separators` - Add highlighted separators to either side of URL bar\n- `uc.winui.uc.winui.alternate-urlbar-dropdown` - Use an alternate detached version of the URL bar dropdown\n\n### Layout\n\n- `uc.winui.floating-tabs` - Disconnects the tabs from the navbar similar to Edge's deprecated Phoenix redesign\n- `uc.winui.extension-tray` - Compacts the extension menu into a grid of icons similar to the system tray found on Windows 11\n- `uc.winui.immersive-navbar` - Adds a margin to either side of the navbar to match the margin created by the rounded corners tweak\n- `uc.winui.tab-close-button` - Changes how tab close buttons are displayed, 1 to have it appear on the selected tab and when hovering unselected tabs, 2 to have it appear only when hovering a tab and 3 to remove it entirely\n- `uc.winui.transparent-navbar` - Enables Microsoft Edge's scrapped Phoenix redesign, with its own separate floating tabs implementation\n\n### Icon and Navigation\n\n- `uc.winui.mac-back-forward` - Changes the back/forward glyphs to the ones seen on MacOS\n\n### Experimental\n\n- `uc.winui.acrylic-animations` - Enables acrylic animations\n- `uc.winui.hide-with-1-tab` - Hides the tab bar if only one tab is open\n- `uc.winui.js-animations` - Enables animations that require external `.uc.js` files due to CSS limitations\n- `uc.winui.extra-animations` - Enables extra and unfinished animations\n- `uc.winui.experiments` - Enables experimental and unfinished features\n- `uc.winui.vtabs-close-button-style` - 1 to change the collapsed vertical tabs' close button into a small overlay on the top right and 2 to hide it entirely.\n- `uc.winui.alternate-urlbar-dropdown-animation` - Use an alternate, optionally staggered animation for the URL bar dropdown results. 1 for a smooth downward slide, 2 for a staggered downward slide and 3 for a staggered upward slide\n\n### Additional Customization\n\n- [Sidebery extension](https://github.com/mbnuqw/sidebery) can be customized with this theme. Paste the code from `sidebery-WinUI.css` into Sidebery's internal style editor.\n- [Follow this guide](https://github.com/MrOtherGuy/fx-autoconfig) to enable JS animations.\n\n### Restart Firefox\n\nSome settings may require a restart to apply. To ensure all settings are fully enabled, go to `about:support` and click `Clear startup cache...`.\n\n---\n\n## Inspiration and Credits\n\nThis theme integrates styling and features from:\n\n- [Edge-Frfox](https://github.com/bmFtZQ/Edge-FrFox) by [bmFtZQ](https://github.com/bmFtZQ)\n- [Firefox CSS Hacks](https://github.com/MrOtherGuy/firefox-csshacks) by [MrOtherGuy](https://github.com/MrOtherGuy)\n- [Firefox UWP Style](https://github.com/Guerra24/Firefox-UWP-Style) by [Guerra24](https://github.com/Guerra24)\n- [Shimmer](https://github.com/nuclearcodecat/shimmer) by [Nuclearcodecat](https://github.com/nuclearcodecat)\n- [WaveFox](https://github.com/QNetITQ/WaveFox/) by [QNetITQ](https://github.com/QNetITQ)\n\n---\n\n## Contributing\n\nBug reports, feature requests, and code contributions are always welcome.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flockframe%2Ffirefox-winui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flockframe%2Ffirefox-winui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flockframe%2Ffirefox-winui/lists"}