The Ember.js command line utility
Switch branches/tags
Clone or download
Turbo87 Merge pull request #8126 from gowthamrm/td_replace_string
Removed the usage of `td.replace('string', ...)`
Latest commit f0c436d Oct 15, 2018
Permalink
Failed to load latest commit information.
.github Update ISSUE_TEMPLATE.md Apr 30, 2017
.travis [Doc] Fix API doc deployment Sep 24, 2018
assets/architecture enforce styles, clean up whitespace and extra lines Oct 30, 2015
bin explain the old code in bin/ember Jun 8, 2017
blueprints Update `ember-source` and `ember-data` to v3.5.x Oct 15, 2018
dev Run eslint on changelog script Sep 6, 2018
docs Fix linting errors in beta. Oct 10, 2018
lib Add a deprecation message Oct 11, 2018
tests Removed the usage of `td.replace('string', ...)` Oct 15, 2018
.codeclimate.yml Add Code Climate config May 23, 2015
.editorconfig remove application.hbs newline Jan 29, 2017
.eslintignore [BUGFIX RELEASE] [BUGFIX LTS] Do not ignore dotfiles in ESLint Oct 13, 2018
.eslintrc.js lint for node@4 compatibility Jan 28, 2018
.gitattributes use eol=lf for windows Jan 13, 2016
.gitignore Upgrade istanbul to nyc Aug 7, 2018
.npmignore Add `yarn.lock` to `.npmignore` Sep 22, 2018
.travis.yml Enable BROCCOLI_2 and SYSTEM_TEMP by default. Oct 1, 2018
ADDON_HOOKS.md Use secure URLs in docs where possible Oct 17, 2016
ARCHITECTURE.md fix image uri Aug 31, 2017
Analytics.md Tidy-up & document analytics May 2, 2017
CHANGELOG.md Release v3.5.0 Oct 15, 2018
CODE_OF_CONDUCT.md Use https in references to emberjs website May 20, 2017
CONTRIBUTING.md Update testing instructions Aug 2, 2018
LICENSE [DOC] Update license year Jan 1, 2017
PERF_GUIDE.md Update minimum broccoli-viz version Sep 10, 2018
README.md Fix codeclimate badge svg Sep 19, 2018
RELEASE.md Adjust release instructions Oct 15, 2018
SOURCEMAPS.md Add a sourcemaps doc Nov 29, 2016
TRANSITION.md Fix typo in transition doc Sep 12, 2015
appveyor.yml Merge remote-tracking branch 'origin/beta' Jun 12, 2018
package.json Release v3.5.0 Oct 15, 2018
yarn.lock Bump to broccoli@2.0.0. Oct 1, 2018

README.md

ember-cli

Latest npm release TravisCI Build Status AppVeyor Build Status Test Coverage Code Climate

The Ember.js command line utility.

Features

  • Asset build pipeline using Broccoli.js
  • ES6 transpilation using Babel
  • Project structure conventions using ES6 module syntax
  • Development server including live-reload and API proxy
  • File/Project generator using blueprints
  • Unit, Integration and Acceptance test support using Testem
  • Powerful addon system for extensibility

Installation

npm install -g ember-cli

Usage

After installation the ember CLI tool will be available to you. It is the entrypoint for all the functionality mentioned above.

You can call ember <command> --help to find out more about all of the following commands or visit https://ember-cli.com/user-guide/ to read the in-depth documentation.

Create a new project

ember new my-new-app

This will create a new folder my-new-app, initialize a Git project in it, add the basic Ember.js project structure and install any necessary npm and Bower dependencies.

Create a new addon project

ember addon my-new-addon

This is essentially similar to ember new but will generate the structure for an ember-cli addon instead.

Build the project

ember build

This will create a dist folder and run the build pipeline to generate all the output files in it. You can specify --environment=production to build in production mode, which includes code minification and other optimizations.

Run the development server

ember serve

This will launch a development server that will automatically rebuild your project on file changes and serves the built app at http://localhost:4200/.

Run the test suite

ember test

This command will start the Testem runner, which will run all your tests from the tests folder. This command also supports a --server option which will automatically run tests on file changes.

Generate files

ember generate route foo

This will generate a route named foo. route is an example here and can be replaced by any other available blueprint. Blueprints are provided by ember-cli itself and any of you installed addons. Run ember generate --help to see a list of available blueprints in your project and their options.

Install an ember-cli addon

ember install some-other-addon

This will search npm for a package named some-other-addon, install it and run any additional install steps defined in the addon.

Community

Development

Start by cloning the Git project to your local hard drive:

git clone https://github.com/ember-cli/ember-cli.git

Link ember to your development version

Running the following command will link the global ember utility to your local development version:

npm link

Note that the global ember CLI utility will automatically relay to any project-local ember-cli installation. If you want to use your development version there instead run the following command from your Ember.js project folder:

npm link ember-cli

Read the official npm-link documentation for more information.

Run the test suite

npm test

will run ESLint and the "fast" subset of the test suite. Run npm run test-all for the full test suite which will currently take quite a few minutes due to heavy IO and network usage.

ember-cli is using Mocha for its internal tests. If you want to run a specific subset of tests have a look at their documentation.

Build the 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.

License

This project is licensed under the MIT License.