1. Make sure you have Node.js version >= 18 installed
2. Run script to patch your /etc/hosts
3. Make sure you are using Red Hat proxy

1. Install dependencies with npm install
2. Run development server with npm run start:proxy
3. Local version of the app will be available at https://stage.foo.redhat.com:1337/insights/advisor/

In case you want to use the stable environment instead of beta you can run the app with npm run start:proxy and access it from https://stage.foo.redhat.com:1337/insights/advisor/. Usually there is no difference between these two environments unless there is a large feature in progress which is hidden behind isBeta flag.

If you want to test Advisor with another application deployed locally, you can utilise LOCAL_APPS environment variable and deploy the needed application on separate ports. To learn more about the variable, see https://github.com/RedHatInsights/frontend-components/tree/master/packages/config#running-multiple-local-frontend-applications.

We'll take for example insights-inventory-frontend.

Open new terminal, navigate to Inventory repository, and run it on a separate port without proxy:

npm run start -- --port=8003

In a separate terminal, run Advisor with proxy enabled and list Inventory:

LOCAL_APPS=inventory:8003~http npm run start:proxy

Travis is used to test the build for this code.

• npm run test will run tests.
• npm run lint will run all linters.

Before opening a pull request, you can run npm run verify:local to make sure your changes pass automated tests (Jest and Cypress) and linter (both JS and CSS linters).

The app uses containerized builds which are configured in app-interface.

Translation keys are saved in messages.js.

Each time you add a new translation keys you need to run npm run translations, which will automatically generate JSON files for every language into locales/ folder based on the entries in the messages.js.

There are two ways to use translated strings:

1. With intl.formatMessage(messages.messageId)
2. With <FormattedMessage {...messages.messageId}/>

This project uses Patternfly React.

This app imports components from Insights Front-end Components library. ESI tags are used to import Insights Chrome which takes care of the header, sidebar, and footer.