diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..2a53d83
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,32 @@
+# Changelog
+
+## 1.0.0 (2023-02-08)
+
+
+### Features
+
+* add unique key to timeline items ([04d96c4](https://github.com/openscript-ch/react-alternating-timeline/commit/04d96c457e575d09c66467219879a449c83521cf))
+* date formatting ([d64c857](https://github.com/openscript-ch/react-alternating-timeline/commit/d64c857bc97ce1669d45479c8641e38bd3957175))
+* implement alternate left/right positioning ([3d719dc](https://github.com/openscript-ch/react-alternating-timeline/commit/3d719dceab68604ae1181ba5e507ba01a44865ec))
+* implement alternative positioning ([513b488](https://github.com/openscript-ch/react-alternating-timeline/commit/513b48867059fe7bf18992916c1b0038cb243474))
+* implement calculating height of timeline ([5945fd8](https://github.com/openscript-ch/react-alternating-timeline/commit/5945fd864a4e06a189878419f9eda88166c74637))
+* improve customization trough css properties ([75d0fc3](https://github.com/openscript-ch/react-alternating-timeline/commit/75d0fc3f17db34a1354e5a5e42f76cf8052abe61))
+* introduce gap and offset configuration ([36edab2](https://github.com/openscript-ch/react-alternating-timeline/commit/36edab2ce36dc4a05a89a40b8a84f9cac7ba6861))
+* introduce inner marker styling ([b49a362](https://github.com/openscript-ch/react-alternating-timeline/commit/b49a3625061125ad8a6f9548e8fbd455bad953b0))
+* introduce min marker offset ([c6217a2](https://github.com/openscript-ch/react-alternating-timeline/commit/c6217a2e30d2346436e088eec72b4ee7e69a81d9))
+* introduce styled timeline center line ([677db57](https://github.com/openscript-ch/react-alternating-timeline/commit/677db5760e8c3f8a1c77dd92c78ed0cbf1d0a50e))
+* introduce timeline markers ([7e4ddfc](https://github.com/openscript-ch/react-alternating-timeline/commit/7e4ddfc8411534f98f0dc85e9491b58070886941))
+* make css properties configurable with props ([425145f](https://github.com/openscript-ch/react-alternating-timeline/commit/425145f546169cffe3e01750c96a56161ea9f61e))
+* make easier to style component externally ([3f805b2](https://github.com/openscript-ch/react-alternating-timeline/commit/3f805b2c4ef76ca38c7633103542ee194b65046d))
+* make marker and pointer replaceable ([d291e3d](https://github.com/openscript-ch/react-alternating-timeline/commit/d291e3da11570bcccc554a9ef96ca38e60f40ba2))
+* make marker radius configurable ([c0828a8](https://github.com/openscript-ch/react-alternating-timeline/commit/c0828a8b1c9ca41e281fef55b39bd88f4209b1c6))
+* position timeline item refs absolute ([995cf46](https://github.com/openscript-ch/react-alternating-timeline/commit/995cf463fa40e15b6a7c56b12c8ea3216cdf62d5))
+* reposition items on resize ([9c8773d](https://github.com/openscript-ch/react-alternating-timeline/commit/9c8773d8557b44ce4291bc61904c4b89d1a62fc0))
+* setup basic component structure ([336caa0](https://github.com/openscript-ch/react-alternating-timeline/commit/336caa0ed4262e6cf1a7f750659cd1a3ab54021b))
+* setup element referencing ([bf45080](https://github.com/openscript-ch/react-alternating-timeline/commit/bf4508075198bc33b9c8750e83d5d987f7ba5d05))
+* setup first component with story ([974dc11](https://github.com/openscript-ch/react-alternating-timeline/commit/974dc112d62c26e8e52d6e6a960c8793013f5d36))
+
+
+### Bug Fixes
+
+* offset for left/right positioning ([f1444c9](https://github.com/openscript-ch/react-alternating-timeline/commit/f1444c9f684e79161fcfdea810315eef03c99c3a))
diff --git a/package-lock.json b/package-lock.json
index 9e4984c..e042da1 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "react-alternating-timeline",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "react-alternating-timeline",
-      "version": "0.1.0",
+      "version": "1.0.0",
       "license": "MIT",
       "devDependencies": {
         "@babel/core": "^7.20.5",
diff --git a/package.json b/package.json
index d21ae56..98517a7 100755
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "react-alternating-timeline",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "description": "A React component library starter with Storybook, Vite and Typescript.",
   "keywords": [
     "react",