firefox-nixCfg

KO | EN

gitlite — search

#python #javascript #nodejs #java #react #typescript #database #machine-learning #react-native #vuejs #android #golang

★ 26 Open GitHub ↗

A declarative Firefox configuration using Nix home-manager, designed for enhanced performance, a streamlined UI, and powerful automation

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align='center'>firefox-nixCfg</h1>
<div align='center'>
    <p>A declarative Firefox configuration using Nix home-manager, designed for enhanced performance, a streamlined UI, and powerful automation.</p>
    <div align='center'>
        <a href='https://github.com/DivitMittal/firefox-nixCfg'>
            <img src='https://img.shields.io/github/repo-size/DivitMittal/firefox-nixCfg?&style=for-the-badge&logo=github'>
        </a>
        <a href='https://github.com/DivitMittal/firefox-nixCfg/blob/main/LICENSE'>
            <img src='https://img.shields.io/static/v1.svg?style=for-the-badge&label=License&message=MIT&logo=unlicense'/>
        </a>
    </div>
    <br>
</div>

---

---

## Table of Contents

- [Features](#features)
  - [Performance & Security (Betterfox)](#performance--security-betterfox)
  - [UI/UX & CSS Hacks](#uiux--css-hacks)
  - [Automation](#automation)
  - [Sidebery Integration](#sidebery-integration)
  - [Tridactyl Integration](#tridactyl-integration)
- [Flakes Usage](#flakes-usage)
- [Related Repositories](#related-repositories)

---

This Nix flake-based configuration provides a highly customized and declarative Firefox configuration, managed through a [home-manager](https://github.com/nix-community/home-manager) module. It focuses on delivering a superior browsing experience by integrating performance enhancements, UI/UX improvements, and automation scripts.

## Features

### Performance & Security (Betterfox)

The configuration incorporates hardened user preferences from [Betterfox](https://github.com/yokoffing/Betterfox), deployed via [betterfox-nix](https://github.com/HeitorAugustoLN/betterfox-nix). This generates a comprehensive `user.js` file within the Firefox profile, responsible for enhancing performance, removing distracting UI elements, and strengthening security and privacy.

### UI/UX & CSS Hacks

The user interface is heavily customized to be minimal, clean, & efficient, largely based on styles from [MrOtherGuy/firefox-csshacks](https://github.com/MrOtherGuy/firefox-csshacks).

- **Minimalist Design:** The tab bar is hidden, and the URL bar is streamlined for a distraction-free look.
- **Custom Styles:** Additional CSS tweaks are applied to refine margins and element spacing for a polished feel.
- **Declarative Theming:** All `userChrome.css` and `userContent.css` files are managed directly by Nix.

![Custom Firefox UI](https://raw.githubusercontent.com/DivitMittal/firefox-nixCfg/main/assets/ui.png)

### Automation

This module leverages [MrOtherGuy/fx-autoconfig](https://github.com/MrOtherGuy/fx-autoconfig) to automatically load custom user scripts (`*.uc.js`) and CSS at startup. While `fx-autoconfig` normally requires a manual, procedural setup, this module packages it into a declarative, Nix-based configuration, simplifying management and ensuring reproducibility.

### Sidebery Integration

Advanced functionality is added via JavaScript user scripts (`*.uc.js`), enabling powerful UI automation for the [Sidebery](https://addons.mozilla.org/en-US/firefox/addon/sidebery/) extension.

- **Collapsible Sidebar:** The sidebar can be automatically collapsed and expanded on hover or by holding the `Ctrl` key, maximizing screen real estate without sacrificing functionality.

![Sidebery Automation GIF](https://raw.githubusercontent.com/DivitMittal/firefox-nixCfg/main/assets/sidebar.gif)

### Tridactyl Integration

For keyboard-driven power users, the configuration includes a custom theme and setup for the [Tridactyl](https://github.com/tridactyl/tridactyl) extension, providing a seamless Vim-like browsing experience.

![Tridactyl Theme GIF](https://raw.githubusercontent.com/DivitMittal/firefox-nixCfg/main/assets/tridactyl.gif)

## Flakes Usage

Add the flake input and import `homeManagerConfigurations.default` directly into your home-manager modules list. The module is automatically imported — no extra wiring needed:

```nix
## flake.nix
{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixpkgs-unstable";
    home-manager.url = "github:nix-community/home-manager";
    firefox-nixCfg.url = "github:DivitMittal/firefox-nixCfg";
  };

outputs = { nixpkgs, home-manager, firefox-nixCfg, ... }: {
    homeConfigurations.your-user = home-manager.lib.homeManagerConfiguration {
      pkgs = nixpkgs.legacyPackages.x86_64-linux;
      modules = [
        firefox-nixCfg.homeManagerConfigurations.default
        ./home.nix
      ];
    };
  };
}
```

Then configure the available options in your `home.nix`:

```nix
## home.nix
{
  programs.firefox-nixCfg = {
    enableTridactyl = true;     # optional — enables Tridactyl vim keybindings
    package = pkgs.firefox-bin; # optional — override the Firefox package
  };
}
```

**macOS Support:** For macOS, this module defaults to using a pre-built Firefox binary from the [nixpkgs-firefox-darwin](https://github.com/bandithedoge/nixpkgs-firefox-darwin) overlay, ensuring a native and optimized experience.

## Related Repositories

- [DivitMittal/OS-nixCfg](https://github.com/DivitMittal/OS-nixCfg): Infrastructure NixOS/nix-darwin configurations repository

## For AI Agents

Context files (`AGENTS.md`, `CLAUDE.md`) are generated — not committed. Run `apm compile` before exploring the repo to get directory-level guidance.

firefox-nixCfg

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README