diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..d208867
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,23 @@
+# Changelog
+
+## [1.0.0](https://github.com/vergissberlin/codestats-readme/compare/v0.1.0...v1.0.0) (2025-09-09)
+
+
+### ⚠ BREAKING CHANGES
+
+* **typescript:** Main entry point changed from index.js to dist/index.js
+
+### Features
+
+* **docker:** migrate from yarn to pnpm with security improvements ([058e2e6](https://github.com/vergissberlin/codestats-readme/commit/058e2e66967b78bd758f9d9fdcd80e978caa260a))
+* **docker:** update Dockerfile and README for improved security and usability ([1d98505](https://github.com/vergissberlin/codestats-readme/commit/1d9850553388e9e1dde028e01fa2d1d1ce75404a))
+* **docs:** add badges and GitHub Marketplace integration ([999a6ac](https://github.com/vergissberlin/codestats-readme/commit/999a6ac65cefe40be658fa3fe81150b11e187605))
+* **github:** add comprehensive issue and PR templates ([e44a94b](https://github.com/vergissberlin/codestats-readme/commit/e44a94b29cf9c0b986e9bfe8de44eb1f20c28d3a))
+* **typescript:** migrate to TypeScript with comprehensive linting setup ([96fa39c](https://github.com/vergissberlin/codestats-readme/commit/96fa39c6b7ef44ed16f2662a7fec37e580a29150))
+
+
+### Bug Fixes
+
+* **ci:** add pnpm-lock.yaml for GitHub Actions ([208f536](https://github.com/vergissberlin/codestats-readme/commit/208f536d8889309e982d0766d6a7f632221c9805))
+* **ci:** correct pnpm setup order in GitHub Actions ([0c86424](https://github.com/vergissberlin/codestats-readme/commit/0c864241de058262301b2441188bd3627fecb8ec))
+* **ci:** improve test workflow with verification step ([11651d0](https://github.com/vergissberlin/codestats-readme/commit/11651d01c5f51cfe7266a8e7dbf9d2c77db63d0a))