diff --git a/CHANGELOG.md b/CHANGELOG.md
index 103a5b5..b81d5d3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,16 @@
+## 2.0.0 (2024-02-21)
+
+### BREAKING CHANGE
+
+- `query_class` *must* now be defined on a repository subclass.
+
+### Feat
+
+- Handle nested models more gracefully; add per-field data prep
+- Local filesystem-based filestorage implementation
+- Teach queries insert, update, delete, which repos now use
+- add README.md, LICENSE.md, better package metadata
+
 ## 1.0.3 (2024-01-27)
 
 ### Fix
diff --git a/pyproject.toml b/pyproject.toml
index be9985c..805f48c 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -5,7 +5,7 @@ build-backend = "poetry.core.masonry.api"
 [tool.poetry]
 name = 'steerage'
 description = 'Pluggable async storage backends for Python projects'
-version = "1.0.3"
+version = "2.0.0"
 authors = [
   "David Eyk <david@worldsenoughstudios.com>"
 ]