This plugin adds lint rules to the built-in linting feature introduced in Camunda Modeler v5.0 and supporting plugins since v5.4.

To use this plugin with Camunda Modeler v5.2 and older check out the camunda-modeler-5-2 branch.

This plug-in provides custom lint rules to the built-in Camunda Modeler linting feature. Fork it to suit your needs.

Use the local .bpmnlintrc file to configure active lint rules.

Checkout the bpmnlint documentation for more information regarding this file.

This project ships with a bpmnlint extension with the custom namespace. Add or edit rules in the extension's rules directory. Activate the rules via the local .bpmnlintrc file, in order to use them, prefixed with the namespace:

{
 "extends": [
    "bpmnlint:recommended",
    "plugin:custom/recommended"
 ],
 "rules": {
   "custom/no-manual-task": "warn",
   "custom/your-other-rule": "error"
 }
}

The custom namespace used by the shipped bpmnlint extension is arbitrary, i.e. can be changed freely. However you'd need to take into account how the linting infrastructure discovers rules and configuration:

• It searches the rule provider library in the NodeJS search path (usually node_modules folder)
  • For a library bpmnlint-plugin-{custom}, given a namespace {custom}
  • For a library {@prefix}/bpmnlint-plugin-{custom}, given a scoped namespace {@prefix}/{custom}
• Within a rule provider library
  • It searches the rules folder for a file matching an activated rule name
  • It searches the config folder for a file matching a configured configuration or inspect the plug-ins default export

In the case of our custom plug-in custom/recommended reference the custom configuration, exported by our plug-ins entry point. The rule custom/no-manual-task on the other hand references plug-ins entry point.

Setup the project:

npm install

Build the plug-in:

npm run all

Continuously rebuild in development mode:

npm run dev

• Clearly state which Camunda Modeler version your plug-in is compatible with
• Give your plug-in a unique name

• Camunda Modeler
• bpmnlint

MIT