Babel Root Import

Babel plugin to add the opportunity to use import with root based paths.

Example

// Usually
import SomeExample from '../../../some/example.js';

// With Babel-Root-Importer
import SomeExample from '~/some/example.js';

Install

npm install babel-root-import --save-dev

Use

Add a .babelrc file and write:

{
  "plugins": [
    ["babel-root-import"]
  ]
}

or pass the plugin with the plugins-flag on CLI

babel-node myfile.js --plugins babel-root-import

Extras

Custom root-path-suffix

If you want a custom root because for example all your files are in the src/js folder you can define this in your .babelrc file

{
  "plugins": [
    ["babel-root-import", {
      "rootPathSuffix": "src/js"
    }]
  ]
}

Custom root-path-prefix

If you don't like the ~ syntax you can just use your own symbole (for example a @ symbole or \)

{
  "plugins": [
    ["babel-root-import", {
      "rootPathPrefix": "@"
    }]
  ]
}

// Now you can use the plugin like:
import foo from '@/my-file';

Don't let ESLint be confused

Add this to your .eslintrc so that ESLint won't treat the import as error

{
  "rules": {
      "import/no-unresolved": [2, { ignore: ['\~*'] }]
  },
}

Motivate

If you like this project just give it a star :) I like stars.

Change Log

3.2.2 - 2016-02-20

Fix custom suffix in path, missing / in generated paths

3.2.0 - 2016-02-19

Support Windows-Filesystem
Add possibility to configure a custom rootPath-Symbole (instead of ~ you can use whatever you like)

3.1.0 - 2015-12-01

Add possibility config the custom root path

3.0.1 - 2015-11-30

Updated plugin to new babel6 API
Splitted tests and functions into two scopes with single tests
Removed the "extra-root" param for the .babelrc since this is no yet supported in babel6

2.0.1 - 2015-11-15

Breaking Change to Babel 5

Updated to Babel 6
Added integration tests

1.0.1 - 2015-08-07

Added / updated tests
Implemented ESlint

gingur/babel-root-import