diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..91bb058
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,26 @@
+# Changelog
+All notable changes to this project will be documented in this file. See [conventional commits](https://www.conventionalcommits.org/) for commit guidelines.
+
+- - -
+## [v0.3.0](https://gitlab.com/TECHNOFAB/nixible/compare/v0.2.0..v0.3.0) - 2025-12-31
+#### Features
+- switch from flake-parts and devenv to rensa ecosystem - ([dcb87e8](https://gitlab.com/TECHNOFAB/nixible/commit/dcb87e8c3e09774cf878108ee58156d65abecd1e)) - [@TECHNOFAB](https://gitlab.com/TECHNOFAB)
+- add more options and generate docs for all options - ([8dccb9a](https://gitlab.com/TECHNOFAB/nixible/commit/8dccb9a9a84ba4542abc1d572d920471d3c33e51)) - [@TECHNOFAB](https://gitlab.com/TECHNOFAB)
+#### Bug Fixes
+- (**module**) typo - ([259818e](https://gitlab.com/TECHNOFAB/nixible/commit/259818ec96fa8ca9f36e0fbb04de2f500a5d96c6)) - [@TECHNOFAB](https://gitlab.com/TECHNOFAB)
+#### Documentation
+- update nixmkdocs, use svg logo, add style.css, set site_url - ([76c6d39](https://gitlab.com/TECHNOFAB/nixible/commit/76c6d3910049c6430bf02e065b6ca5896e5899f0)) - [@TECHNOFAB](https://gitlab.com/TECHNOFAB)
+#### Miscellaneous Chores
+- (**devShell**) add cocogitto - ([1ac485e](https://gitlab.com/TECHNOFAB/nixible/commit/1ac485e44206f483bbd3286fe6dfa046133d8cb2)) - [@TECHNOFAB](https://gitlab.com/TECHNOFAB)
+- (**lib**) update ansible-core - ([4e6694c](https://gitlab.com/TECHNOFAB/nixible/commit/4e6694ca64c41c06f500ad4cad9cb55f173efe8c)) - [@TECHNOFAB](https://gitlab.com/TECHNOFAB)
+- minor improvements like making inventory arg optional - ([0a0d354](https://gitlab.com/TECHNOFAB/nixible/commit/0a0d3549621a70f39eddeae7c404f60382f99c4d)) - [@TECHNOFAB](https://gitlab.com/TECHNOFAB)
+
+- - -
+
+## [v0.2.0](https://gitlab.com/TECHNOFAB/nixible/compare/v0.1.0..v0.2.0) - 2025-07-28
+#### Features
+- improve module by using freeformType and filtering unset options - ([ba08a45](https://gitlab.com/TECHNOFAB/nixible/commit/ba08a453ea26e16e6205e22a38070976cc6f3283)) - [@TECHNOFAB](https://gitlab.com/TECHNOFAB)
+
+- - -
+
+Changelog generated by [cocogitto](https://github.com/cocogitto/cocogitto).
diff --git a/nix/repo/devShells.nix b/nix/repo/devShells.nix
index 830dff5..36eeb3b 100644
--- a/nix/repo/devShells.nix
+++ b/nix/repo/devShells.nix
@@ -11,12 +11,15 @@
       alejandra.enable = true;
       mdformat.enable = true;
     };
-    settings.formatter.mdformat.command = let
-      pkg = pkgs.python3.withPackages (p: [
-        p.mdformat
-        p.mdformat-mkdocs
-      ]);
-    in "${pkg}/bin/mdformat";
+    settings.formatter.mdformat = {
+      excludes = ["CHANGELOG.md"];
+      command = let
+        pkg = pkgs.python3.withPackages (p: [
+          p.mdformat
+          p.mdformat-mkdocs
+        ]);
+      in "${pkg}/bin/mdformat";
+    };
   };
 in {
   default = devshell.mkShell {