diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..f95c18b
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,30 @@
+# Changelog
+
+## 1.0.0 (2026-07-17)
+
+
+### Features
+
+* add @stacks/connect and @stacks/transactions bindings for wallet integration ([fe81e1d](https://github.com/cryptoflops/stacks-builder-badge-nft/commit/fe81e1de1560168c3736329be5180085da76b298))
+* complete nft minting app with testnet deployment and ui polish ([e449cbd](https://github.com/cryptoflops/stacks-builder-badge-nft/commit/e449cbd0c2306afe9c53abaf4d7ea4be1eb50111))
+* complete production-ready chainhook event handler ([5940e1a](https://github.com/cryptoflops/stacks-builder-badge-nft/commit/5940e1a826f3398ee5ee1d6a909befcc4275227f))
+* consolidate contracts, metadata, and chainhooks for mainnet launch ([da21491](https://github.com/cryptoflops/stacks-builder-badge-nft/commit/da21491baf353378e2a51d0895e0418261880001))
+* Implement dynamic Mainnet/Testnet toggle UI ([3244d55](https://github.com/cryptoflops/stacks-builder-badge-nft/commit/3244d55a47480c7170cf76acef648be5e7daac78))
+* Initial commit of Builder Badge NFT ([d62e94e](https://github.com/cryptoflops/stacks-builder-badge-nft/commit/d62e94ecfd138a4ae3bebb65f9f54f44ba717230))
+* integrate full-stack chainhook activity feed ([abaca8f](https://github.com/cryptoflops/stacks-builder-badge-nft/commit/abaca8f1725ffb71292a5847dcadfabc6c365fe0))
+* integrate stacks sdk utilities for enhanced connectivity ([f0dac42](https://github.com/cryptoflops/stacks-builder-badge-nft/commit/f0dac423a122b56e5f6dc1e26000c6489b624352))
+
+
+### Bug Fixes
+
+* correct mainnet principal typo in badge-events predicate ([3e507ef](https://github.com/cryptoflops/stacks-builder-badge-nft/commit/3e507eff6384bad9477d56984783d582da56cba7))
+* definitive secure dependency upgrade for vercel v16 ([e13a692](https://github.com/cryptoflops/stacks-builder-badge-nft/commit/e13a6927d6163dde67b6cc75134922b25923dfcc))
+* dependency resolution for vercel deployment ([87c7412](https://github.com/cryptoflops/stacks-builder-badge-nft/commit/87c7412459feb64fe3b968ba4c6e8bb0cfe5ff26))
+* explicit secure dependency upgrade for vercel ([044d6b6](https://github.com/cryptoflops/stacks-builder-badge-nft/commit/044d6b67a67cf563f2bf381c71998882d634d7a0))
+* finalize chainhook predicates and initialize local .env ([e0249d6](https://github.com/cryptoflops/stacks-builder-badge-nft/commit/e0249d642c6e2d4f56e945afc2541164179540d6))
+* next.config.ts for next 16 canary ([55ecb61](https://github.com/cryptoflops/stacks-builder-badge-nft/commit/55ecb61678d61c4ad6bdfb4d41596347a22885d3))
+* resolve esm execution error with tsx and update guides ([a435413](https://github.com/cryptoflops/stacks-builder-badge-nft/commit/a435413b30b7cde37427606d565a2f7dc3d34ce6))
+* resolve StacksMainnet import type error for CI compliance ([01afc62](https://github.com/cryptoflops/stacks-builder-badge-nft/commit/01afc62571648d51a354ad8db9c0fa65420c3b5c))
+* Restore contract address constants ([80c6d67](https://github.com/cryptoflops/stacks-builder-badge-nft/commit/80c6d6768a4bdc4eaaba5c070c1b1645178d68be))
+* secure dependency baseline for vercel ([d26cf4b](https://github.com/cryptoflops/stacks-builder-badge-nft/commit/d26cf4b8aeb003a25f8b4400a12e3a4925e6b029))
+* update invalid chainhook scope to print_event ([c140dd0](https://github.com/cryptoflops/stacks-builder-badge-nft/commit/c140dd069c6d6a68cf333600ae5798b7306b4af1))