This is the Web UI for the cleanURI service.

The Docker container can be configured using environment variables:

• REACT_APP_API_GATEWAY: URL to the API Gateway (default: http://localhost:8080)

Please note that this configuration is not available when the app is run locally. In this case configuration variables will have their default values.

The Web UI is based on React and requires NodeJS > 14. Debian packages can either be downloaded on the NodeJS website or are available from the backports repository.

In the project directory, you can run:

npm start

This runs the app in the development mode.
Open http://localhost:3000 to view it in your browser.

The page will reload when you make changes.
You may also see any lint errors in the console.

In the project directory, you can run:

npm test

This launches the test runner in the interactive watch mode.
See the section about running tests for more information.

The current version expects an API Gateway running at localhost:8080. This location will be part of the application configuration in future releases.

An HTTP daemon serving the static content can be run as follows:

docker run --rm \
  -e REACT_APP_API_GATEWAY="api gateway uri" \
  -p 8080:80 \
  mrtux/cleanuri-webui

Note that the default API gateway points at http://localhost:8080/ and therefore will not be available in the Docker container. Please don't forget to set a working URL for the API Gateway here.

To run with docker compose copy .env.template to .env and edit the necessary variables. Then start with:

docker compose --build --env-file .env up

Please note that this compose file will rebuild the image based on the repository. This is helpful during development and not intended for production use.

When done, please don't forget to remove the deployment with

docker compose down

In the project directory, you can run:

npm run build

Builds the app for production to the build folder.
It correctly bundles React in production mode and optimizes the build for the best performance.

The build is minified and the filenames include the hashes.
Your app is ready to be deployed!

See the section about deployment for more information.

• Stefan Haun (@penguineer)

PRs are welcome!

If possible, please stick to the following guidelines:

• Keep PRs reasonably small and their scope limited to a feature or module within the code.
• If a large change is planned, it is best to open a feature request issue first, then link subsequent PRs to this issue, so that the PRs move the code towards the intended feature.

MIT © 2022-2025 Stefan Haun and contributors