@processengine/uikit

Shared UI kit for ProcessEngine interfaces: orchestrator admin UI, Rules UI, Flow UI, and processor sandbox forms.

Install

Pin exact versions in production consumers:

{
  "dependencies": {
    "@processengine/uikit": "0.1.0"
  }
}

CSS Entrypoints

import "@processengine/uikit/styles.css";

Use styles.css for React applications. It includes tokens, base reset, and shared application components.

For plain processor sandbox forms, use the prebuilt bundle:

<link rel="stylesheet" href="./uikit-sandbox.css" />

The sandbox bundle is exported as @processengine/uikit/sandbox.css; consuming services can copy it into their static directories during their build.

React Entrypoint

import { Tabs, JsonPanel, CopyableValue } from "@processengine/uikit";

The React layer intentionally does not depend on routing or backend clients. Consumers keep their own router-specific links and backend-specific state.

Release Process

Releases follow the ProcessEngine tagged-release canon:

1. Update CHANGELOG.md under [Unreleased].
2. Run npm test.
3. Run npm version patch, npm version minor, or npm version major.
4. Push the version commit and tag with git push origin main --follow-tags.
5. GitHub Actions publishes the package to npm and creates the GitHub Release from CHANGELOG.md.

Publishing by hand is blocked by prepublishOnly; releases should go through GitHub Actions.