@embroider/addon-shim

Makes a v2 addon work like a v1 addon so it can be used in a classic (non-Embroider) app.

This allows addons to update to v2 without waiting for all their users to upgrade to Embroider.

Compatibility

• Ember.js v3.13 or above
• Ember CLI v2.13 or above
• Node.js v10 or above

Installation

ember install @embroider/addon-shim

Usage

To use it:

1. Be prepared to do a semver major release of your addon, because the shim demands that the app has ember-auto-import >= 2.

2. Create an addon-main.js file that requires and invokes the shim:

   1const { addonV1Shim } = require('@embroider/addon-shim');
   2module.exports = addonV1Shim(__dirname);

3. Update your package.json to point at addon-main.js:

   1{
   2  "ember-addon": {
   3    "version": 2,
   4    "type": "addon",
   5    "main": "addon-main.js"
   6  }
   7}

Shim Options

disabled: this optional argument lets you control whether your shimmed addon will emit 'app-js' and 'public-assets' into non-embroider builds. Example:

1module.exports = addonV1Shim(__dirname, {
2  disabled(options) {
3    let welcomeConfig = options['ember-welcome-page'] || {};
4    return process.env.EMBER_ENV === 'production' && !welcomeConfig.enabled;
5  },
6});

This option only works in non-embroider builds. Under embroider, apps just won't import the parts of your addon they don't want.

Contributing

See the top-level CONTRIBUTING.md in this monorepo.

License

This project is licensed under the MIT License.