The Uncompromising Nix Code Formatter

Try it on your browser! here

• ✔️ Fast

  It's written in Rust and formats Nixpkgs in just a few seconds. ¹

• ✔️ Powerful

  We define a comprehensive style for all possible combinations of the Nix expression language.

• ✔️ Reliable

  High coverage, battle tested.

  From Nix's eyes, code is just the same. ²

• ✔️ Beautiful

  Beauty is subjective, right?

  We started from the original style of Nixpkgs, and then we applied the feedback of developers who have used Nix at scale for several years, producing a very well-grounded style guide.

• ✔️ Transparent

  You won't notice the formatter after a while.

  Humans care about the content, machines about the style!

• ✔️ Native

  We integrate with common code editors and workflows:

  • Visual Studio Code
  • Neovim
  • Vim
  • GNU Emacs
  • Doom Emacs
  • Pre-commit
  • Pre-commit-hooks.nix

Please visit: kamadorueda.github.io/alejandra.

You can download a binary for your platform:

• aarch64-unknown-linux-musl
• armv6l-unknown-linux-musleabihf
• armv7l-unknown-linux-musleabihf
• i686-unknown-linux-musl
• x86_64-unknown-linux-musl

Make it executable ($ chmod +x) and run Alejandra with:

$ ./alejandra --help

or:

$ /path/to/alejandra --help

Please visit: search.nixos.org/packages?query=alejandra.

• Nix stable:

  $ nix-env -ivf https://github.com/kamadorueda/alejandra/tarball/3.0.0

• Nix with Flakes:

  $ nix profile install github:kamadorueda/alejandra/3.0.0

Then run Alejandra with:

$ alejandra --help

• Nix stable:

  let
    alejandra =
      (import (builtins.fetchTarball {
        url = "https://github.com/kamadorueda/alejandra/tarball/3.0.0";
        sha256 = "0000000000000000000000000000000000000000000000000000";
      }) {})
      .outPath;
  in {
    environment.systemPackages = [alejandra];
  }

• Nix with Flakes:

  {
    inputs = {
      nixpkgs.url = "github:nixos/nixpkgs/nixpkgs-unstable";
  
      alejandra.url = "github:kamadorueda/alejandra/3.0.0";
      alejandra.inputs.nixpkgs.follows = "nixpkgs";
    };
  
    outputs = {alejandra, nixpkgs, ...}: {
      nixosConfigurations = {
        example = nixpkgs.lib.nixosSystem rec {
          # We support: aarch64-darwin, aarch64-linux, i686-linux, x86_64-darwin, x86_64-linux
          system = "x86_64-linux";
  
          modules = [
            {
              environment.systemPackages = [alejandra.defaultPackage.${system}];
            }
            # Import your other modules here
            # ./path/to/my/module.nix
            # ...
          ];
        };
      };
    };
  }

• No.

• RFC 0101 - Nix formatting

• NixEL
• Santiago
• rnix-parser

• nixpkgs-fmt
• nixfmt

See why Alejandra was created and a comparison between alternatives here.

Alternatively, checkout the code examples of the different formatters here.

We use semver to version Alejandra.

Our public API consists of:

• The formatting rules (a.k.a. the style).
• The CLI tool ($ alejandra), command line flags, positional arguments, exit codes, and stdout.

Please read: CHANGELOG.

The following people have helped improving Alejandra.

Thank you ❤️

• Kevin Amado ~ Email, LinkedIn.
• Thomas Bereknyei.
• Piegames.
• Joachim Ernst.
• David Arnold.
• David Hauer.
• Ryan Mulligan.
• Fabian Möller.
• Rok Garbas.
• Yorick van Pelt.
• Rehno Lindeque.
• Rebecca Turner.
• Jörg Thalheim.
• Nathan Henrie.
• Vincent Ambo.
• Jamie Quigley.
• Loïc Reynier.
• Mr Hedgehog.
• Tobias Bora.
• Tristan Maat.
• Victor Engmark.
• Norbert Melzer.
• Patrick Stevens.
• Connor Baker.
• Matthew Kenigsberg.
• Florian Finkernagel.