Scaffold OpenROM Plugin Store Architecture

.github/workflows/build_catalog.yml

@@ -0,0 +1,42 @@
+name: Build & Validate OpenROM Catalog
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Validate Plugin Manifests
+        run: python scripts/validate_plugin.py
+
+      - name: Build Catalog API
+        run: python scripts/build_catalog.py
+
+      - name: Commit and Push Catalog Changes
+        if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+        run: |
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+          git add public/api/catalog.json
+          if git diff --staged --quiet; then
+            echo "No catalog changes to commit."
+          else
+            git commit -m "build: update catalog.json [skip ci]"
+            git push
+          fi

manifests/m/m5dev/saturn-ssp/1.0.0/manifest.json

@@ -0,0 +1,20 @@
+{
+  "id": "saturn-ssp",
+  "name": "Sega Saturn Patcher (SSP)",
+  "version": "1.0.0",
+  "author": "m5dev",
+  "description": "Specialized Sega Saturn Patcher disc modification tool.",
+  "conversions": [
+    "SSP"
+  ],
+  "tags": [
+    "saturn",
+    "ssp",
+    "patcher",
+    "sega"
+  ],
+  "icon": "https://raw.githubusercontent.com/M5Devs/OpenROM-Plugins-Store/main/packages/saturn.png",
+  "download_url": "https://github.com/M5Devs/OpenROM-Plugins-Store/releases/download/v1.0.0/saturn-ssp.orplug",
+  "homepage": "https://github.com/M5Devs",
+  "license": "MIT"
+}

manifests/m/m5dev/wiiu-nkit/3.1.0/manifest.json

@@ -0,0 +1,22 @@
+{
+  "id": "wiiu-nkit",
+  "name": "Wii U NKit & ZArchive Suite",
+  "version": "3.1.0",
+  "author": "m5dev",
+  "description": "Standalone NKit v3.1.0 suite for Wii U ZArchive compression.",
+  "conversions": [
+    "WUA",
+    "WUD",
+    "WUX"
+  ],
+  "tags": [
+    "wiiu",
+    "nkit",
+    "zarchive",
+    "wua"
+  ],
+  "icon": "https://raw.githubusercontent.com/M5Devs/OpenROM-Plugins-Store/main/packages/wiiu.png",
+  "download_url": "https://github.com/M5Devs/OpenROM-Plugins-Store/releases/download/v3.1.0/wiiu-nkit.orplug",
+  "homepage": "https://github.com/M5Devs",
+  "license": "GPL-3.0"
+}

manifests/m/m5dev/xbox360-tools/1.0.0/manifest.json

@@ -0,0 +1,21 @@
+{
+  "id": "xbox360-tools",
+  "name": "Xbox 360 ZAR & XISO Tools",
+  "version": "1.0.0",
+  "author": "m5dev",
+  "description": "Extract XISO and compress to .zar for Xenia Edge.",
+  "conversions": [
+    "ZAR",
+    "XISO"
+  ],
+  "tags": [
+    "xbox360",
+    "xiso",
+    "zar",
+    "xenia"
+  ],
+  "icon": "https://raw.githubusercontent.com/M5Devs/OpenROM-Plugins-Store/main/packages/xbox360.png",
+  "download_url": "https://github.com/M5Devs/OpenROM-Plugins-Store/releases/download/v1.0.0/xbox360-tools.orplug",
+  "homepage": "https://github.com/M5Devs",
+  "license": "MIT"
+}

public/api/catalog.json

@@ -0,0 +1,91 @@
+{
+  "version": "1.0",
+  "generated_at": "2026-10-17T11:54:08.867684+00:00",
+  "total_plugins": 3,
+  "plugins": [
+    {
+      "id": "saturn-ssp",
+      "name": "Sega Saturn Patcher (SSP)",
+      "version": "1.0.0",
+      "author": "m5dev",
+      "description": "Specialized Sega Saturn Patcher disc modification tool.",
+      "conversions": [
+        "SSP"
+      ],
+      "tags": [
+        "saturn",
+        "ssp",
+        "patcher",
+        "sega"
+      ],
+      "icon": "https://raw.githubusercontent.com/M5Devs/OpenROM-Plugins-Store/main/packages/saturn.png",
+      "download_url": "https://github.com/M5Devs/OpenROM-Plugins-Store/releases/download/v1.0.0/saturn-ssp.orplug",
+      "homepage": "https://github.com/M5Devs",
+      "license": "MIT",
+      "publisher": {
+        "id": "m5dev",
+        "name": "Yusuf Ezz (M5 Dev)",
+        "github": "https://github.com/M5Devs",
+        "is_verified": true,
+        "badge": "Core Architect"
+      }
+    },
+    {
+      "id": "wiiu-nkit",
+      "name": "Wii U NKit & ZArchive Suite",
+      "version": "3.1.0",
+      "author": "m5dev",
+      "description": "Standalone NKit v3.1.0 suite for Wii U ZArchive compression.",
+      "conversions": [
+        "WUA",
+        "WUD",
+        "WUX"
+      ],
+      "tags": [
+        "wiiu",
+        "nkit",
+        "zarchive",
+        "wua"
+      ],
+      "icon": "https://raw.githubusercontent.com/M5Devs/OpenROM-Plugins-Store/main/packages/wiiu.png",
+      "download_url": "https://github.com/M5Devs/OpenROM-Plugins-Store/releases/download/v3.1.0/wiiu-nkit.orplug",
+      "homepage": "https://github.com/M5Devs",
+      "license": "GPL-3.0",
+      "publisher": {
+        "id": "m5dev",
+        "name": "Yusuf Ezz (M5 Dev)",
+        "github": "https://github.com/M5Devs",
+        "is_verified": true,
+        "badge": "Core Architect"
+      }
+    },
+    {
+      "id": "xbox360-tools",
+      "name": "Xbox 360 ZAR & XISO Tools",
+      "version": "1.0.0",
+      "author": "m5dev",
+      "description": "Extract XISO and compress to .zar for Xenia Edge.",
+      "conversions": [
+        "ZAR",
+        "XISO"
+      ],
+      "tags": [
+        "xbox360",
+        "xiso",
+        "zar",
+        "xenia"
+      ],
+      "icon": "https://raw.githubusercontent.com/M5Devs/OpenROM-Plugins-Store/main/packages/xbox360.png",
+      "download_url": "https://github.com/M5Devs/OpenROM-Plugins-Store/releases/download/v1.0.0/xbox360-tools.orplug",
+      "homepage": "https://github.com/M5Devs",
+      "license": "MIT",
+      "publisher": {
+        "id": "m5dev",
+        "name": "Yusuf Ezz (M5 Dev)",
+        "github": "https://github.com/M5Devs",
+        "is_verified": true,
+        "badge": "Core Architect"
+      }
+    }
+  ]
+}