jeffmarston / fixalicious-ui

Fixalicious UI using node.js and socket.io

FIXalicious UI

FIXalicious UI is a front end for the FIXalicious FIX simulator. It uses node.js, Angular, ag-grid, redis, and socket.io to provide a realtime and interactive UI for sending and automating FIX simulations.

Prerequisites

• node.js https://nodejs.org
• typescript https://www.typescriptlang.org
• redis https://redis.org
• fixalicious https://github.com/rbaxter1

Design

Fixalcious-ui is a front end to Fixalicious, so it is quite useless by itself. This project has two parts, a node.js server and an Angular client.

The server communicates to Fixalicious using shared keys in Redis for realtime messaging, and HTTP REST calls to send new messages. It also persists configuration for the client, such as action templates and scenarios.

The client calls the server APIs to get data, and subscribes to a socket.io channel for realtime updates of FIX transations and session information.

Run it!

Client

The client is written in Typescript and needs to be built before it can be run. Make sure you have a recent version of Typescript installed! Change to the client folder, install dependencies, and build it:

> cd client
> npm install
> tsc

If you get compilating errors, your version of Typescript may be older. Sometimes Typescript has been installed by Visual Studio and that is in your PATH. If so, I recommend removing it from your PATH.

To see what version is running:

> tsc -v

To see where it's running from (on Windows):

> where tsc.exe

Server

The server only needs dependencies installed, so change to the server folder, install dependencies, and run the following:

> cd server
> npm install
> node server.js

That's it! you're up and running with the defaults. Navigate to localhost:4400 or go directly to the client.

http://localhost:4400/client

Options

Fixalicious can publish on multiple channels. By default, we listen to the channel "ui". This can be changed using the "subscriber" argument.

For all options, run with the -? switch:

> node server.js -?
Options:
  --port, -p        Port to serve HTTP content                 [default: "4400"]
  --subscriber, -s  FIXalicious channel                          [default: "ui"]
  --redis_host      Redis server hostname                 [default: "localhost"]
  --redis_port      Redis server port                          [default: "6379"]
  --help, -?        Show help                                          [boolean]

Usage Overview