eslint-plugin-absolute-imports

0.0.3 verified Sat Apr 25 auth: no javascript

ESLint plugin (v0.0.3) that enforces absolute imports in JavaScript/TypeScript projects. Zero-dependency, requires a baseUrl defined in tsconfig.json or jsconfig.json (paths not supported). Targets developers migrating from relative imports to absolute imports for cleaner codebases. Infrequent updates; currently stable but limited in scope.

Common errors

error Error: baseUrl is not configured in tsconfig.json or jsconfig.json ↓

cause Missing baseUrl configuration required by the rule.

fix

Add 'baseUrl': './src' (or appropriate root) to tsconfig compilerOptions.

error Cannot find module 'eslint-plugin-absolute-imports' ↓

cause Plugin not installed or not added to plugins array.

fix

Run npm install eslint-plugin-absolute-imports --save-dev and add 'absolute-imports' to plugins.

error Definition for rule 'absolute-imports/only-absolute-imports' was not found ↓

cause Plugin not loaded or rule name misspelled.

fix

Ensure plugin is added to plugins array and rule name is correct: 'absolute-imports/only-absolute-imports'.

Warnings

gotcha Does not support TypeScript paths; only baseUrl. ↓

fix Define a single baseUrl in tsconfig or jsconfig; avoid using paths with this plugin.

gotcha Rule name is 'only-absolute-imports', not 'absolute-imports'. ↓

fix Use 'absolute-imports/only-absolute-imports' in your rules.

gotcha Plugin may not work with ESLint flat config (new format). ↓

fix Use legacy .eslintrc format or check plugin's compatibility with flat config.

Install

npm install eslint-plugin-absolute-imports

yarn add eslint-plugin-absolute-imports

pnpm add eslint-plugin-absolute-imports

Imports

plugin

wrong

const plugin = require('eslint-plugin-absolute-imports')

correct

import plugin from 'eslint-plugin-absolute-imports'

Version 0.0.3 is likely ESM-first; confirm compatibility.

rules
```
import { rules } from 'eslint-plugin-absolute-imports'
```
ESM named export; CommonJS may require default import then destructure.

configs

import { configs } from 'eslint-plugin-absolute-imports'

May not be exported; check package.

Quickstart

Enables the only-absolute-imports rule with ESLint config and a required baseUrl in tsconfig.

// .eslintrc.js
module.exports = {
  plugins: ['absolute-imports'],
  rules: {
    'absolute-imports/only-absolute-imports': 'error'
  }
};

// tsconfig.json
{
  "compilerOptions": {
    "baseUrl": "./src"
  }
}

// src/utils/helper.ts
// ❌ import helper from '../helpers/helper';
// ✅ import helper from 'utils/helpers/helper';