black7375 /Firefox-UI-Fix

🦊 I respect proton UI and aim to improve it.

★ 5,925⑂ 203👁 54⑃ 125● 950▤ 77
SCSSMPL-2.0Created 2021-04-26
下载:v8.7.6v8.7.6 ↓8.7.62026-09-06
+1
日增长
5,925
stars
203
forks
54
watchers
125
prs
950
issues
77
releases

README

Lepton (old name: Proton Fix)

Table of Contents

- Lepton (old name: Proton Fix)
  - Introduction
  - Installation Guide
  - WHY Proton?
  - WHY Not Proton?
  - Padding Comparisons
  - Sponsors & Contributors
  - Bug / Questions?
  - FAQ

---

🔔🔔 Does the theme not work after installation?

You should copy user.js file before the theme works.

The option system depends on user configuration, and nothing applies without settings. \
Also, real-time changes are difficult because of technical limitations and require a restart.

Some settings can be conflicted and should be explicitly set to false.

---

🔔🔔 Is your Firefox version v102 or lower?

You have to set userChrome.compatibility.accent_color to true additionally.

---

 Introduction

Proton is Firefox's new design, starting from Firefox 89. \
Photon is the old design of Firefox which was used until version 88.

Proton's overall feel is good, but there were a few things I didn't like and wanted to improve. \
That's why this project was born, and Lepton to denote light theme layer.

Disclaimer: It works on Firefox 89 and above!!

| Wiki | | | | | | |
| --- | --- | --- | --- | --- | --- | --- |
| Installation Guide | Screenshots | Tutorial | Options | Compatibility Issues Solution | Tips | Show Off Your Config |

!Lepton's design

(Lepton's design :arrow_up:)


Feature List (Click)

- Color
  - Default light/dark theme contrast enhancement
  - Colorful context menu
  - More dark mode support
  - Windows/Mac/Linux system theme support
  - Windows 7 compatibility
- Icons
  - Panel
  - Context Menu
  - Global Menu
  - Library's open context
  - Video Player
- Padding Narrower
  - Tab
  - Panel
  - Menu
  - Density
  - Others…
- Tab Bar Layouts
  - Tabs on Bottom
  - One Liner
  - Vertical Tab Support
- Tab Design
  - General:
    - Connect with toolbar (buttons like tabs)
  - Selected:
    - Box Shadow: Highlight the selected tab
    - Bottom Rounding: Natural
  - MultiSelected
    - Adjust Color: Easily recognizable
  - Unselect:
    - Divide Line: React to hover like chrome
  - Unloaded:
    - Dimmed: Looks like inactive
  - Clipped:
    - Clearer Text: Adjusted clipped gradation
    - Closed Button: Visible on hover
  - Sound:
    - Remove Second Label
    - Show Favicon: Always show favicon
    - PIP Icon
  - Container Tab:
    - Highlight line position: Displayed under tab
- Button Design
  - New tab: Looks like tab
- Activity Stream Design
  - Search Bar:
    - Focused Shadow: Same as the accent color
    - Hand off to Awesomebar
  - Icons:
    - Size: Fill (Changes dynamically to your size)
- Error Page Design
  - Illustrations: Restore error page illustrations
- Video Player
  - Background Style
  - Size at fullscreen
- Fullscreen
  - Overlap mode
- Others
  - Animations
  - Hidden & Auto Hide
  - Activate calculator at address bar
  - Mouse pointer for each context



 Installation Guide

Installation script (experimental)

Linux/Mac users:

bash
bash -c "$(curl -fsSL https://raw.githubuse

Top issues

Discussions

Latest release

v8.7.6 v8.7.6 2026-09-06
Changed

  Improved compatibility with the latest Firefox features, including Split View and toolbar variable changes.
  Installation scripts now support more Firefox and LibreWolf environments across Linux and Windows.

   Compatibility

  - Tab: Support Split View 1bd41b7
  - Toolbar: Color compatibility improvements 72be27c
  - Toolbar: Support the latest Firefox and ESR padding variables 1182
    - contribute by @stefanwimmer128
  - Auto-hide: Restore page space when the navbar or toolbar is hidden 1180 1183
    - contribute by @lucassilvas1
  - Content: Fix rounded corners fo

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON