DavidePastore / camunda-commons-ui

Common resources and libraries for camunda web applications

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

camunda-commons-ui

Common frontend / UI resources and libraries for camunda web applications:

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

Content

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

Widgets

Widgets are reusable components which should be easy to integrate in the Camunda webapps (admin, cockpit and tasklist) and your own projects.

Usage

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.

Available widgets

  • cam-widget-bpmn-viewer
  • cam-widget-debug
  • cam-widget-footer
  • cam-widget-header
  • cam-widget-inline-field
  • cam-widget-loader
  • cam-widget-search
  • cam-widget-search-pill
  • cam-widget-variable
  • cam-widget-variables-table

Developing the widgets

grunt auto-build

Testing the widgets

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.

Test

grunt karma

License

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

Authors

About

Common resources and libraries for camunda web applications

License:Apache License 2.0


Languages

Language:JavaScript 62.0%Language:HTML 29.4%Language:CSS 8.5%