Skip to content
Ember.js - A JavaScript framework for creating ambitious web applications
JavaScript Other
Find file
Latest commit 3ffa902 May 4, 2016 @rwjblue rwjblue Merge pull request #13442 from rwjblue/remove-safestring-deprecation
[BUGFIX beta] Remove SafeString deprecation.
Failed to load latest commit information.
bin Update build scripts for LTS [ci skip] Apr 11, 2016
blueprints Create helper integration tests Apr 19, 2016
config publish dist bower.json & co to s3 Feb 12, 2016
generators [DOC] Update copyright year Feb 18, 2016
lib Merge pull request #13417 from kiwiupover/global-logger-cleanup Apr 28, 2016
node-tests tests/blueprints: Use new testing API Apr 7, 2016
packages Merge pull request #13442 from rwjblue/remove-safestring-deprecation May 4, 2016
scripts Improved File Size script Apr 21, 2012
server Allow `hidepassed` to be toggled. Apr 6, 2015
tests Move ENV, environment, context stuff to 'ember-environment' WIP Apr 15, 2016
.bowerrc Broccolify. May 13, 2014
.editorconfig Add EditorConfig file Jul 21, 2014
.gitattributes Adds .gitattributes file to remove any concerns about collaborators h… Apr 1, 2016
.gitignore Remove '*.swp' from .gitignore May 13, 2015
.gitmodules Update gitsubmodules urls to public repos. Jan 7, 2013
.jscsrc Enforce const usage in module scope only. Nov 4, 2015
.jshintrc Fix toString to not add the property on the class Apr 14, 2016
.npmignore Add "ember-cli-blueprint-test-helpers" dev dependency Mar 6, 2016
.travis.yml Merge pull request #13029 from Turbo87/blueprints Mar 14, 2016
.watchmanconfig many build tool upgrades: Jun 7, 2015
CHANGELOG.md Add 2.6.0-beta.3 to CHANGELOG.md. May 2, 2016
CODE_OF_CONDUCT.md Add link to community guidelines as CODE_OF_CONDUCT.md. Jun 20, 2015
CONTRIBUTING.md Added commands to simplify the build processes Mar 13, 2016
FEATURES.md Remove extra whitespace from FEATURES.md Apr 19, 2016
LICENSE [DOC] Update copyright year Jan 16, 2016
README.md Merge branch 'master' of https://github.com/emberjs/ember.js Mar 22, 2016
Rakefile Cleanup Rakefile Dec 10, 2014
STYLEGUIDE.md Don't cache length property in for loops Apr 20, 2016
VERSION Branch 2.7.0-canary Apr 11, 2016
bower.json [BUGFIX beta] run.later(cb, NaN) should not break all the things Apr 26, 2016
ember-cli-build.js [CLEANUP beta] Remove unused imports and other minor cleanup Apr 10, 2016
ember-source.gemspec [BUGFIX beta] Remove handlebars from dependencies Dec 29, 2014
features.json [FEATURE ember-route-serializers] Introduce serialize method to Route… Apr 16, 2016
index.js package.json: Add "ember-addon" keyword Feb 23, 2016
package.json Cleanup Ember.VERSION and DEFAULT_FEATURES May 4, 2016
testem.dist.json Update sauce labs browser listing. May 2, 2016
testem.json create multiple tested files for each variation: Jul 7, 2015
yuidoc.json [DOC release] Initial pass at filtering out api docs behind FFs Apr 3, 2016

README.md

Ember.js Build Status Code Climate Slack

Sauce Test Status

Ember.js is a JavaScript framework that does all of the heavy lifting that you'd normally have to do by hand. There are tasks that are common to every web app; Ember.js does those things for you, so you can focus on building killer features and UI.

Building Ember.js

  1. Ensure that Node.js and bower are installed.
  2. Run git clone https://github.com/emberjs/ember.js.git && cd ember.js.
  3. Run git config core.symlinks true to ensure that symlinks are enabled.
  4. Run git reset --hard HEAD to reset to HEAD with symlinks.
  5. Run npm install to ensure the required dependencies are installed.
  6. Run bower install to ensure required web dependencies are installed.
  7. Run npm run build to build Ember.js. The builds will be placed in the dist/ directory.

npm install troubleshooting

If you encounter a problem with downloading dependencies like:

npm ERR! registry error parsing json

consider upgrading npm with:

npm install -g npm@latest

You can find more information in Upgrading on *nix (OSX, Linux, etc.) npm wiki page.

Contribution

See CONTRIBUTING.md

How to Run Unit Tests

Pull requests should pass the Ember.js unit tests. Do the following to run these tests.

  1. Follow the setup steps listed above under Building Ember.js.

  2. To start the development server, run npm start.

  3. To run all tests, visit http://localhost:4200/.

  4. To test a specific package, visit http://localhost:4200/tests/index.html?package=PACKAGE_NAME. Replace PACKAGE_NAME with the name of the package you want to test. For example:

To test multiple packages, you can separate them with commas.

You can also pass jquery=VERSION in the test URL to test different versions of jQuery.

From the CLI

  1. Install phantomjs from http://phantomjs.org.

  2. Run npm test to run a basic test suite or run TEST_SUITE=all npm test to run a more comprehensive suite.

From ember-cli

  1. ember test --server
  2. connect the browsers you want
  3. if phantom didn't connect automatically, you can run ./bin/connect-phantom-to <optional-port>

To run a specific browser, you can use the --launch flag

  • ember test --server --launch SL_Firefox_Current
  • ember test --launch SL_Firefox_Current
Something went wrong with that request. Please try again.