@apostrophecms/asset-es5

TODO: Update the badge URLs for the new module's repo.

ES5 Support for ApostropheCMS 3.x

Installing and enabling this module turns on an ES5, Internet Explorer 11-compatible backwards compatibility build for the public-facing frontend JavaScript bundle in Apostrophe 3.x. Modern browsers will still get a modern build and will not pay a performance penalty, although there is a performance impact during development and deployment.

Limitations

• There is not and never will be support for the admin UI in IE11. This module only addresses the "public" JavaScript (imported by ui/src/index.js files).

• This module will polyfill JavaScript language features via babel, but doesn't attempt to polyfill missing browser features. You can of course load your own polyfills. Some browser features, like Observer, cannot be polyfilled for IE11.

• ui/public javaScript files are loaded exactly as-is, by design. If you need these to work in IE11, they must already be ES5.

• Using this module will add a lot of npm install time, as well as asset build time. IE11 is no longer supported by Microsoft and has most likely been uninstalled automatically from most systems.

Think it over: are you sure you need this module?

Installation

First update apostrophe to at least version 3.26.0. Prior to that release, there is no need for this module, since ES5 support was formerly included in the core.

Then you can add this module:

npm install @apostrophecms/asset-es5

Usage

Enable this module in the app.js file:

require('apostrophe')({
  shortName: 'my-project',
  modules: {
    '@apostrophecms/asset-es5': {}
  }
});