A fast, production ready, zero-dependency ES module loader for Node 6+!

See the release post 📖 and video 🎥 for all the details.

Run npx create-esm or yarn create esm.

💡 Use the -y flag to answer “yes” to all prompts.

There are two ways to enable esm.

1. Enable esm for packages:

   index.js

   // Set options as a parameter, environment variable, or rc file.
   require = require("esm")(module/*, options*/)
   module.exports = require("./main.js").default

   💡 This is automagically done by create-esm.

2. Enable esm for local runs:

   node -r esm main.js

   💡 Omit the filename to enable esm in the REPL.

The esm loader bridges the ESM of today to the ESM of tomorrow.

👏 By default, 💯 percent CJS interoperability is enabled so you can get stuff done fast.
🔒 .mjs files are limited to basic functionality without support for esm options.

Out of the box esm just works, no configuration necessary, and supports:

• import / export
• import.meta
• Dynamic import
• Improved errors
• Live bindings
• Loading .mjs files as ESM
• The file URI scheme
• Node --eval and --print flags

Specify options with one of the following:

• The "esm" field in your package.json
• JSON6 in an .esmrc or .esmrc.json file
• JSON6 or file path in the ESM_OPTIONS environment variable
• CJS/ESM in an .esmrc.js or .esmrc.mjs file

• Load esm before @babel/register
• Load esm with the “require” option of ava, mocha, nyc, qunit, tape, and webpack
• Load esm with the --node-arg=-r --node-arg=esm option of node-tap
• Load esm with the --node-args="-r esm" option of pm2
• Load esm with wallaby.js
• Use esm to load jasmine