ember-cli
The Ember.js command line utility.
Supports node 0.12.x and npm 2.6.x.
Community
- irc: #ember-cli on freenode
- issues: ember-cli/issues
- website: ember-cli.com
Project Elements
Additional components of this project which are used runtime in your application:
Development Hints
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.
Please read the official npm-link documentation and the npm-link cheatsheet for more information.
Working with the tests
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.
Problems
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
Inline Documentation
Use npm run docs
to build HTML and JSON documentation with YUIDoc and place it in docs/build/
. Please help by improving this documentation.
Contribution
Upgrading
Donating
All donations will support this project and treats for contributors.
License
ember-cli is MIT Licensed.