Skip to content

Commit

Permalink
#7 README information.
Browse files Browse the repository at this point in the history
  • Loading branch information
nadnoslen committed Oct 29, 2018
1 parent 1f6eb55 commit 0a4d292
Show file tree
Hide file tree
Showing 2 changed files with 80 additions and 38 deletions.
98 changes: 62 additions & 36 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,62 +1,62 @@
# cppdist-com-emberjs
# README - cppdist-com-emberjs

This README outlines the details of collaborating on this Ember application.
A short introduction of this app could easily go here.
The EmberJs application for Canadian Pump & Packing Distribution. This Ember application will talk to the Rails API
server over at [https://github.com/cybertooth-io/cppdist-com-rails](https://github.com/cybertooth-io/cppdist-com-rails).

## Prerequisites
## Development - Getting Started

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

* [Git](https://git-scm.com/)
* [Node.js](https://nodejs.org/) (with npm)
* [Ember CLI](https://ember-cli.com/)
* [Google Chrome](https://google.com/chrome/)
* [Yarn](https://yarnpkg.com/en/)
* [Node.js](https://nodejs.org/) - consider using [NVM](https://github.com/creationix/nvm)
* [Ember CLI](https://ember-cli.com/) - make sure to install the CLI `yarn global ember-cli`
* [Google Chrome](https://google.com/chrome/) - unit tests run through testem require Chrome

## Installation

* `git clone <repository-url>` this repository
* `cd cppdist-com-emberjs`
* `npm install`
### First Time Setting Up

## Running / Development
1. `git clone [email protected]:cybertooth-io/ccpdist-com-emberjs.git` - to download the code; `cd ccpdist-com-emberjs.git` to get into the checked out code
1. `yarn` or `yarn install` - will install all javascript libraries

* `ember serve`
* Visit your app at [http://localhost:4200](http://localhost:4200).
* Visit your tests at [http://localhost:4200/tests](http://localhost:4200/tests).
### Running The Server

### Code Generators
`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](http://localhost:4200).

Make use of the many generators for code, try `ember help generate` for more details
While your Ember server is running, feel free to check out the tests by
visiting [http://localhost:4200/tests](http://localhost:4200/tests).

### Testing

Ember comes with linters and qunit testing.

`ember t` - will run the tests once in your console

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

* `ember test`
* `ember test --server`
`ember t -s --filter='role'` - will run tests only tests with the word _role_ in their path

### Linting

* `npm run lint:hbs`
* `npm run lint:js`
* `npm run lint:js -- --fix`
* `yarn run lint:hbs`
* `yarn run lint:js`
* `yarn run lint:js -- --fix`

### Building
### Development Workflow

* `ember build` (development)
* `ember build --environment production` (production)
#### Code Generators

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

Specify what it takes to deploy your app.
_...More Coming soon_

## Further Reading / Useful Links
## Deployment

* [ember.js](https://emberjs.com/)
* [ember-cli](https://ember-cli.com/)
* Development Browser Extensions
* [ember inspector for chrome](https://chrome.google.com/webstore/detail/ember-inspector/bmdblncegkenkacieihfhpjfppoconhi)
* [ember inspector for firefox](https://addons.mozilla.org/en-US/firefox/addon/ember-inspector/)
### Configuration Notes

## Addons
#### 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!
Expand All @@ -74,3 +74,29 @@ $ 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](https://emberjs.com/)
* [ember-cli](https://ember-cli.com/)
* Development Browser Extensions
* [ember inspector for chrome](https://chrome.google.com/webstore/detail/ember-inspector/bmdblncegkenkacieihfhpjfppoconhi)
* [ember inspector for firefox](https://addons.mozilla.org/en-US/firefox/addon/ember-inspector/)
20 changes: 18 additions & 2 deletions yarn.lock
Original file line number Diff line number Diff line change
Expand Up @@ -1672,7 +1672,7 @@ broccoli-clean-css@^1.1.0:
inline-source-map-comment "^1.0.5"
json-stable-stringify "^1.0.0"

broccoli-concat@^3.2.2, broccoli-concat@^3.5.1:
broccoli-concat@^3.2.2, broccoli-concat@^3.5.1, broccoli-concat@^3.7.1:
version "3.7.3"
resolved "https://registry.yarnpkg.com/broccoli-concat/-/broccoli-concat-3.7.3.tgz#0dca01311567ffb13180e6b4eb111824628e4885"
dependencies:
Expand Down Expand Up @@ -2885,6 +2885,22 @@ ember-cli-string-utils@^1.0.0, ember-cli-string-utils@^1.1.0:
version "1.1.0"
resolved "https://registry.yarnpkg.com/ember-cli-string-utils/-/ember-cli-string-utils-1.1.0.tgz#39b677fc2805f55173735376fcef278eaa4452a1"

ember-cli-template-lint@^1.0.0-beta.2:
version "1.0.0-beta.2"
resolved "https://registry.yarnpkg.com/ember-cli-template-lint/-/ember-cli-template-lint-1.0.0-beta.2.tgz#0ebd2f8c1f9ca47f9ee3b42755d66262440c14f6"
dependencies:
aot-test-generators "^0.1.0"
broccoli-concat "^3.7.1"
broccoli-persistent-filter "^1.4.3"
chalk "^2.4.1"
debug "^3.1.0"
ember-cli-version-checker "^2.1.2"
ember-template-lint "^1.0.0-beta.5"
json-stable-stringify "^1.0.1"
md5-hex "^2.0.0"
strip-ansi "^4.0.0"
walk-sync "^0.3.3"

ember-cli-test-info@^1.0.0:
version "1.0.0"
resolved "https://registry.yarnpkg.com/ember-cli-test-info/-/ember-cli-test-info-1.0.0.tgz#ed4e960f249e97523cf891e4aed2072ce84577b4"
Expand Down Expand Up @@ -3211,7 +3227,7 @@ ember-source@~3.4.0:
jquery "^3.3.1"
resolve "^1.6.0"

ember-template-lint@^1.0.0-beta.6:
ember-template-lint@^1.0.0-beta.5, ember-template-lint@^1.0.0-beta.6:
version "1.0.0-beta.6"
resolved "https://registry.yarnpkg.com/ember-template-lint/-/ember-template-lint-1.0.0-beta.6.tgz#a49d6a37beb3fd7bdae17472efc8ec298d739aa9"
dependencies:
Expand Down

0 comments on commit 0a4d292

Please sign in to comment.