The Ember.js command line utility.
Supports node 0.12.x and npm 2.6.x.
Additional components of this project which are used at runtime in your application:
Working with master
git clone https://github.com/ember-cli/ember-cli.git cd ember-cli npm link
npm link is very similar to
npm install -g except that instead of downloading the package from the repo the just cloned
ember-cli/ folder becomes the global package. Any changes to the files in the
ember-cli/ folder will immediately affect the global ember-cli package.
Now you can use
ember-cli via the command line:
ember new foo cd foo npm link ember-cli ember server
npm link ember-cli is needed because by default the globally installed
ember-cli just loads the local
ember-cli from the project.
npm link ember-cli symlinks the global
ember-cli package to the local
ember-cli package. Now the
ember-cli you cloned before is in three places: The folder you cloned it into, npm's folder where it stores global packages and the
ember-cli project you just created.
If you upgrade an app running against Ember CLI master you will need to re-link to your checkout of Ember CLI by running
npm link ember-cli in your project again.
Working with the tests
npm test to run the tests (Runs only fast tests).
For a full test run which includes some very slow acceptance tests,
npm run test-all. Please note, this is what travis
To exclude a test or test suite append a
describe() respectively (e.g.
it.skip(...)). To focus on a certain test or test suite append
Please read the official mocha documentation for more information.
When running ember cli it could happen that a lack of file watches can occur. You will get an error message like:
Serving on http://localhost:4200 watch ENOSPC Error: watch ENOSPC at errnoException (fs.js:1019:11) at FSWatcher.start (fs.js:1051:11) ...
This problem will be corrected in future releases. The following line is a workaround to get the server up and running until this problem is fixed. See Issue 1054.
echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p
For Arch Linux or Manjaro Linux, in order for the parameters to be loaded at boot, the kernel sysctl parameters have to be saved in a drop-in directory instead of
echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.d/99-sysctl.conf && sudo sysctl --system
npm run docs to build HTML and JSON documentation with YUIDoc and place it in
docs/build/. Please help by improving this documentation.
All donations will support this project and treats for contributors.
ember-cli is MIT Licensed.