Uses https://github.com/facebook/create-react-app/ as the boilerplate.
- Node 20 or greater, available in
$PATH
; - Java 17, available in
$PATH
. Necessary only to build the package.
To install the necessary dependencies for the first time:
$ npm ci
To update package-lock.json
run
$ ../mvnw clean package # only for the first run
$ ../mvnw com.github.eirslett:frontend-maven-plugin:npm -Darguments=install
First time:
$ npm ci
$ npm start
The browser should automatically open on http://localhost:3000 (the initial load might take a while, especially on slower machines).
The ci
step can be skipped for subsequent runs.
The dev mode has the following limitations:
- file download (e.g. downloading raw logs) doesn't work;
- custom forms don't work.
In order to use those features, you need to run the UI in production mode (see below).
../mvnw clean install
Specify the path to the build
directory when you start
the Server:
BASE_RESOURCE_PATH=/path/to/repository/concord/console2/build
The UI will be accessible on http://localhost:8080
Note: avoid using symlinks in BASE_RESOURCE_PATH.
The proxy
property in the package.json file is used to
proxy API requests to the server. It can be used to point the UI in dev mode to
another server.