diff --git a/CHANGELOG.md b/CHANGELOG.md
index 49b386e..c5c2bec 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,11 @@
+# 0.5.0
+
+- docs: add caching example
+- refactor: update very good analysis, workflows, flutter/dart version
+- feat: update very good analysis
+- feat: add dependabot
+- **BREAKING**: this release promotes 0.5.0-dev.1 which brings breaking changes
+
 # 0.5.0-dev.1
 
 - docs: use nullable validator in `README`
diff --git a/pubspec.yaml b/pubspec.yaml
index eb6818b..eae1379 100644
--- a/pubspec.yaml
+++ b/pubspec.yaml
@@ -5,7 +5,7 @@ issue_tracker: https://github.com/VeryGoodOpenSource/formz/issues
 homepage: https://github.com/VeryGoodOpenSource/formz
 documentation: https://github.com/VeryGoodOpenSource/formz
 
-version: 0.5.0-dev.1
+version: 0.5.0
 
 environment:
   sdk: ">=2.14.0 <3.0.0"