diff --git a/CHANGELOG.md b/CHANGELOG.md
index a4f3615..e15bf84 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file.
 
 The format is based on Keep a Changelog, and this project follows Semantic Versioning.
 
+## [0.2.3] - 2026-04-02
+
+### Added
+- Add project demo GIF at `docs/demo.gif`
+- Show GIF demo in README
+
 ## [0.2.2] - 2026-04-02
 
 ### Fixed
diff --git a/docs/demo.gif b/docs/demo.gif
new file mode 100644
index 0000000..9f41407
Binary files /dev/null and b/docs/demo.gif differ
diff --git a/pyproject.toml b/pyproject.toml
index 46cebc6..6161097 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "cd-browser"
-version = "0.2.2"
+version = "0.2.3"
 description = "A fast keyboard-driven directory navigator for the terminal."
 readme = "README.md"
 requires-python = ">=3.8"