diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..48a0e05
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,7 @@
+# Changelog
+
+## 1.0.0 (2025-07-07)
+
+### Fixes
+
+* resolve deprecation warnings ([#11](https://github.com/albert-io/optimal/pull/11))
diff --git a/mix.exs b/mix.exs
index 2845fa8..147643e 100644
--- a/mix.exs
+++ b/mix.exs
@@ -1,7 +1,7 @@
 defmodule Optimal.MixProject do
   use Mix.Project
 
-  @version "0.3.6"
+  @version "1.0.0"
 
   def project do
     [