Common frontend / UI resources, widgets and libraries for the Camunda web application:

Important note: This project is used internally and the API of its components are subject to changes at any time.

• lib
  • auth - for authentication mechanisms and tools, read more
  • util - commonly used utilities read more
  • directives
  • pages
  • chart
  • plugin
  • resources
  • search
  • services
• resources
  • locales - translation files
  • img
  • less - base less files to generate CSS stylesheets
• widgets

Widgets are reusable components which should be easy to integrate in the Camunda webapp and your own projects.

A good way to get familiar with the widgets integration in your projects is by reading the source code of the lib/widgets/*/test/*.spec.html or their online versions (see the widgets menu on the GitHub page).
In those examples, we use uncompiled versions of the library and its dependencies and wire the whole with requirejs.

• cam-widget-bpmn-viewer
• cam-widget-cmmn-viewer
• cam-widget-dmn-viewer
• cam-widget-debug
• cam-widget-footer
• cam-widget-header
• cam-widget-inline-field
• cam-widget-loader
• cam-widget-chart-line
• cam-widget-search
• cam-widget-search-pill
• cam-widget-variable
• cam-widget-variables-table
• cam-widget-clipboard
• cam-widget-var-template

grunt auto-build

npm install
./node_modules/grunt-protractor-runner/node_modules/protractor/bin/webdriver-manager --chrome update
grunt

While developing widgets, you may want to run the tests as a change occurs, here is a way to achieve that:

npm install -g nodemon
nodemon -w lib/widgets/ --exec "protractor ./test/protractor.conf.js"

You can also run the tests on a single widget like that:

TESTED=variable nodemon -w lib/widgets/ --exec "protractor ./test/protractor.conf.js"

This will only run the cam-widget-variable tests.

grunt connect:widgetTests:keepalive

grunt karma

Add to protractor.config.js:

directConnect: true,

Run in commons-ui folder:

rm -rf node_modules
npm install —-legacy-bundling

Open webdriver-manager and change mac32.zip to mac64.zip if you run a newer macOS version.

vim /camunda-commons-ui/node_modules/protractor/bin/webdriver-manager

Run chrome update for protractor

camunda-commons-ui/node_modules/protractor/bin/webdriver-manager --chrome update

Unless otherwise specified this project is licensed under Apache License Version 2.0.

• Daniel meyerdan Meyer - @meyerdan
• Valentin zeropaper Vago - @zeropaper
• Nico Nikku Rehwaldt - @nrehwaldt
• Sebastian Stamm - @seb_stamm