User Applications

User application modules provide declarative configuration for common desktop applications. All modules are opt-in and can be enabled individually.

Enabling User Applications

The top-level userapps.enable option enables profile-sync-daemon for browser optimization:

userapps.enable = true;

This enables:

Profile Sync Daemon (psd) - Syncs browser profiles to tmpfs for improved performance
Resync interval: 10 minutes

Browsers

Multiple browsers can be installed simultaneously. Priority values determine which becomes the default.

Available Browsers

LibreWolf

Privacy-focused Firefox fork with pre-configured privacy settings.Priority: 10 (highest by default)

Firefox

Mozilla Firefox with FF-ULTIMA theme and privacy extensions.Priority: 20

Floorp

Japanese Firefox-based browser with unique features.Priority: 30

Google Chrome

Google’s browser (binary distribution).Priority: 100 (lowest, fallback)

Common Options

userapps.browsers.<browser>.enable

boolean

default:"false"

Enable the browser.

userapps.browsers.librewolf.enable = true;

userapps.browsers.<browser>.priority

int

Priority for becoming the default browser. Lower values win.

userapps.browsers.firefox.priority = 15;  # Higher priority than default

Firefox-based Browsers

LibreWolf, Firefox, and Floorp share common configuration:

Search Engines

All Firefox-based browsers include custom search engines:

DuckDuckGo (default) - Privacy-focused search
Nix Packages (@np) - Search NixOS packages
Nix Options (@no) - Search NixOS options
NixOS Wiki (@nw) - Search the NixOS wiki

Google and Bing are hidden by default.

Extensions

Pre-installed extensions:

uBlock Origin - Ad and tracker blocking
Privacy Badger - Intelligent tracker blocking
Bitwarden - Password manager integration

Theme

Firefox-based browsers use the FF-ULTIMA theme for a modern, minimalist interface.

Example Configuration

userapps = {
  defaultApplications.enable = true;  # Set XDG default applications
  
  browsers = {
    librewolf = {
      enable = true;
      priority = 10;  # Default browser
    };
    firefox = {
      enable = true;
      priority = 20;  # Installed but not default
    };
    chrome = {
      enable = true;
      priority = 100; # Fallback
    };
  };
};

Chrome Configuration

Chrome has a special default behavior:

userapps.browsers.chrome.enable = true;  # Auto-enables if no other browsers enabled

This ensures at least one browser is always available.

Communication

Communication applications for messaging and collaboration.

Discord

userapps.communication.discord.enable

boolean

default:"false"

Enable Discord client (Vesktop).

userapps.communication.discord.enable = true;

Uses Vesktop - A Discord client with Vencord pre-installed for enhanced features and customization.

Development Tools

Comprehensive development environment configuration.

Enabling Development Tools

userapps.development.enable

boolean

default:"false"

Enable development tools and configure environment.

userapps.development.enable = true;

This enables:

npm with local bin directory in PATH (~/.npm/bin)
uv - Fast Python package installer and resolver

Text Editors

Editor modules support priority-based defaults for EDITOR and VISUAL environment variables.

Neovim

userapps.development.editors.neovim.enable

boolean

default:"false"

Enable Neovim editor.

userapps.development.editors.neovim.enable = true;

userapps.development.editors.neovim.priority

int

default:"20"

Priority for being the default editor.

userapps.development.editors.neovim.priority = 10;

userapps.development.editors.neovim.settings

attrset

default:"{}"

Neovim configuration settings passed to nvf.

userapps.development.editors.neovim.settings = {
  vim.viAlias = true;
  vim.vimAlias = true;
  vim.lsp.enable = true;
};

Neovim is configured using the nvf (NeoVim Flake) framework, which provides a type-safe, modular configuration system. Example from homes/soriphoono:

userapps.development.editors.neovim.settings = import ./nvim {inherit pkgs;};

VSCode / VSCodium

userapps.development.editors.vscode.enable

boolean

default:"false"

Enable VSCode/VSCodium editor.

userapps.development.editors.vscode.enable = true;

userapps.development.editors.vscode.package

package

default:"pkgs.vscodium"

The VSCode package to use.

userapps.development.editors.vscode.package = pkgs.vscode;

userapps.development.editors.vscode.desktop

string

default:"codium.desktop"

The desktop file name for XDG integration.

userapps.development.editors.vscode.desktop = "code.desktop";

userapps.development.editors.vscode.priority

int

default:"30"

Priority for being the default editor. Lower priority than terminal editors by default.

userapps.development.editors.vscode.priority = 25;

AI Agents

AI agent configuration modules for LLM integration.

