This is the Camunda Platform web application source. Clean, package and install it via Maven.
The structure is as follows:
assembly- Java sources and tests for the Camunda web application based onjavaxnamespace.assembly-jakarta- Java sources and tests for the Camunda web application based onjakartanamespace.- This module is created from the
assemblymodule via code transformation.
- This module is created from the
frontend- HTML, CSS and Javascript sources as well as Plugins and tests for the Camunda webapplications Cockpit, Tasklist and Admin.
There are 3 web applications available for the Camunda Platform :
- cockpit: an administration interface for processes and decisions
- tasklist: provides an interface to process user tasks
- admin: is used to administer users, groups and their authorizations
The webapps above are relying on 2 libraries:
- camunda-bpm-sdk-js: provides tools for developers who want interact with the platform using Javascript
- camunda-commons-ui: is a set of shared scripts, templates and assets, used in the different webapps
Parts of the web applications can be extended using plugins.
See plugin development guide for details.
English and german translations are located in the ui/<app>/client/locales folders.
Translations for other languages are available in the camunda-7-webapp-translations repository.
Has tools to work with the REST API and forms (included transitively via camunda-commons-ui).
Contains resources like images, .less stylesheets as well as some angular.js modules.
You need node.js >= 17 and npm.
See https://github.com/camunda/camunda-bpm-platform/blob/master/CONTRIBUTING.md#build-from-source
Build the web apps using Webpack:
# cd <path to your workspace>
git clone git@github.com:camunda/camunda-bpm-platform.git
cd camunda-bpm-platform/webapps/frontend
npm install
npm startTo start the server in development mode, call
cd camunda-bpm-platform/webapps/assembly
mvn jetty:run -PdevelopThe webapps are then available pointing a browser at http://localhost:8080. To login as an admin user, use jonny1 as username and password.
You can now start developing using the npm run start command in the frontend directory.
In order to run the Jakarta Webapps start Jetty the same way from the assembly-jakarta folder
cd camunda-bpm-platform/webapps/assembly
mvn jetty:run -Pdevelop
npm run startSince December 31, 2021, AngularJS is no longer officially supported by the original maintainers (Google). We replaced the official AngularJS libraries with the ones from HeroDevs to ensure that our used libraries stay secure and supported. We include the AngularJS libraries from HeroDevs in our Community Edition releases from 7.18.0-alpha2 on.
Heads-up: If you build the Webapps from source code, the build includes the no longer maintained AngularJS libraries in version 1.8.2 unless you have access to the HeroDevs registry and configure it as shown below.
Since December 31, 2021, the legacy Bootstrap 3 library is no longer officially supported by the original maintainers (twbs Bootstrap). We replaced the official Bootstrap 3 libraries with the ones from HeroDevs to ensure that our used libraries stay secure and supported. We include the Bootstrap 3 libraries from HeroDevs in our Community Edition releases from 7.23.0-alpha2 on.
Heads-up: If you build the Webapps from source code, the build includes the no longer maintained Bootstrap 3 libraries in version 3.4.1 unless you have access to the HeroDevs registry and configure it as shown below.
The angular-ui-bootstrap project is no longer being maintained. We replaced the official angular-ui-bootstrap libraries with the ones from HeroDevs to ensure that our used libraries stay secure and supported. We include the angular-ui-bootstrap libraries from HeroDevs in our Community Edition releases from 7.23.0-alpha2 on.
Heads-up: If you build the Webapps from source code, the build includes the no longer maintained angular-ui-bootstrap libraries in version 2.5.6 unless you have access to the HeroDevs registry and configure it as shown below.
Since 2024-01-15 the angular-translate project has been archived. We replaced the official angular-translate libraries with the ones from HeroDevs to ensure that our used libraries stay secure and supported. We include the angular-translate libraries from HeroDevs in our Community Edition releases from 7.23.0-alpha2 on.
Heads-up: If you build the Webapps from source code, the build includes the no longer maintained angular-translate libraries in version 2.19.0 unless you have access to the HeroDevs registry and configure it as shown below.
The angular-moment project has been archived on Nov 30, 2021. We replaced the official angular-moment libraries with the ones from HeroDevs to ensure that our used libraries stay secure and supported. We include the angular-moment libraries from HeroDevs in our Community Edition releases from 7.23.0-alpha2 on.
Heads-up: If you build the Webapps from source code, the build includes the no longer maintained angular-moment libraries in version 1.3.0 unless you have access to the HeroDevs registry and configure it as shown below.
To enable pulling the HeroDevs extended support libraries while building the Webapps, please configure the npm registry. Add the HeroDevs npm registry by replacing the variables ${HERODEVS_REGISTRY} and ${HERODEVS_AUTH_TOKEN} in the following commands and execute the commands in your terminal.
Commands to configure the HeroDevs npm registry:
npm set @neverendingsupport:registry=https://${HERODEVS_REGISTRY}/
npm set //${HERODEVS_REGISTRY}/:_authToken ${HERODEVS_AUTH_TOKEN}
Alternatively, you can set the following environment variables:
export HERODEVS_REGISTRY = "example.com" # Hostname without protocol (e.g., "https://"), leading or trailing slashes
export HERODEVS_AUTH_TOKEN = "abc..." # Token to authenticate against the registryYou receive the information about the registry and the auth token directly from XLTS.dev.
The supported browsers are:
- Chrome Latest
- Firefox Latest
- Edge Latest
Have a look at our contribution guide for how to contribute to this repository.
The source files in this repository are made available under the Apache License Version 2.0.