HospitalRun frontend

Ember frontend for HospitalRun

To run the development environment for this frontend you will need to have Git, Node.js, Ember CLI, Bower and CouchDB installed.

Install

To install the frontend please do the following:

• Make sure you have installed Git
• Make sure you have installed Node.js. Versions after 0.10.0 should work, but please note if you encounter errors using 5.x it may be necessary to upgrade your npm version. Versions after 3.5.x should work:
  1. npm install -g npm
• Install ember-cli v1.13.13: npm install -g ember-cli@1.13.13
• Install bower: npm install -g bower
• Clone this repo with git clone https://github.com/HospitalRun/hospitalrun-frontend, go to the cloned folder and:
  1. npm install to install needed node modules.
  2. bower install to install needed bower modules.
• Install ands configure CouchDB
  1. Download and install CouchDB from http://couchdb.apache.org/#download
  2. Create admin user:
  3. If you have just installed CouchDB and have no admin user, please run initcouch.sh. A user hradmin will be created with password: test.
  4. If you already have a CouchDB admin user, please run initcouch.sh USER PASS where USER and PASS are the CouchDB admin user credentials.
• Copy the server/config-example.js to server/config.js.

Start

To start the frontend please do the following:

• Start the server by running ember serve in the repo folder.
• Go to http://localhost:4200/ in a browser and login with username hradmin and password test.

Testing

Fixtures for Acceptance Tests

Fixtures are PouchDB dumps that are generated with pouchdb-dump-cli.

To create a fixture, run pouchdb-dump http://localhost:5984/main -u hradmin -p test | cat > tests/fixtures/${name_of_fixture}.txt.

To use a fixture, use loadPouchDump(${name_of_fixture})` in your acceptance test. For example,

test('visiting /patients', function(assert) {
  loadPouchDump('default');
  authenticateUser();
  visit('/patients');
  andThen(function() {
    assert.equal(currentURL(), '/patients');
  });
});

Contributing

Contributions are welcome via pull requests and issues. Please see our contributing guide for more details.