diff --git a/.cz.yaml b/.cz.yaml
new file mode 100644
index 0000000..0dfee7a
--- /dev/null
+++ b/.cz.yaml
@@ -0,0 +1,8 @@
+---
+commitizen:
+  major_version_zero: true
+  name: cz_conventional_commits
+  tag_format: $version
+  update_changelog_on_bump: true
+  version_provider: npm
+  version_scheme: semver
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..c09b417
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,29 @@
+# PinInput React
+
+## 1.0.0 (2024-09-15)
+
+### Feat
+
+- add example section
+- **seo**: add OG image and meta tags
+- update favicon
+- add usage section
+- add footer and social links
+- add pin-input form component
+- add code copy functionality
+- implement main layout
+- implement theme switch
+
+### Fix
+
+- **a11y**: add sr-only text in copy button
+- optimize onComplete/onIncomplete invocation
+- update github links
+
+### Refactor
+
+- update snippet accordion
+
+### Perf
+
+- update png background image with webp format
diff --git a/package.json b/package.json
index e470a82..44187c3 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "pin-input",
   "private": true,
-  "version": "0.0.0",
+  "version": "1.0.0",
   "type": "module",
   "scripts": {
     "dev": "vite",