Skip to main content

Creating a New App

The following steps are required to create a new HubX application:

Creating a new repository​

  • Creating a new repo via Web.Template, using the naming pattern Web.APPNAME.

Configuring the application​

  • Replace sample for the name entry in package.json to the required name of the application
  • Edit the path in package.json to the required url for the application.

Both of these entries need to be unique in the system. You will receive a validation error if either are not unique during the routes setup process, but there is currently no check during this part of the process but you can refer to the routes to check.

Running the application locally​

The following steps are required to create a new HubX application:

Creating the Repoostory​

  • Creating a new repo via Web.Template, using the naming pattern Web.APPNAME, where APPNAME contains only alpha numberic characters.

Configuring the application​

  • Replace sample in the name of package.json to the required name of the application name. This name needs to be unique.
  • Edit the path in package.json to the required url for the application. This will be used in the routing section to register the application within HubX.

Running the application​

  • Run yarn install on the new repository.
  • Run yarn start.
  • The browser will open to http://localhost:3000/APP_URL_PATH showing the app within the HubX Shell.

Updating the Routes files​

Refer to the routes section of the documentation to add a new entries to the routes file for each environment.

Creating a new Azure Pipeline.​

Refer to the

  • Create a new pipeline in the Cova Web Project.
    • New Pipeline
    • Save the pipeline
    • Rename the pipeline to remove RetailInnovationLabs for clarity in the list.

Adding an entry to the HubX menu​

  • Refer to the menu items section to create an entry in the HubX menu.