Registry /
devops / babel-plugin-alias-config
Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslnode 18–226 runs
build_error
glibcnode 18–226 runs
build_error
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
babel-plugin-alias-config
✓ plugins: ['babel-plugin-alias-config']
✗ plugins: ['alias-config']
Plugin name must include 'babel-plugin-' prefix in Babel config array
Babel plugin options object
✓ plugins: [['babel-plugin-alias-config', { config: './webpack.config.js' }]]
✗ plugins: ['babel-plugin-alias-config', { config: './webpack.config.js' }]
Options must be in nested array format per Babel convention
default export (no named exports)
✓ const plugin = require('babel-plugin-alias-config');
✗ import { aliasConfig } from 'babel-plugin-alias-config';
Plugin exports a single function (default export); no named exports available
Shows installation, alias config, Babel setup, and usage of the plugin to resolve '@' and '@components' aliases.
// 1. Install
// npm install --save-dev babel-plugin-alias-config
// 2. Create alias config: alias.config.js
const path = require('path');
module.exports = {
alias: {
'@': path.resolve(__dirname, 'src'),
'@components': path.resolve(__dirname, 'src/components'),
},
extensions: ['.js', '.jsx', '.ts', '.tsx', '.json'],
};
// 3. Configure Babel: .babelrc
{
"plugins": [
["babel-plugin-alias-config", {
"config": "./alias.config.js"
}]
]
}
// 4. Use alias in code
import Button from '@components/Button'; // resolves to src/components/Button
console.log(Button);
Errors
Common errors & fixes
Error: Cannot find module '@babel/core'
@babel/core not installed as dependency or peer dependency
fixnpm install --save-dev @babel/core
SyntaxError: Unexpected token, expected ',' (12:5) in .babelrc
Babel config file syntax error due to incorrect plugin array nesting
fixEnsure options are inside a nested array: 'plugins': [['babel-plugin-alias-config', { ... }]] Can't resolve '@utils/helper' in file.js
Alias not defined in config or config not found by plugin
fixCheck alias.config.js or specify config path: 'config': './alias.config.js'
ENOENT: no such file or directory, open '.../webpack.config.js'
Default config file path is './webpack.config.js'; if it doesn't exist, plugin throws
fixCreate a valid alias config file or set 'config' option to correct path
Audit
Dependencies
@babel/corerequiredPeer dependency required for Babel 7 plugin API