diff --git a/js/CHANGELOG.md b/js/CHANGELOG.md
new file mode 100644
index 0000000..4a8298e
--- /dev/null
+++ b/js/CHANGELOG.md
@@ -0,0 +1,16 @@
+1.0.0 
+
+* Breaking change, introducing new TypeScript module with more clearly defined interfaces.
+* Leaflet plugin API changed:
+
+```js
+	const p = new pmtiles.PMTiles('example.pmtiles')
+	pmtiles.leafletLayer(p).addTo(map)
+```
+
+* MapLibre protocol API changed:
+
+```js
+	let cache = new pmtiles.ProtocolCache();
+  maplibregl.addProtocol("pmtiles",cache.protocol);
+```
\ No newline at end of file