diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..51a8dc0
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,23 @@
+## v1.5.0
+
+- New: Project source code was fully translated to Kotlin thanks to [@markusressel][markusressel] ([#38][38]).
+- New: New APIs to disable fling and flings started when overscrolling: `setFlingEnabled` and `setAllowFlingInOverscroll`,
+  thanks to [@markusressel][markusressel] ([#70][70]).
+- New: Ability to pan while zooming, thanks to [@markusressel][markusressel] ([#68][68]).
+- Enhancement: Prevent entering the scrolling/flinging state if pan is disabled, thanks to [@nil2l][nil2l] ([#79][79]).
+- New: New `Alignment` APIs control the alignment of the content with respect to the container. Please read the documentation about them.
+  Thanks to [@LRP-sgravel][LRP-sgravel] ([#71][71] and [#76][76])
+
+
+https://github.com/natario1/ZoomLayout/compare/v1.4.0...v1.5.0
+
+[markusressel]: https://github.com/markusressel
+[nil2l]: https://github.com/nil2l
+[LRP-sgravel]: https://github.com/LRP-sgravel
+
+[38]: https://github.com/natario1/ZoomLayout/pull/38
+[70]: https://github.com/natario1/ZoomLayout/pull/70
+[68]: https://github.com/natario1/ZoomLayout/pull/68
+[79]: https://github.com/natario1/ZoomLayout/pull/79
+[71]: https://github.com/natario1/ZoomLayout/pull/71
+[76]: https://github.com/natario1/ZoomLayout/pull/76
\ No newline at end of file
diff --git a/README.md b/README.md
index 5f0eab0..f951de3 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@ Flexible utilities to control and animate zoom and translation of Views and much
 programmatically or through touch events.
 
 ```groovy
-implementation 'com.otaliastudios:zoomlayout:1.4.0'
+implementation 'com.otaliastudios:zoomlayout:1.5.0'
 ```
 
 <p>
diff --git a/library/build.gradle b/library/build.gradle
index 430aaa3..5f05be1 100644
--- a/library/build.gradle
+++ b/library/build.gradle
@@ -7,7 +7,7 @@ apply plugin: 'org.jetbrains.dokka-android'
 // Required by bintray
 // archivesBaseName is required if artifactId is different from gradle module name
 // or you can add baseName to each archive task (sources, javadoc, aar)
-version = '1.4.0'
+version = '1.5.0'
 group = 'com.otaliastudios'
 archivesBaseName = 'zoomlayout'