diff --git a/metadata.json b/metadata.json
new file mode 100644
index 0000000..894b2e4
--- /dev/null
+++ b/metadata.json
@@ -0,0 +1,22 @@
+{
+  "$schema": "https://go.kicad.org/pcm/schemas/v1",
+  "name": "STM32 Pin Validator",
+  "description": "Validate STM32 pin assignments between KiCad and STM32CubeMX .ioc files",
+  "description_full": "Compares pin assignments across three sources:\n1. PCB layout (pad nets via pcbnew API)\n2. Schematic (pin names and labels, parsed from .kicad_sch)\n3. STM32CubeMX .ioc (GPIO signals and labels)\n\nResults are shown in a colour-coded table so mismatches are easy to spot. Handles pin remapping, aliases, and alternative GPIO names.",
+  "identifier": "stm32-pin-validator",
+  "type": "plugin",
+  "author": {
+    "name": "janik",
+    "contact": {
+      "git": "https://git.b4l.co.th/jamork/stm32PinValidator"
+    }
+  },
+  "license": "GPL-3.0-or-later",
+  "versions": [
+    {
+      "version": "1.0.0",
+      "status": "stable",
+      "kicad_version": "9.0"
+    }
+  ]
+}
diff --git a/__init__.py b/plugins/__init__.py
similarity index 100%
rename from __init__.py
rename to plugins/__init__.py
diff --git a/icon.png b/plugins/icon.png
similarity index 100%
rename from icon.png
rename to plugins/icon.png
diff --git a/ioc_parser.py b/plugins/ioc_parser.py
similarity index 100%
rename from ioc_parser.py
rename to plugins/ioc_parser.py
diff --git a/pin_validator_action.py b/plugins/pin_validator_action.py
similarity index 100%
rename from pin_validator_action.py
rename to plugins/pin_validator_action.py
diff --git a/sch_parser.py b/plugins/sch_parser.py
similarity index 100%
rename from sch_parser.py
rename to plugins/sch_parser.py
diff --git a/resources/icon.png b/resources/icon.png
new file mode 100644
index 0000000..4a2ac5d
Binary files /dev/null and b/resources/icon.png differ