This package has been deprecated

Author message:

Old stuff


0.1.0 • Public • Published

Ember CLI Shims

Greenkeeper badge

NOTE: this repo is frozen until ember's public module interface has been finalized.


Ember CLI Shims (ECS) contain all the shims used in Ember CLI.

Note: The ember-data shim has been removed as of v0.1.0. The latest Ember-Data no longer has a bower dependency; ember-cli-shims >= v0.1.0 is only intended for use with Ember-Data v2.3.0 and up.


Simply import any of the shims as an ES6 module:

import Component from 'ember-component';
import run from 'ember-runloop';
import injectService from 'ember-service/inject';

Some of the shims have named exports (instead of/in addition to a default export):

import { assert, copy } from 'ember-metal/utils';
import { debounce } from 'ember-runloop';
import { isEmpty } from 'ember-utils';


The app-shims file provides a complete reference of all modules currently supported by this library.


Historically, Ember has recommended that developers reference core classes & utilities (ie Component, Route, isEmpty) via the root Ember namespace. This leads to the entire Ember module being imported into nearly every file:

import Ember from 'ember';
export default Ember.Component.extend({
  foo: Ember.inject.service(),
  bar: Ember.computed.readOnly('')

It would be preferable to have different parts of Ember available as separate modules, allowing developers to only import what they need. This is the direction the framework is moving in, but the modules are not yet available. This has led to a common pattern of ES6 destructuring assignment to enable writing future-proof code:

import Ember from 'ember';
const { Component, computed, inject } = Ember;
export default Component.extend({
  foo: inject.service(),
  bar: computed.readOnly('');

However, this library provides shims to mimic the future modules that Ember may provide, enabling developers to avoid destructuring and instead import the namespaces as modules today.

import Component from 'ember-component';
import computed from 'ember-computed';
import injectService from 'ember-service/inject';
export default Component.extend({
  foo: injectService(),
  bar: computed.readOnly('');

That way, as true modules become available in the Ember ecosystem, we can merely remove the shims from ECS upstream, requiring little to no refactoring on the part of developers who have opted-in to this pattern early. Ultimately, the goal of this library is to be replaced completely once Ember itself is an npm package/addon and exports its own modules.


Ember CLI Shims is MIT Licensed.



Package Sidebar


npm i ember-cli-shims-modules-rfc

Weekly Downloads






Last publish


  • tchak