Hawtio.next

A Hawtio reimplementation based on TypeScript + React. This project reimplements the following Hawtio JS components in one project:

• hawtio-core
• hawtio-integration
• hawtio-oauth

Development

This project uses tsup and Webpack for building packages.

See also Developing Hawtio.next for the project styling, guidelines, and more details on development.

Prerequisites

You need to have installed the following tools before developing the project.

• Node.js >= 18
• Yarn v4

Important

Building requires Yarn Berry (v2+). The default installation version of yarn on many operating systems is 1.22.19 (the classic version). This might cause a problem when building the project. As a result, the mandated minimum version has been set to 4.0.0.

If yarn install is attempted with a version lower than 4.0.0 then an error message is displayed, eg.

$ /usr/bin/yarn install
yarn install v1.22.19
[1/5] Validating package.json...
error @hawtio/[email protected]: The engine "yarn" is incompatible with this module. Expected version ">=4". Got "1.22.19"
error Found incompatible module.

If you have enabled corepack already, the project should automatically use the version of yarn committed to the repository itself.

corepack enable

$ yarn --version
4.0.1

Developing

After checking out the project, run the following command to set up the project dependencies.

yarn install

Then, build the whole project first.

yarn build:all

You can start developing the project by running the following command and then opening http://localhost:3000/ in the browser.

yarn start

Then run another Java application which has a Jolokia endpoint from a different terminal, and connect to it from the Connect tab in the Hawtio console. For example, you can run this Spring Boot example in background.

mvn spring-boot:run

You can connect to this example application at the Jolokia URL: http://localhost:10001/actuator/hawtio/jolokia. Open the Connect tab and create a connection with the following parameters:

• Name: <any name>
• Scheme: HTTP
• Host: localhost
• Port: 10001
• Path: /actuator/hawtio/jolokia

Building

To build the project for production, run the following command. It's built into the build/ directory.

yarn build:all

Testing

To execute the unit tests, run the following command.

yarn test:all

Linting

It is recommended to run linting against the code periodically with the following command.

yarn lint && yarn format:check

E2E

Read Running E2E tests locally.

Contributing

When making a PR E2E tests from hawtio/hawtio will be run against your frontend. If you want to specify a different branch to run the tests from you can add `branch: [remote:]branch` to the PR description, ie. branch: e2e-test-fix or in your own fork branch: jdoe:my-branch.