The Ember.js command line utility.
Supports node 0.12.x and npm 2.6.x.
- irc: #ember-cli on freenode
- issues: ember-cli/issues
- website: ember-cli.com
Additional components of this project which are used at runtime in your application:
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.
Please read the official npm-link documentation and the npm-link cheatsheet for more information.
Use npm run autotest
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,
please run: npm run test-all
. Please note, this is what travis
runs.
To exclude a test or test suite append a .skip
to it()
or describe()
respectively (e.g. it.skip(...)
). To focus on a certain test or test suite append .only
.
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 sysctl.conf
.
echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.d/99-sysctl.conf && sudo sysctl --system
Use 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.