Installation

The following notes assume you are at the command prompt for your chosen environment.

1. Confirm Node and YARN are installed and configured correctly, both the following commands should return the relevant version number.

   > node –version

   > yarn –version

2. Clone the project from GitHub

3. Allow yarn to be able to include required SKAO libraries

   > npm config set @ska-telescope:registry https://artefact.skao.int/repository/npm-internal/

4. Install all the necessary project dependencies by running

   > yarn init

5. Install required SKAO libraries

It is expected that required SKAO libraries would have been included at this point, however if this is found not to be the case, the following command will include them.

> yarn skao:update

Steps to convert to your own application

Here are the steps required to migrate this application for use within the Portal. These are required so that we can ensure a unique reference into the Portal. For this example we will use the name NewApp as the name of the new application

1. Clone the application into the appropriate folder

2. Follow the installation instructions in the previous paragraph

3. ReactSkeleton.tsx : Change ReactSkeleton to NewApp in 2 locations

4. ReactSkeleton.tsx : Change filename to NewApp.tsx

5. ReactSkeleton.cy.tsx : Change ReactSkeleton to NewApp in 4 locations

6. ReactSkeleton.cy.tsx : Change filename to NewApp.cy.tsx

7. Change Folder name from ReactSkeleton to NewApp

8. App.tsx : Change ReactSkeleton to NewApp in 4 locations

9. webPack.config.js : Change path for ReactSkeleton so it points to NewAppNewApp.

Compilation and running this application will allow it to be shown within the ReactSkeleton menu item within the developer section of the SKAO-Portal. Whilst initial development is being done and until the application is allocated a permanent location, it is suggested that no other WebPack changes are done.

Steps to create a new release

Please refer document create a new release