diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..adcf29b
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,37 @@
+# Changelog
+
+## 1.0.0 (2024-08-07)
+
+
+### ⚠ BREAKING CHANGES
+
+* **lib.luakittens:** make nil impossible as key in dict
+* **lib.luakittens:** prohibit nil key in tables and dicts
+* **lib.luakittens:** disallow optional nils
+
+### ref
+
+* **lib.luakittens:** disallow optional nils ([4b96197](https://github.com/Dich0tomy/cpp-tools.nvim/commit/4b9619700d597932cba246a7cb9ba8761f414659))
+
+
+### Features
+
+* basic project structure ([e933eb5](https://github.com/Dich0tomy/cpp-tools.nvim/commit/e933eb558525cbb1632139c06c06f34e0775b6a5))
+* **docs:** add general tips for working with C++ ([75d5933](https://github.com/Dich0tomy/cpp-tools.nvim/commit/75d5933a8c7563b1a287fe58402f499db44f015b))
+* hello, cpp-tools.nvim! :) ([3628734](https://github.com/Dich0tomy/cpp-tools.nvim/commit/36287345b28fd6af02060e5140995d1bdf9da132))
+* **lib.fp:** add a basic fp lib ([5bfe9bb](https://github.com/Dich0tomy/cpp-tools.nvim/commit/5bfe9bb4f48ba899460d94a97f93c1edbde9f7d7))
+* **lib.iter:** add `partition()` ([4cb58d2](https://github.com/Dich0tomy/cpp-tools.nvim/commit/4cb58d23533956280e5cefa13cd9b8ce5f270c15))
+* **lib.iter:** add basic iter lib ([4d21993](https://github.com/Dich0tomy/cpp-tools.nvim/commit/4d21993118439ac255487314e7caf462e9eb204c))
+* **lib.luakittens:** add a table type constructor ([2c03256](https://github.com/Dich0tomy/cpp-tools.nvim/commit/2c03256c4eed73e90d4c8491ceec7eaa26394c02))
+* **lib.luakittens:** add luaKITTENS parsing ([1b9b8c9](https://github.com/Dich0tomy/cpp-tools.nvim/commit/1b9b8c9786cbbbb97fb7168ae95fa2e06741c354))
+* **lib.luakittens:** allow trailing commas ([63046a5](https://github.com/Dich0tomy/cpp-tools.nvim/commit/63046a54e2223a6e688308ff0f367b896679c0c5))
+* **lib.luakittens:** make nil impossible as key in dict ([3726f8a](https://github.com/Dich0tomy/cpp-tools.nvim/commit/3726f8a855b63b5e5c959448e0f77b7062e57a05))
+* **lib.luakittens:** normalize the resulting AST ([56853b7](https://github.com/Dich0tomy/cpp-tools.nvim/commit/56853b7ca9dde164132d64642851e564a8aa1ebb))
+* **lib.luakittens:** prohibit nil key in tables and dicts ([8f6667e](https://github.com/Dich0tomy/cpp-tools.nvim/commit/8f6667e0ee14b36155f2a8cc4ed7a2a84ec4cfbd))
+* **lib.luakittens:** remove duplicates from alternative types ([d7461bb](https://github.com/Dich0tomy/cpp-tools.nvim/commit/d7461bb0f570aac88fc177fadc267a68a5855a61))
+
+
+### Bug Fixes
+
+* **test-runner:** add proper support for testfiles ([c64dbbf](https://github.com/Dich0tomy/cpp-tools.nvim/commit/c64dbbf58ec5d222bb1664b96ef2d96e3ecfc731))
+* **test-runner:** find root by `testfiles` not .git ([82ad2fa](https://github.com/Dich0tomy/cpp-tools.nvim/commit/82ad2fa6b19c542102c5c3b18b0b8b00ea63be3f))