Skip to content

Marketplace

The Consystence Marketplace at marketplace.consystence.app is a registry for discovering, installing, and publishing device type libraries. It works like NuGet for industrial equipment.

Browsing and installing

Browse

The marketplace UI and CLI let you search for device types by:

  • Equipment category — pumps, conveyors, crushers, instrumentation
  • Publisher — Consystence, Deftec, community contributors
  • PLC platform — ControlLogix, CompactLogix, Siemens S7
  • Process area — coal handling, water management, ventilation

Install a library

consystence library install consystence-pumps --version 1.2.0

This downloads the .cspkg file, validates its signature, resolves dependencies, and extracts the device types into the site's type registry.

Versioning

Libraries use semantic versioning:

  • Major — breaking changes to tag schemas or APIs
  • Minor — new tags, alarms, or commands (backward compatible)
  • Patch — bug fixes, documentation, UI improvements

When a library is installed, the site server records the installed version. Updates are offered when new versions are published, but never applied automatically — the site admin chooses when to upgrade.

Dependency resolution

Libraries can depend on other libraries. The installer resolves the full dependency tree before downloading:

# library.yaml
name: consystence-pumps
version: 1.2.0
dependencies:
  consystence-instruments: ">=1.0.0"
  consystence-valves: ">=1.1.0"

Conflicts (e.g. two libraries requiring incompatible versions of a dependency) are reported at install time with resolution suggestions.

Publishing

Publisher tiers

Tier Requirements Badge Review
Community Registered account None Automated checks only
Verified Identity verified, signed packages Verified Automated + manual review
OEM Partner Commercial agreement, certified types OEM Partner Full certification process

Publishing a library

  1. Package your device types:

    consystence library pack ./my-pump-types --output my-pumps-1.0.0.cspkg

  2. Sign the package (required for Verified and OEM tiers):

    consystence library sign my-pumps-1.0.0.cspkg --key publisher.key

  3. Publish to the marketplace:

    consystence library publish my-pumps-1.0.0.cspkg

Pricing models

Model Description
Free Open source or community-contributed types
Per-site One-time fee per site that installs the library
Subscription Annual fee per site, includes updates and support
Included Bundled with a licence tier (e.g. OEM types included with Edge OEM Licence)

Publishers set pricing per library. The marketplace handles licence validation and entitlement checks at install time.

REST API

The marketplace exposes a REST API for programmatic access:

Endpoint Method Description
/api/libraries GET Search and list libraries
/api/libraries/{id} GET Get library metadata and versions
/api/libraries/{id}/versions/{version} GET Get specific version details
/api/libraries/{id}/versions/{version}/download GET Download package file
/api/libraries POST Publish a new library (authenticated)
/api/libraries/{id}/versions POST Publish a new version (authenticated)

All endpoints accept and return JSON. Authentication uses the same JWT tokens as the rest of the platform.

Deftec launch catalogue

Deftec is the launch publisher seeding the marketplace with production-grade device types covering the Australian coal mining value chain. These types are derived from Deftec's production PLC libraries (112 UDTs, 57 AOIs) and include full tag schemas, operator faceplates, alarm configurations, and AI context.

The initial catalogue covers pumps, conveyors, crushers, screens, feeders, instrumentation, valves, switchgear, and water management equipment.