Development Environment Configuration

A NixOS/nix-darwin dotfiles configuration providing a consistent, reproducible development environment across macOS and Linux using Nix flakes.

Main Features

• Keyboard Focused: Efficient tiling window management with Hyprland
• Minimal Distractions: Clean, focused interface design
• Configuration as Code: Everything managed through Nix flakes
• Modular Configuration: Enable apps and services via dotfiles.<name>.enable switches under a unified namespace
• Highly Customizable: Groupings (dotfiles.shell, dotfiles.gaming) compose atomic modules with mkDefault opt-out
• Reproducible: Identical environments across multiple machines
• Cross-Platform: Supports both NixOS and macOS (nix-darwin)
• Reusable: Flake exports homeManagerModules, nixosModules, and darwinModules for external consumers

Supported Systems

• NixOS Desktop (nixos-desktop): x86_64-linux gaming/development setup
• MacBook Pro (macbook-pro): aarch64-darwin mobile development environment

Core Tooling

System & Package Management

• Nix Flakes: Reproducible package management and system configuration
• Home Manager: User environment management

Window Management & Desktop

• Hyprland: Dynamic tiling Wayland compositor
• Ultrashell: Feature-rich status bar
• SDDM: Display manager (NixOS)
• Ghostty: Fast, GPU-accelerated terminal emulator

Development Environment

• Neovim: Extensible text editor with custom configuration
• TMUX: Terminal multiplexer with custom scripts
• Zsh + Oh My Posh: Enhanced shell experience
• LazyGit: Terminal UI for Git operations
• Yazi: Blazing fast terminal file manager

Additional Tools

• Volta: JavaScript toolchain manager
• Bat: Enhanced cat with syntax highlighting
• Fuzzel: Application launcher for Wayland
• Karabiner Elements: Keyboard customization (macOS)

Theming

• Catppuccin Mocha: Consistent pastel theme across all applications, sourced from a single palette via config.dotfiles.palette
• Custom wallpapers: Curated collection in assets/

Module System

Modules are activated via dotfiles.<name>.enable boolean switches under a single flat namespace. Each module declares its own enable option and wraps its configuration in mkIf. Hosts flip switches instead of importing module paths.

Atomic Modules

Single-app modules that configure one application:

dotfiles.git.enable = true;
dotfiles.neovim.enable = true;
dotfiles.fuzzel.enable = true;

Groupings

Grouping modules compose several atomic modules under one switch. Members cascade via mkDefault, so a host can opt out of any member by setting it to false:

dotfiles.shell.enable = true;  # enables zsh, tmux, oh-my-posh, bat, btop, yazi, git 
dotfiles.git.enable = false;  # opt out of one member

Cross-Layer

Apps that span both NixOS and Home Manager (e.g. Hyprland) get two switches with the same name in separate eval contexts — both must be enabled:

# configuration.nix (NixOS)
dotfiles.hyprland.enable = true;

# home.nix (Home Manager)
dotfiles.hyprland.enable = true;
dotfiles.hyprland.monitors = [ "DP-1, 5120x1440@119.98Hz, auto, auto, bitdepth, 8, cm, auto" ];

Flake Exports

The flake exports default module aggregations for external consumers. Each default imports all atomic modules in its layer, so consumers only need default and then enable what they want via dotfiles.<name>.enable:

• homeManagerModules.default — all home-manager modules
• nixosModules.default — all NixOS modules
• darwinModules.default — all darwin modules
• dotfilesPkgs.<system> — packages this flake provides (locally-built + wrapped from inputs)

External consumer example:

{
  inputs.dotfiles.url = "github:fveracoechea/dotfiles";
  inputs.home-manager.url = "github:nix-community/home-manager";

  outputs = { self, nixpkgs, home-manager, dotfiles, ... }: {
    homeConfigurations."me@laptop" = home-manager.lib.homeManagerConfiguration {
      pkgs = nixpkgs.legacyPackages.x86_64-linux;
      extraSpecialArgs = {
        dotfilesPkgs = dotfiles.dotfilesPkgs.x86_64-linux;
      };
      modules = [
        dotfiles.homeManagerModules.default
        {
          dotfiles.shell.enable = true;
          dotfiles.neovim.enable = true;
        }
      ];
    };
  };
}

Installation

1. Clone the repository:

   git clone https://github.com/fveracoechea/dotfiles.git ~/.config/dotfiles
   cd ~/.config/dotfiles

2. Apply configuration:

   For NixOS:

   sudo nixos-rebuild switch --flake .#nixos-desktop

   For macOS:

   darwin-rebuild switch --flake .#macbook-pro

3. Test configuration (optional):

   # NixOS
   sudo nixos-rebuild test --flake .#nixos-desktop
   
   # macOS
   darwin-rebuild check --flake .#macbook-pro

Repository Structure

├── hosts/                    # Host-specific configurations
│   ├── nixos-desktop/       # NixOS desktop configuration
│   └── macbook-pro/         # macOS configuration
├── modules/                  # Reusable configuration modules
│   ├── core/                # Cross-cutting options (palette)
│   ├── nixos/               # NixOS-specific modules
│   ├── darwin/              # macOS-specific modules
│   └── home-manager/        # User environment modules
├── packages/                # Custom packages (locally-built + wrapped from inputs)
└── flake.nix               # Main flake configuration

Documentation

• Architecture Decision Records — decisions on module structure, theming, macOS package split, and the dotfiles.* enable namespace.
• CONTEXT.md — domain glossary for the repository.

License

This configuration is provided as-is for educational and personal use.