Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

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 Build Status
  • Coverage Status Coveralls Code Coverage Report
  • License License
  • Dependency Status Dependency Status
  • Code Climate codeclimate automated code-quality reports
  • Stories in Ready Project Management
  • Documentation Docs
  • Deploy to Heroku

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

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

Optional

  1. 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
  1. cd into your cloned repo and npm install the JavaScript libraries on which this site depends.

  2. 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.

  3. In this window, run

    npm run continous_test

    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.

  4. 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

  1. 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

  2. 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

  3. 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.

  4. 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.

  5. Serve this directory to users with a server of your choice, or through webpack-dev-server, for cases where scale is not required.

About

The front end for accessing the Omicron System

Resources

License

Releases

No releases published

Packages

No packages published
You can’t perform that action at this time.