gpii-app is an Electron-based application wrapper for the GPII autopersonalization system.

It currently only supports Windows.

It is possible to provision a Windows VM for development and testing purposes. Please ensure you have met these VM requirements before proceeding.

After that you can use the vagrant up command to create an instance of a Windows 10 Evaluation VM which will boot an instance of the Windows 10 VM, pull in the GPII Framework's npm dependencies, and then build it. Once it has finished building, either restart the VM, or open a Command Line or PowerShell and type the following command inside the VM: refreshenv

If this is your first time creating this VM an 8 GB download will take place. The downloaded image will be valid for 90 days after which the Windows installation will no longer be useable. To remove an expired image you can use the vagrant box remove "inclusivedesign/windows10-eval" command.

Now you can open a command prompt window and use the following commands to run the GPII app:

cd c:\vagrant\
npm start

Alternatively, running the application in development mode will give you a list of snapsets in the task tray menu:

npm run dev

Ensure that your virtual box is up and running, then open a terminal (in the VM), go to the folder with gpii-app and run the test script:

cd v:\
npm test

This will also instrument the code and generate a coverage report in the reports subdirectory. If you want to run the tests without collecting code coverage data, you can use commands like the following instead:

cd v:\
npm run test:noCoverage