diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..3968fdb
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,55 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [1.0.0-alpha.3] - 2026-04-04
+
+### Changed
+- Expanded npm keywords for better discoverability
+- Added badges, comparison table and roadmap to README
+
+---
+
+## [1.0.0-alpha.2] - 2026-03-01
+
+### Fixed
+- GitHub release step — added `contents:write` permission and explicit tag push before release creation
+- CI workflow: removed duplicate CI job from publish.yml
+
+### Changed
+- Bumped version to `1.0.0-alpha.2`
+
+---
+
+## [1.0.0-alpha.1] - 2026-02-01
+
+### Added
+- CI/CD pipeline with TypeScript checks, build verification and dry-run npm publish
+- Dependabot for npm and GitHub Actions weekly updates
+- Auto-tag on publish for alpha/beta/rc releases
+
+### Fixed
+- Removed stale compiled `.js` files from `src/` — Rollup was resolving them instead of `.ts` sources
+- Added `--noEmit` to tsc type-check scripts to prevent JS file generation
+- Replaced `yarn run -T` with `npx tsc` for CI compatibility
+
+---
+
+## [1.0.0] - 2026-01-15
+
+### Added
+- Visual drag-and-drop form builder in the Strapi admin
+- 15+ field types: text, email, number, phone, URL, password, date, time, textarea, select, radio, checkbox, checkbox-group, heading, paragraph, divider
+- Per-field validation rules: required, minLength, maxLength, min, max, email, URL, regex pattern with custom error messages
+- Draft / Publish flow
+- Public hosted page at `/api/strapi-plugin-form-builder-cms/page/:slug`
+- Self-contained embed script — single `<script>` tag, zero dependencies
+- Honeypot spam protection
+- Submission inbox with status filtering (new / read / archived)
+- Form preview modal inside the admin
+- Embed code modal with one-click copy
diff --git a/README.md b/README.md
index 1189a5e..fb30ece 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,10 @@
 # strapi-plugin-form-builder-cms
 
+[![npm version](https://img.shields.io/npm/v/strapi-plugin-form-builder-cms.svg)](https://www.npmjs.com/package/strapi-plugin-form-builder-cms)
+[![npm downloads](https://img.shields.io/npm/dm/strapi-plugin-form-builder-cms.svg)](https://www.npmjs.com/package/strapi-plugin-form-builder-cms)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Strapi 5](https://img.shields.io/badge/Strapi-5.x-2F2D74?logo=strapi)](https://strapi.io)
+
 A visual drag-and-drop form builder plugin for [Strapi 5](https://strapi.io). Create, publish and embed forms on any website without writing a single line of backend code.
 
 ---
@@ -229,6 +234,18 @@ Pull requests are welcome. For major changes please open an issue first to discu
 
 ---
 
+## Roadmap
+
+- [ ] Email notifications on new submission
+- [ ] File upload field type
+- [ ] Multi-step / wizard forms
+- [ ] Export submissions as CSV
+- [ ] Webhook on submit
+
+Have a feature request? [Open an issue](https://github.com/devCluna/strapi-plugin-form-builder-cms/issues).
+
+---
+
 ## License
 
 [MIT](LICENSE)
diff --git a/package.json b/package.json
index 0519d72..1a97d12 100644
--- a/package.json
+++ b/package.json
@@ -1,14 +1,26 @@
 {
   "name": "strapi-plugin-form-builder-cms",
-  "version": "1.0.0-alpha.2",
+  "version": "1.0.0-alpha.3",
   "description": "Visual drag-and-drop form builder plugin for Strapi 5. Create, publish and embed forms on any website.",
   "keywords": [
     "strapi",
     "strapi-plugin",
+    "strapi5",
+    "strapi-v5",
     "form-builder",
+    "form-builder-plugin",
     "forms",
     "drag-and-drop",
-    "cms"
+    "drag-drop-form",
+    "cms",
+    "headless-cms",
+    "form-embed",
+    "contact-form",
+    "lead-form",
+    "no-code",
+    "visual-builder",
+    "submissions",
+    "embed"
   ],
   "license": "MIT",
   "author": "dev.cluna <dev.cluna@gmail.com>",