Documentation

Learn how to install, configure, and get the most out of Binding Doctor for Ignition.

Getting Started

Welcome to the official documentation for Binding Doctor for Ignition. This guide walks you through setup step by step.

Important: This software is an official Ignition 8.3+ Gateway module. It installs directly into the Ignition Gateway and integrates natively into Perspective Designer.

Ignition Gateway Module Installation

Installation follows the standard Ignition Gateway module procedure:

Installation Steps

  1. Download the module file Kumukode-CSS-Manager-8.3.modl from the downloads section.
  2. Open your Ignition Gateway web interface (defaults to http://localhost:8088 or your server IP).
  3. Log in with admin credentials and navigate to Config > System > Modules.
  4. Scroll to the bottom and click Install or Upgrade a Module...
  5. Select the downloaded .modl file and click Install.
  6. Accept the cryptographically signed certificate from Kumukode. The module state will transition to Running.

Perspective Designer, Multiple CSS Files & Live Preview

Once installed, launch or reload the Ignition Designer:

1. Multiple Modular CSS Files (Say Goodbye to stylesheet.css Monolith)

Unlike native Perspective which forces all styles into a single file, CSS Manager allows you to structure your architecture cleanly:

  • In the Project Browser navigation tree, expand the CSS Manager node.
  • Right click to create distinct files, such as alarms.css, valves.css, dark-theme.css, or organize them inside custom folders.
  • Each file features an Active Toggle: test style variations or disable an entire module instantly without deleting CSS rules.

2. Instant Live Preview Without Saving (Ctrl+S)

Never wait for slow project saves or browser reloads again:

  • Open any stylesheet in the dedicated CSS editor.
  • As you type selectors, CSS variables, or animations, the Live Preview engine dynamically injects rules in sub-50ms directly into the active Designer views and all connected web client sessions.
  • Zero screen flickering, zero white flashes, and zero lost session state.

3. Industrial SCADA Snippets & Cascade Inspector

Accelerate your HMI design with built-in tools:

  • Gateway-Level SCADA Snippet Library: Snippets are stored centrally in the Gateway (snippets.json), making your corporate SCADA design system automatically accessible to all projects and connected engineers. Organize into custom categories, edit existing snippets, or clone built-in templates (animated pipe flows, ISA-18.2 compliance alarms, 3D tactile emergency stops, rotating motors).
  • Cascade & Specificity Inspector with Pseudo-State Simulation: Select any Perspective component to inspect matching CSS rules with specificity ratings (a,b,c). Use the Force element state (:hov) toolbar to simulate :hover, :active, :focus, and :disabled states instantly in the Designer without entering interactive Preview mode.
  • Local Assets & Fonts: Drag and drop custom web fonts (.woff2, .ttf) or SVG icons directly into the Gateway without needing server filesystem or SSH access.

License Activation (Online & Offline)

The module includes a 2-hour evaluation mode synchronized with Ignition. For production:

Instant Online Activation

If your Ignition Gateway has outbound internet access:

  1. Go to Config > CSS Manager > Licensing in the Gateway web UI.
  2. Enter your License Key (provided via email upon purchase) and click Activate License. The Gateway validates directly against the Kumukode license server and permanently activates.

Air-Gapped Offline Activation

For isolated industrial OT networks without internet connectivity:

  1. Copy your Gateway's System ID displayed on the licensing page (e.g. KUMU-8B3F-C19B-4D2E).
  2. Generate your signed cryptographic offline block using your System ID.
  3. Paste the signed block into the Gateway's licensing form to activate permanently offline.