Omicron Client

Front end for the Omicron System

Badges

The following are reports from various automated codebase monitoring systems. Each one is linked to their respective service.

Build Status
Coveralls Code Coverage Report
License
Dependency Status
codeclimate automated code-quality reports
Project Management
Docs

Development Machine

A build of the latest master branch of this repository is hosted on omicronclient.herokuapp.com

Installation

Installation is dependent on whether you want to configure this project for development, testing, or production. The state of the application is controlled by the NODE_ENV environment variable. On Linux / OSX / any Unix-like operating system, the value can be set using

    export NODE_ENV=testing

On Windows machines, this can be done using

    set NODE_ENV=testing

If the variable is unset, this app will assume that the value is development. If deploying to a production machine, this will result in unneeded instrumenters and development features (such as hot loading) to be added to the output code.

Installation Requirements

Git
Node.js
Node Package Manager (npm) (Should come bundled with node)

Optional

GitHub Desktop is a useful front end for the command-line based git version control system.

Installing for Development

1.a) If you do not have push access to this repository, fork it and clone that repo into your machine. At that point, keeping your code up to date with this project is your responsibility. To request push access to this repo, please open up an issue in the issue tracker.

1.b) If you do have push access, clone this repo onto your system by running

    git clone https://github.com/MichalKononenko/OmicronClient.git

cd into your cloned repo and npm install the JavaScript libraries on which this site depends.
Open a new command line, cd into the repository, and set the NODE_ENV environment variable to test. This can be done using
```
 export NODE_ENV=test
```
or
```
 set NODE_ENV=test
```
if you're on a Windows machine.
In this window, run
```
 karma start --single-run=false
```
and give it a few moments to spin up. This will run the unit test suite for the app, and rerun the test suite every time any code is changed in the repository. Make sure the unit tests pass before sending in a pull request. If you make a code change, change the test as well.
Open a new command line, cd into the repository, and run
```
 node .\node_modules\webpack-dev-server\bin\webpack-dev-server.js --inline --hot
```
This will start up a new webpack-dev-server that will automatically build your Javascript code, and serve it to you on localhost:8080. It will also preserve the state of your React components. Every time a code change is made, the website will refresh to reflect the change. It does, however, take a few seconds for the site to refresh.

Installing for Production

After installing the required hard dependencies for this project, clone this repository by running
```
     git clone https://github.com/MichalKononenko/OmicronClient.git
```
in your command line
cd into your cloned repo and run
```
     npm install
```
This will create a directory called node_modules where this project's Javascript dependencies will be loaded
Set the NODE_ENV environment variable to production by running
```
     export NODE_ENV=production
```
on Unix-like operating systems, or
```
     SET NODE_ENV=production
```
on Windows machines.
Run
```
     npm run compile
```
This will create a directory called dist, where the minified code, as well as any resources required for this site to work will be stored.
Serve this directory to users with a server of your choice, or through webpack-dev-server, for cases where scale is not required.