This branch (
main) is unstable and under active development. Palefox is evolving toward heavy use of JavaScript (via fx-autoconfig) for features that CSS alone can't handle cleanly — like proper autohide state management and a keyboard-driven command palette.For the stable, CSS-only theme, use the
stable-pure-cssbranch.
Please see security considerations before installing
Install Sideberry, then run:
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/tompassarelli/palefox/main/install.sh | bashWindows (PowerShell):
irm https://raw.githubusercontent.com/tompassarelli/palefox/main/install.ps1 | iexLibreWolf: add --librewolf to either command.
See the full installation guide for manual install, flags, and details.
The CSS-only approach to features like autohide pushed the stylesheet into increasingly complicated selector chains that are fragile and hard to maintain. JS support opens the door to implementing these behaviors properly — and to ideas like a keyboard-driven centered command palette rather than the current mouse-first sidebar UX.
This branch includes:
- Vendored fx-autoconfig loader (v0.10.14)
chrome/JS/directory for userChrome scripts- Updated install scripts and Nix module with
jsLoaderoption
- Extensions are privileged software — install only ones you trust
- Zen Mode can hide browser security indicators; verify pages before browsing with the UI hidden
- Review install scripts before piping them into your shell
- The JS loader on
mainruns chrome-privileged code — review scripts inchrome/JS/before use - Palefox is a UI customization, not a security tool — use it with normal caution
Palefox draws inspiration from:
- Zen Browser — sidebar design
- GWfox — CSS theming techniques
- FF-ULTIMA — feature and layout ideas
- parfait — findbar and accessibility