/babel-plugin-module-alias

Rewrite/Resolve require/import paths to different values in Babel.

Primary LanguageJavaScriptMIT LicenseMIT

babel-plugin-module-alias Build Status

A babel plugin to rewrite (map, alias, resolve) directories as different directories during the Babel process. It's particularly useful when you have files you don't want to use with relative paths (especially in big projects).

Description

Instead of using relative paths in your project, you'll be able to use an alias. Here an simple example:

// Instead of using this;
import MyUtilFn from '../../../../utils/MyUtilFn';
// Use that:
import MyUtilFn from 'utils/MyUtilFn';

With this plugin, you'll be able to map files or directories to the path you want.

Note: It also work for require().

Note 2: You can use the npm: prefix in your plugin confiration to map a node module.

Usage

Install the plugin

$ npm install --save babel babel-plugin-module-alias

Specify the plugin in your .babelrc with the custom mapping.

{
  "plugins": [
    ["module-alias", [
      { "src": "./src/utils", "expose": "utils" },
      { "src": "./src/components", "expose": "awesome/components" },
      { "src": "npm:lodash", "expose": "underscore" }
    ]]
  ]
}

License

MIT, see LICENSE.md for details.