This is APISuite's core frontend repository.

• Node.js >=v15.14.0

npm i

If you need to use your version of APISuite's portal (either because you're using a fork or want to install extensions), it is advised to use the existing Dockerfile.

• Create the .env file and change the URLs accordingly
• Create the extensions configuration file (see EXTENSIONS.md for more details)
• Make the Docker image: docker build -t your-tag .

Some dependencies (node modules) might be hosted in private GitHub repos. This might be the case when using UI extensions. In this case, you need to have your local machine and Git host (GitHub) set up with your SSH keys before running npm install. If you need help, read this documentation.

1. Copy the .env.sample file to .env and adapt it to your setup

To start a webpack development server that rebuilds the project on every change, run:

npm run dev

To create a build:

npm run build

Go to https://localhost.develop.apisuite.io:9001

The APISuite Portal can be extended through APISuite UI Extensions. For more details consult the EXTENSIONS.md documentation.

In order for the login flow to work and be secure cookie are used and are blocked to specific domains. So to be able to run the app locally you need to edit you host file (/etc/hosts) and add the following: 127.0.0.1 localhost.develop.apisuite.io.

[email protected]: Permission denied (publickey).
fatal: Could not read from remote repository.

There's something wrong with your SSH Key setup. Read this documentation.

Run tests with npm test or npm run cy for independent test selection and visualization.

• keep all test IDs in src/testIds.ts
• always insert test ID attribute as first attribute in the element

<Grid
    data-test-id={testIds.greetingSection}
    ...