DSH Version Incompatibility

Where compatibility is declared

Plugins declare their compatible DSH version range via the dsh.hub.compatibility.dsh field in package.json. This is a standard semver range expression.

{
  "dsh": {
    "hub": {
      "compatibility": {
        "dsh": ">=0.1.0-rc.7",
        "node": ">=22",
        "platforms": ["darwin", "linux"],
        "surfaces": ["web"]
      }
    }
  }
}

Common incompatibility causes

DSH version below requirement: upgrade DSH to a compatible version.

Node.js version mismatch: check the compatibility.node field and ensure your runtime meets the requirement.

Platform mismatch: some plugins may only be available on specific platforms (e.g. macOS, Linux).

Surface mismatch: a plugin may only support web or specific interfaces.

How to update compatibility declarations

If you're the plugin author, update the compatibility field in package.json and publish a new version. The Hub will update its display on the next sync.

Authors with claimed plugins can edit compatibility notes directly in the Dashboard without publishing a new version.