diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..e9a831c
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,13 @@
+# 1.0.0 (2025-10-09)
+
+
+### Bug Fixes
+
+* ensure entity_id is correct for Storage Used % entity ([f10c04b](https://github.com/weirdtangent/amcrest2mqtt/commit/f10c04b00624581feaf57c703be1f43695c674d5))
+* fix doorbell entity name when device is called 'Doorbell' ([bd18f74](https://github.com/weirdtangent/amcrest2mqtt/commit/bd18f74507f0fa657d844aeefdb4e8fe2aab561e))
+* move to more static Home Assistant topic names ([cfa7b00](https://github.com/weirdtangent/amcrest2mqtt/commit/cfa7b00135660cdc8dc5805c07ff234dc1d5fbec))
+
+
+### Features
+
+* semantic versioning, github action features, writes a version file, and tags Docker images ([69c4f1a](https://github.com/weirdtangent/amcrest2mqtt/commit/69c4f1ac575b2d5489000a45660211eb474dccd7))