csantero/ember-cli

ember-cli

The Ember.js command line utility.

Supports node 0.12.x and npm 2.7.x and 3.x.

Community

• irc: #ember-cli on freenode
• issues: ember-cli/issues
• website: ember-cli.com

Project Elements

Additional components of this project that are used at runtime in your application:

• ember-resolver
• loader
• ember-cli-shims
• ember-load-initializers

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 test to run the tests (Runs only fast tests).

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

See CONTRIBUTING.md

Upgrading

• Change history of new Ember-CLI apps
• Change history of new Ember-CLI addons

Donating

All donations will support this project and treats for contributors.

License

ember-cli is MIT Licensed.