feat: add nix fmt

Author: daniqss

README.md

@@ -207,12 +207,43 @@ npm test
 
 ### Formatting and Linting
 
+You can format and lint the entire project at once using **Nix** (if you have it installed and flakes enabled):
+
+```bash
+# Format and lint everything (Python, JavaScript, Nix)
+nix fmt
+```
+
+Alternatively, you can run the tools individually for each language:
+
+#### Python (ruff)
+
+```bash
+# Format Python code
+ruff format .
+
+# Lint and fix Python code
+ruff check --fix .
+```
+
+#### Nix (alejandra)
+
+```bash
+# Format Nix files
+alejandra .
+```
+
+#### JavaScript & Assets (ESLint/Prettier)
+
 ```bash
 # Lint the project
 npm run lint
 
 # Format the code
 npm run format
+
+# Lint and fix JavaScript
+npm run lint:fix
 ```
 
 ## License

docs/usage/book.md

@@ -55,13 +55,15 @@ Hi
 This examples are available in the [template](https://github.com/daniqss/stepcode/tree/main/template) folder of the repository.
 
 ### nix
+
 If you are a [nix](https://nixos.org/download/) user, the repo flake exposes a `devShell` to download all the dependencies and have a ready to use environment. You can enter it with:
 
 ```sh
 nix develop .
 ```
 
 # Template
+
 Furthermore, the template book is available using:
 
 ```sh

flake.nix

@@ -31,6 +31,7 @@
           python314
           uv
           ruff
+          alejandra
 
           nodejs
         ];
@@ -41,6 +42,19 @@
       };
     });
 
+    formatter = eachSystem (pkgs:
+      with pkgs;
+        writeShellScriptBin "format" ''
+          set -e
+          ${alejandra}/bin/alejandra .
+
+          ${ruff}/bin/ruff format .
+          ${ruff}/bin/ruff check --fix .
+
+          npm run format
+          npm run lint:fix
+        '');
+
     templates.default = {
       path = ./template;
       description = "basic template to create a new stepcode book";

template/index.md

@@ -5,6 +5,7 @@ title: My blog about stepcode
 # {{title}}
 
 ## my posts
+
 - [first post](./blog/first-post.html)
 - [second post](./blog/second-post.html)
-- [first recipe](./cooking/first-recipe.html)
+- [first recipe](./cooking/first-recipe.html)