Command line tool for developing ambitious ember.js apps
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:
git clone https://github.com/ember-cli/ember-cli.gitcd ember-clinpm 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 foocd foonpm link ember-cliember 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.
npm test to run the tests after every file change (Runs only fast tests). Use
npm test to run them once.
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:4200watch ENOSPCError: watch ENOSPCat errnoExceptionat FSWatcher.start...
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.