diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..9215342
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,18 @@
+# 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).
+
+## [Unreleased]
+
+## [0.5.0-alpha.2](https://github.com/Ekleog/indexed-db/compare/v0.5.0-alpha.1...v0.5.0-alpha.2) - 2025-07-08
+
+### Fixed
+
+- make panic message more explicit when awaiting on non-idb futures
+
+### Other
+
+- enable release-plz
diff --git a/Cargo.toml b/Cargo.toml
index 05985b9..776ae06 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "indexed-db"
-version = "0.5.0-alpha.1"
+version = "0.5.0-alpha.2"
 edition = "2021"
 readme = "README.md"
 documentation = "https://docs.rs/indexed-db"