diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..ca68cfb
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,29 @@
+# Changelog
+All notable changes to this project will be documented in this file. See [conventional commits](https://www.conventionalcommits.org/) for commit guidelines.
+
+- - -
+## [v0.1.0](https://gitlab.com/rensa-nix/core/compare/3aeff518bb9ebf0918a0bb013d66ee56fa415033..v0.1.0) - 2025-12-20
+#### Features
+- (**builder**) default to systems from inputs if exists - ([9ea903d](https://gitlab.com/rensa-nix/core/commit/9ea903dde6de65c85532995e5872ad7d2e6e6f5f)) - [@TECHNOFAB](https://gitlab.com/TECHNOFAB)
+- add support for wildcards (*) in filter & select - ([abe19f9](https://gitlab.com/rensa-nix/core/commit/abe19f9f13aff41de2b63304545c87d193d19ef4)) - [@TECHNOFAB](https://gitlab.com/TECHNOFAB)
+- add `transformInputs` which allows initializing inputs - ([9f20f8c](https://gitlab.com/rensa-nix/core/commit/9f20f8c94b09a1c85356f8340ebe0a339b0d32e6)) - [@TECHNOFAB](https://gitlab.com/TECHNOFAB)
+- add devshell and improve input handling of cells - ([c9c329e](https://gitlab.com/rensa-nix/core/commit/c9c329ec0f957ccb009af79315b80499fdc1a8c6)) - [@TECHNOFAB](https://gitlab.com/TECHNOFAB)
+#### Bug Fixes
+- (**loader**) fix infinite recursion oops - ([519ed97](https://gitlab.com/rensa-nix/core/commit/519ed97c97cb32996b63d2e20349a5d82ad2edc1)) - [@TECHNOFAB](https://gitlab.com/TECHNOFAB)
+- (**loader**) use correct output for cell param - ([c827a07](https://gitlab.com/rensa-nix/core/commit/c827a079978f44950e9db5f58e42b656e7dcbd4c)) - [@TECHNOFAB](https://gitlab.com/TECHNOFAB)
+#### Documentation
+- write docs, add README - ([a7e20e2](https://gitlab.com/rensa-nix/core/commit/a7e20e203c851f5298ee5ff98b79fe457f6d02d7)) - [@TECHNOFAB](https://gitlab.com/TECHNOFAB)
+- add style.css and logo - ([7f7c52d](https://gitlab.com/rensa-nix/core/commit/7f7c52d3836bbea7f992d6f0247a92f423e6d0a6)) - [@TECHNOFAB](https://gitlab.com/TECHNOFAB)
+- add docs base - ([b0eaa25](https://gitlab.com/rensa-nix/core/commit/b0eaa25b77631b111d71a41111b00a20ac03c33a)) - [@TECHNOFAB](https://gitlab.com/TECHNOFAB)
+#### Miscellaneous Chores
+- (**flake**) update flakes, add rensa devtools, etc. - ([11a2121](https://gitlab.com/rensa-nix/core/commit/11a21210d0b8c13aabfa15b97ba36465b808a009)) - [@TECHNOFAB](https://gitlab.com/TECHNOFAB)
+- add CI - ([39af3af](https://gitlab.com/rensa-nix/core/commit/39af3af902adda236a04f739fea73c5f29b4964f)) - [@TECHNOFAB](https://gitlab.com/TECHNOFAB)
+- add treefmt - ([9c1a29f](https://gitlab.com/rensa-nix/core/commit/9c1a29fa9ba7cbbb78b9e47eb8afbcd29303a3b4)) - [@TECHNOFAB](https://gitlab.com/TECHNOFAB)
+- update direnvrc - ([3406fdd](https://gitlab.com/rensa-nix/core/commit/3406fdda5b6e9d07913e6a2b7c4a561a61737689)) - [@TECHNOFAB](https://gitlab.com/TECHNOFAB)
+- remove lib attr in flake and expose functions directly - ([7222ac4](https://gitlab.com/rensa-nix/core/commit/7222ac48cd0aef1f8bb0f41493a69007aa08c1f0)) - [@TECHNOFAB](https://gitlab.com/TECHNOFAB)
+- minor improvements & add blocks - ([2774f3e](https://gitlab.com/rensa-nix/core/commit/2774f3ea91144eb7ae92a5b5eb3ff5a30b6a4c07)) - [@TECHNOFAB](https://gitlab.com/TECHNOFAB)
+- initial commit - ([3aeff51](https://gitlab.com/rensa-nix/core/commit/3aeff518bb9ebf0918a0bb013d66ee56fa415033)) - [@TECHNOFAB](https://gitlab.com/TECHNOFAB)
+
+- - -
+
+Changelog generated by [cocogitto](https://github.com/cocogitto/cocogitto).
\ No newline at end of file