diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 00000000..d70a21dd
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,38 @@
+# Changelog
+
+## 1.0.0 (2024-02-27)
+
+
+### Features
+
+* add instance_id  ([#4](https://github.com/paypal/paypal-messages-android/issues/4)) ([d72ccee](https://github.com/paypal/paypal-messages-android/commit/d72cceef42158444167abca1b8f3d4cb58023c63))
+* base of GitHub workflows ([#5](https://github.com/paypal/paypal-messages-android/issues/5)) ([c32defe](https://github.com/paypal/paypal-messages-android/commit/c32defe0f9b32700dc9cea836dc3cc0def835a1b))
+* debounce config updates ([#24](https://github.com/paypal/paypal-messages-android/issues/24)) ([7d0a043](https://github.com/paypal/paypal-messages-android/commit/7d0a0431a16e490a98176c90dbd54797450aaad8))
+* jetpack compose demo ([#10](https://github.com/paypal/paypal-messages-android/issues/10)) ([a47065e](https://github.com/paypal/paypal-messages-android/commit/a47065e5e3c8fa04838e2196e799fd42df1d7088))
+* package pre-release ([#14](https://github.com/paypal/paypal-messages-android/issues/14)) ([d63f834](https://github.com/paypal/paypal-messages-android/commit/d63f834b025591141abb41b800c4ce32a600aeb3))
+* update message view to use its own instance id ([#20](https://github.com/paypal/paypal-messages-android/issues/20)) ([9efb3bb](https://github.com/paypal/paypal-messages-android/commit/9efb3bbc1e743392f469fab078f65ffa90a59871))
+* use nested coroutine to prevent blocking ([#19](https://github.com/paypal/paypal-messages-android/issues/19)) ([b06039c](https://github.com/paypal/paypal-messages-android/commit/b06039c3b9676e58cdc8853bb82a4e6513c9b168))
+* xml demo ([#6](https://github.com/paypal/paypal-messages-android/issues/6)) ([4b33504](https://github.com/paypal/paypal-messages-android/commit/4b3350431678922af6cab9952f9f155b92275c78))
+
+
+### Bug Fixes
+
+* remove kotlinter ([1550f44](https://github.com/paypal/paypal-messages-android/commit/1550f44f72d9ba6fed95cb0c2fb8bf6b5794463e))
+* update shared data ([#7](https://github.com/paypal/paypal-messages-android/issues/7)) ([2fa1ea1](https://github.com/paypal/paypal-messages-android/commit/2fa1ea1f89330a90298a1ec053c110cd65666fab))
+
+
+### Code Refactoring
+
+* adjust logo alignment ([#23](https://github.com/paypal/paypal-messages-android/issues/23)) ([6347be3](https://github.com/paypal/paypal-messages-android/commit/6347be342028d107db02956b6a6202c3cda68000))
+* clone to prevent shallow copy ([#25](https://github.com/paypal/paypal-messages-android/issues/25)) ([acfc3ff](https://github.com/paypal/paypal-messages-android/commit/acfc3ffbd1d1177fc0221b09e70fd60f51cc898a))
+* prevent destroying modal on close ([#3](https://github.com/paypal/paypal-messages-android/issues/3)) ([ae7e032](https://github.com/paypal/paypal-messages-android/commit/ae7e03235e8559898e9eb2c76e6bd5e487dc2caa))
+* radio offer type and other things ([#11](https://github.com/paypal/paypal-messages-android/issues/11)) ([960a48a](https://github.com/paypal/paypal-messages-android/commit/960a48ab489ef62a4f5085baf6bee5a8e05893b1))
+* route changes ([#13](https://github.com/paypal/paypal-messages-android/issues/13)) ([6434e30](https://github.com/paypal/paypal-messages-android/commit/6434e30fb198ffae1b14b0c5e039292f651bf559))
+* use dot getters and setters ([#9](https://github.com/paypal/paypal-messages-android/issues/9)) ([84316bb](https://github.com/paypal/paypal-messages-android/commit/84316bb553ebdfc11c1d02e5d8c4e804c1806a0a))
+
+
+### Continuous Integration
+
+* functional tests ([#16](https://github.com/paypal/paypal-messages-android/issues/16)) ([51d9ec6](https://github.com/paypal/paypal-messages-android/commit/51d9ec63ad61c69164e360e5c769fbe61601bc41))
+* lint and test ([#8](https://github.com/paypal/paypal-messages-android/issues/8)) ([8a22f0b](https://github.com/paypal/paypal-messages-android/commit/8a22f0b03efbab3e43dfb034dc87379985b67a19))
+* update semantic release ([d3004fd](https://github.com/paypal/paypal-messages-android/commit/d3004fd11458ab598ae9f71d2d7351139530cf3d))