diff --git a/packages/iocraft/CHANGELOG.md b/packages/iocraft/CHANGELOG.md
index 3253710..2dfd949 100644
--- a/packages/iocraft/CHANGELOG.md
+++ b/packages/iocraft/CHANGELOG.md
@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.1](https://github.com/ccbrown/iocraft/compare/iocraft-v0.3.0...iocraft-v0.3.1) - 2024-09-30
+
+### Added
+
+- improve state api so that deadlocks are harder to create, add docs
+
 ## [0.3.0](https://github.com/ccbrown/iocraft/compare/iocraft-v0.2.3...iocraft-v0.3.0) - 2024-09-30
 
 ### Added
diff --git a/packages/iocraft/Cargo.toml b/packages/iocraft/Cargo.toml
index 472648a..73002e4 100644
--- a/packages/iocraft/Cargo.toml
+++ b/packages/iocraft/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "iocraft"
-version = "0.3.0"
+version = "0.3.1"
 edition = "2021"
 license = "MIT OR Apache-2.0"
 description = "Create beautifully crafted CLI programs and text output with a declarative React-like Rust API."