User Interfaces

Building an interface for ACA 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

  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 ACA 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 ACAEngine 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.

Angular Resources

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

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