jessfraz/dotfiles is a dotfiles repository that manages shell configuration and development environment setup across multiple systems.
The repository addresses the problem of maintaining consistent shell environments and tool configurations across different machines and architectures. It provides installation mechanisms for both Nix-based and legacy Linux systems, with the Nix approach using Home Manager to manage dotfiles declaratively. The legacy installation creates symlinks from the repository to the home directory. Users can customize their setup by defining environment variables and other settings in a `.extra` file that the configuration sources at startup.
The tool suits developers who want a reproducible shell environment across machines, particularly those already using Nix and Home Manager. The Nix-based approach is the primary installation method, with Home Manager handling username, home directory, and state version configuration. The repository separates Vim configuration into a dedicated repository, so developers needing extensive editor customization should reference that separately. The legacy Linux installation option provides an alternative for systems not using Nix, though the primary development focus appears to be on the Nix integration.
The project maintains test coverage across multiple architectures and platforms. Native Nix checks run against a complete Home Manager fixture and include an editor smoke test to verify basic functionality. Shell scripts are validated with shellcheck in a container environment. CI builds these checks on x86-64 Linux, ARM Linux, and ARM macOS to ensure compatibility across different system architectures.
