README - ermahgerd-emberjs-jwt-token

This Ember application talks to a Rails API server over at https://github.com/cybertooth-io/ermahgerd-rails-api-jwt.

Development - Getting Started

You need the following:

• Git
• Yarn
• Node.js - consider using NVM
• Ember CLI - make sure to install the CLI yarn global ember-cli
• Google Chrome - unit tests run through testem require Chrome

First Time Setting Up

1. git clone [email protected]:cybertooth-io/ermahgerd-rails-api-jwt.git - to download the code
2. cd ermahgerd-rails-api-jwt - to get into the checked out code
3. yarn or yarn install - will install all javascript libraries

Running The Server

ember s --proxy=http://localhost:3000 - runs the server and proxies all Ember Data requests to http://locahost:3000 (that's a Rails API server). Find your app at http://localhost:4200.

While your Ember server is running, feel free to check out the tests by visiting http://localhost:4200/tests.

Testing

Ember comes with linters and qunit testing.

ember t - will run the tests once in your console

ember t -s - will run the tests in a new Chrome window and watch for changes

ember t -s --filter='role' - will run tests only tests with the word role in their path

Linting

• yarn run lint:hbs
• yarn run lint:js
• yarn run lint:js -- --fix

Development Workflow

Code Generators

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

...More Coming soon

Deployment

Configuration Notes

Addons

Please use this section to mention the addons that we've been installing that way if we do an upgrade and need to bring them all back we can!

# SASS for stylesheets; make sure to renamed app/styles/app.css -> app/styles/app.scss
$ ember install ember-cli-sass
# Bootstrap 4 support; bring it all in looks like bootstrap@^4.1.0 comes in, should be bootstrap@~4.1.0 
$ ember install ember-cli-bootstrap-4
# For authentication
$ ember install ember-simple-auth
$ ember install ember-simple-auth-token
# Encouraged to stop using this, but I actually love this helper
$ ember install ember-route-action-helper
$ ember install ember-concurrency

config/environment.js

1. ember-simple-auth-token is configured in here. Needs to match the token & cookie authentication paths in your API server.

Building

ember b - builds for your development environment

ember build --environment production - builds for production minifying and shrinking

...More Coming soon

Contributing

Team members, create a branch and pull request.

General Public: Fork and create pull request.

Further Reading / Useful Links

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