wholetale/dashboard repository overview

⁠Wholetale

This README outlines the details of collaborating on this Ember application.

This is the EmberJS/Semantic UI WholeTale dashboard.

⁠Prerequisites

You will need the following things properly installed on your computer.

• Git⁠
• Node.js⁠ (with NPM)
• Bower⁠
• Ember CLI⁠
• PhantomJS⁠

⁠Installation

• git clone <repository-url> this repository
• change into the new directory
• npm install
• bower install

⁠Running / Development

• ember serve
• Visit your app at http://localhost:4200⁠.

Running using the test Dev Environment:

• ember s --environment=test-dev

Running using the production Environment:

• ember s --environment=production

Run using development (default):

• ember s

⁠Authentication

Girder does not issue cookies for localhost. To authenticate on localhost, you will need to first log into https://girder.wholetale.org/⁠ and then copy the cookie locally.

⁠Code Generators

Make use of the many generators for code, try ember help generate for more details

⁠Running Tests

• ember test
• ember test --server

⁠Building

• ember build (development)
• ember build --environment production (production)

⁠Deploying

Specify what it takes to deploy your app.

⁠Further Reading / Useful Links

• ember.js⁠
• ember-cli⁠
• Development Browser Extensions
  • ember inspector for chrome⁠
  • ember inspector for firefox⁠

⁠A note of PODs and components

Wholetale uses components in the Pods structure and uses this add on:

ember install ember-cli-component-pod

to allow components to be generated in this format. The resulting structure looks like this for a component called shape-3d:

shape-3d/component.js shape-3d/style.scss shape-3d/template.js

which allow you to add specific CSS styles, javascript functonality and HTML templates for the components. To create a new component, you would use the following Ember CLI:

ember g component-pod shape-3d

which would create the component, template and stylesheet.

Clean Installation

bower cache clean bower install --force bower prune

⁠Notes

We use Ember truth helpers to make the handle bars code more readable:

https://github.com/jmurphyau/ember-truth-helpers⁠