userapps.development.agents = {
  # Future: MCP server configuration
  # Future: Skills configuration
  # Future: Gemini client configuration
};

Located in modules/home/userapps/development/agents/:

mcp-servers.nix - Model Context Protocol server management
skills.nix - Agent skill definitions
clients/gemini.nix - Google Gemini API client

Development Categories

The development module structure includes:

development/
├── agents/              # AI agent configurations
├── editors/             # Text editors (Neovim, VSCode, etc.)
├── domain_specific/     # Domain tools (k8s, etc.)
├── terminal/            # Terminal emulators (Kitty, Ghostty, Warp)
├── knowledge-management/  # Obsidian, etc.
└── disk_tools/          # Disk utilities

Example Configuration

userapps.development = {
  enable = true;
  
  editors = {
    neovim = {
      enable = true;
      priority = 10;
      settings = {
        vim.viAlias = true;
        vim.vimAlias = true;
      };
    };
    
    vscode = {
      enable = true;
      priority = 20;
      package = pkgs.vscode;
    };
  };
};

Data Fortress

Security and cloud storage applications.

Bitwarden

userapps.data-fortress.bitwarden.enable

boolean

default:"false"

Enable Bitwarden desktop client.

userapps.data-fortress.bitwarden.enable = true;

Installs the official Bitwarden desktop application for password management.

Nextcloud

userapps.data-fortress.nextcloud.enable

boolean

default:"false"

Enable Nextcloud sync client.

userapps.data-fortress.nextcloud.enable = true;

Installs the Nextcloud desktop client for file synchronization.

Example

userapps.data-fortress = {
  bitwarden.enable = true;
  nextcloud.enable = true;
};

Office Suite

Productivity applications (configured in modules/home/userapps/office/).

userapps.office = {
  # Office applications configuration
};

Default Applications

Control XDG MIME type associations.

userapps.defaultApplications.enable

boolean

default:"false"

Enable setting default applications via Nix configuration.

userapps.defaultApplications.enable = true;

When enabled, modules can set XDG MIME type defaults based on priority values. This affects:

Default web browser for HTTP/HTTPS links
Default text editor for plain text and code files
Other file type associations

Disable this if you prefer to manage default applications through your desktop environment.

Complete Example

A comprehensive user applications configuration:

userapps = {
  enable = true;
  defaultApplications.enable = true;
  
  browsers = {
    librewolf.enable = true;  # Default browser (priority 10)
    firefox.enable = true;    # Alternative (priority 20)
  };
  
  communication = {
    discord.enable = true;
  };
  
  development = {
    enable = true;
    
    editors = {
      neovim = {
        enable = true;
        priority = 10;  # Default editor
        settings = import ./nvim-config.nix;
      };
      
      vscode = {
        enable = true;
        priority = 30;
        package = pkgs.vscode;
      };
    };
  };
  
  data-fortress = {
    bitwarden.enable = true;
    nextcloud.enable = true;
  };
};

NixOS Modules

Home Manager Modules

Nix-on-Droid Modules

Enabling User Applications

Browsers

Available Browsers

LibreWolf

Firefox

Floorp

Google Chrome

Common Options

Firefox-based Browsers

Search Engines

Extensions

Theme

Example Configuration

Chrome Configuration

Communication

Discord

Development Tools

Enabling Development Tools

Text Editors

Neovim

VSCode / VSCodium

AI Agents

Development Categories

Example Configuration

Data Fortress

Bitwarden

Nextcloud

Example

Office Suite

Default Applications

Complete Example

Build docs developers (and LLMs) love

NixOS Modules

Home Manager Modules

Nix-on-Droid Modules

​Enabling User Applications

​Browsers

​Available Browsers

LibreWolf

Firefox

Floorp

Google Chrome

​Common Options

​Firefox-based Browsers

​Search Engines

​Extensions

​Theme

​Example Configuration

​Chrome Configuration

​Communication

​Discord

​Development Tools

​Enabling Development Tools

​Text Editors

​Neovim

​VSCode / VSCodium

​AI Agents

​Development Categories

​Example Configuration

​Data Fortress

​Bitwarden

​Nextcloud

​Example

​Office Suite

​Default Applications

​Complete Example

Build docs developers (and LLMs) love

Enabling User Applications

Browsers

Available Browsers

Common Options

Firefox-based Browsers

Search Engines

Extensions

Theme

Example Configuration

Chrome Configuration

Communication

Discord

Development Tools

Enabling Development Tools

Text Editors

Neovim

VSCode / VSCodium

AI Agents

Development Categories

Example Configuration

Data Fortress

Bitwarden

Nextcloud

Example

Office Suite

Default Applications

Complete Example