diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..8a8a34a
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,35 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## v0.1.0 (2024-09-17)
+
+### Chore
+
+ - <csr-id-9dff6432d576e180d85f11fac6355b28674f7e30/> thank you clippy
+
+### Commit Statistics
+
+<csr-read-only-do-not-edit/>
+
+ - 5 commits contributed to the release.
+ - 1 commit was understood as [conventional](https://www.conventionalcommits.org).
+ - 0 issues like '(#ID)' were seen in commit messages
+
+### Commit Details
+
+<csr-read-only-do-not-edit/>
+
+<details><summary>view details</summary>
+
+ * **Uncategorized**
+    - Thank you clippy ([`9dff643`](https://github.com/chriswk/owasp_password_validator/commit/9dff6432d576e180d85f11fac6355b28674f7e30))
+    - Use tarpaulin instead of grcov ([`249fce8`](https://github.com/chriswk/owasp_password_validator/commit/249fce805c119c98eb3d53687afe223e2d43853e))
+    - Added codecov ([`7c137a1`](https://github.com/chriswk/owasp_password_validator/commit/7c137a1fe7cbb54c045a4874dbb7bc6c6a27345e))
+    - Added workflow for building ([`08467b4`](https://github.com/chriswk/owasp_password_validator/commit/08467b4540f99053664d078486bae216d443b95a))
+    - Adds 7 basic owasp tests ([`770f758`](https://github.com/chriswk/owasp_password_validator/commit/770f758dab0885f070f6bbc570cbb0a159811374))
+</details>
+