diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..036c264
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,14 @@
+# Changelog
+
+## 1.0.0 (2026-01-23)
+
+
+### Features
+
+* add AIBTC branding and color palette ([0c9a3a6](https://github.com/aibtcdev/docs/commit/0c9a3a61bd697cc3fedcb4f618f49ee32ffce5c7))
+* initial AIBTC docs site with Astro Starlight ([bbfccf7](https://github.com/aibtcdev/docs/commit/bbfccf7501a1184ed2fb8909ac6585518ce63d87))
+
+
+### Bug Fixes
+
+* use dark text on hero buttons for readability ([7732a04](https://github.com/aibtcdev/docs/commit/7732a043b89bdb51bd42a788785a0d1c7890e950))
diff --git a/package-lock.json b/package-lock.json
index f19088f..0cb76b9 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "docs",
-  "version": "0.0.1",
+  "version": "1.0.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "docs",
-      "version": "0.0.1",
+      "version": "1.0.0",
       "dependencies": {
         "@astrojs/starlight": "^0.37.3",
         "astro": "^5.16.15",
diff --git a/package.json b/package.json
index 595f0b8..a154f0f 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "aibtc-docs",
   "type": "module",
-  "version": "0.0.1",
+  "version": "1.0.0",
   "scripts": {
     "wrangler": "set -a && . ./.env && set +a && npx wrangler",
     "dev": "astro dev --host",