User Interfaces

Building an interface for Engine is the same as building any generic web application. We try to follow industry best practices and leverage the tools used by most developers in the industry.

• NOTE:: Windows users are recommended to install the Linux subsystem for Windows.

  • Tools such as git and your preferred text editor make sense to run on Win32

  • Whilst both NodeJS and Ruby can run natively on Windows they are much harder to manage and use effectively when compared to their Linux counterparts.

What you will need

Please install the following applications as they are core requirements for interface development

1. git - version control

2. A text editor

   • Sublime Text

   • Atom

   • Visual Studio Code

   • Font Ligatures are cool

3. NodeJS - development platform

4. Ruby

Install some core tools

The tools and libraries that help with development are available via npm which is the Node Package Manager. We recommend installing the following command line helpers

• Angular CLI npm install -g @angular/cli

• Gulp npm install --global gulp-cli

Running the Demo UI

This is a project that can run against the Engine development environment, for those who want some instant gratification.

1. Create a folder for storing your interface projects

2. Open a command prompt at that location

3. Clone the Composer Starter git clone https://github.com/acaprojects/ngx-composer-starter.git

4. cd ngx-composer-starter to move into the folder

5. npm install to install the project dependencies

6. gulp serve to run the development server

NB: If you are planning to run the user interface project without the Engine Developer environment, in Step 6 above you will need to use gulp serve --mock this will allow the interface to run 'headless' with mock data for development purposes.

NB: While the existing UIs are relatively plug'n'play with a locally spun up Engine environment, a domain must first be set for localhost or your machine's IP address before authentication will be functional. Ensure the domain that's set is the same as what you're accessing the frontend app with and matches the composer config in settings.json. i.e. What's typed into the browser address bar matches the settings.json and the domain configured in Engine.

Angular Resources

Angular is our preferred web application framework. We recommend being familiar with it before continuing.

• https://angular.io/guide/quickstart - for a basic understanding of Angular applications

• https://angular.io/tutorial - fundamentals of Angular

Updating your environment

This will keep you running on the latest version of the platform as there are periodic updates.

• Updating NPM: npm install npm@latest -g

• Updating NodeJS (Windows users should download the latest MSI, unless using the Linux subsystem)

  • sudo npm cache clean -f

  • sudo npm install -g n

  • sudo n stable