nix-dev-tools

Shared Nix development environment with formatters, linters, LSP servers, and pre-commit hooks.

What's Included

• nixfmt-rfc-style - automatic Nix formatting
• statix - Nix linter and static analysis
• deadnix - find unused code in Nix files
• nil - Nix LSP with semantic diagnostics (catches duplicate attrs, undefined vars)
• nixd - Nix LSP server with flake-aware option completions
• pre-commit hooks - nixfmt, statix, deadnix, and nil run automatically on commit

Integration

1. Add the input to your flake

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixpkgs-unstable";

    dev-tools = {
      url = "github:boozedog/nix-dev-tools";
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };

  outputs = { self, nixpkgs, dev-tools, ... }:
    # ...
}

2. Add the devShell

outputs = { self, nixpkgs, dev-tools, ... }:
{
  # Your other outputs...

  devShells.aarch64-darwin.default = dev-tools.lib.mkDevShell {
    system = "aarch64-darwin";
    src = ./.;
  };

  # Add other systems as needed
  devShells.x86_64-linux.default = dev-tools.lib.mkDevShell {
    system = "x86_64-linux";
    src = ./.;
  };
};

3. Update your flake lock

nix flake update dev-tools

4. Enter the dev shell

nix develop

On first run, pre-commit hooks will be installed automatically.

Full Example

Here's a complete minimal flake using nix-dev-tools:

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixpkgs-unstable";

    dev-tools = {
      url = "github:boozedog/nix-dev-tools";
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };

  outputs = { self, nixpkgs, dev-tools, ... }:
    let
      system = "aarch64-darwin";  # or your system
    in
    {
      # Your NixOS/darwin/home-manager configurations here...

      devShells.${system}.default = dev-tools.lib.mkDevShell {
        inherit system;
        src = ./.;
      };
    };
}

Adding Project-Specific Packages

You can extend the dev shell with additional packages:

devShells.${system}.default = dev-tools.lib.mkDevShell {
  inherit system;
  src = ./.;
  extraPackages = with nixpkgs.legacyPackages.${system}; [
    nodejs
    yarn
    jq
  ];
  shellHook = ''
    echo "Welcome to my project!"
  '';
};

Available Functions

Function	Description
lib.mkDevShell { system, src, extraPackages?, shellHook? }	Creates a dev shell with all tools
lib.mkPreCommitHooks system src	Returns pre-commit hook configuration

Supported Systems

• aarch64-darwin (Apple Silicon Mac)
• x86_64-darwin (Intel Mac)
• aarch64-linux (ARM Linux)
• x86_64-linux (x86 Linux)