diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..c807a9f
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,36 @@
+# Changelog
+## [v2.2.3] - 2025-12-10
+
+### 🐛 Bug Fixes
+
+- fix: resolve ESLint error in env.d.ts (aecf48d)
+- fix: resolve SVG bundling issue and update example configuration (260ac42)
+- fix: update ESLint ignore patterns and fix import ordering (26216dc)
+- fix CI build failures (7fd7e9b)
+- fix: resolve security vulnerabilities with yarn resolutions (54f7cf5)
+- fix w React18, add pointer to drag handle (8a6e764)
+- fix build, gen types (5252a02)
+
+### 🔧 Chore
+
+- chore: update build tools - vite and vitest major version upgrades (eebc52a)
+
+### 🔨 Other Changes
+
+- Add test configuration, testing library and some basic tests (0f36f72)
+- Fix CI build issues (8797d86)
+-  fix: update CI to use Node 20+ for Vite 5 compatibility (e96b521)
+- Fix build failures (a9c9f19)
+- ci: add automated CI workflow for testing and building (0a29f13)
+-   chore: upgrade ESLint to 9.x with flat config migration (ac87acc)
+- update husky to 9.1.7 (4e47798)
+
+## [v2.2.2]
+- version up (1bea5e2)
+- remove problematic inline-block (739d1b9)
+- 
+# [v2.2.0]
+- update deps, use eslint-config-reearth, refactor vite config (da71e12)
+- add realignable prop to GridArea (1689c0f)
+- simplify types (e0f579e)
+- use prettier in example proj too (6b30c8f)
\ No newline at end of file
diff --git a/package.json b/package.json
index 5e3d86f..d47f96a 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "react-align",
-  "version": "2.2.2",
+  "version": "2.2.3",
   "author": "KaWaite",
   "license": "MIT",
   "main": "./dist/react-align.umd.js",