This plugin replaces relative parent imports with a defined alias and is meant to be used in conjunction with applications built with either webpack alias definitions or paths for typescript.

Upstream repository seems not supported anymore, therefore this fork exist. This repo and package will be removed when upstream repository catch up with all bug fixes / improvements.

Add replace-relative-imports-fork to the plugins section of your eslint configuration.

{
  "plugins": ["replace-relative-imports-fork"]
}

Then add the replace imports rule:

{
  "rules": {
    "replace-relative-imports-fork/replace": ["error", {
      "aliases": [
        { "name": "app", "path": "./src" }
      ]
    }]
  }
}

The aliases object is required in the configuration. You may define multiple aliases. If an alias is not found for a specific import, an error will be thrown for that import.

You may also specify blobs in the ignore array in order to ignore specific files.

You may also specify list of imports in the excludeImports array in order to ignore specific import paths.

Options:

Example:

{
  "rules": {
    "replace-relative-imports-fork/replace": ["error", {
      "ignore": ["**/__tests__/*"],
      "excludeImports": [
        "@/utils/any",
        "./any",
        "../utils/any"
      ],
      "aliases": [
        { "name": "app", "path": "./src" }
      ]
    }]
  }
}

MIT