Deploy a Frontend Interface

CI/CD

To work with PlaceOS frontend repositories must have build artifacts committed to a standalone repository or branch.

The user-interfaces repository already has CI/CD pipelines setup using GitHub Actions.

The user-interfaces repository follows these steps for the build pipeline:

1. Commit made with changes to libs or an application(apps/<project>)

2. Pipeline in GitHub Actions starts

3. Install dependencies and build application(s)

4. Commit build artifacts to associated branch. For example, a development build of workplace will be committed to build/workplace/dev

Backoffice Setup

Once a build has been created it can be added to Backoffice so that frontends service can pull down the interface.

Add Repository

1. Navigate to the repositories page

2. Add a new repository

• Name should describe the UI

• Folder name will be the path of the UI on the domain e.g. workplace would map to https://my.domain/workplace/

• Repository is the URL of your git repository with the UI builds

• Repository type must be Interface for the deployment of a UI

• Branch is the build branch of the User Interface

Configure Routing

1. You will need to register the new application on your domain.

   • Navigate to Domains

   

   • Select your application domain + Navigate to the applications tab + Press new Application

   

   • The login URL should be set to the location of your oauth-resp.html file from ts-client

After that you should be able to access your application at the URL https://my.domain/<folder>/.

Updating

Once the application is setup in Backoffice it should automatically pull any changes to the set branch every hour. If you to make a manual update there is a pull button in the about section of the repositories page.