Registry / devops / webpack-build-linked-packages

webpack-build-linked-packages

JSON →
library0.4.0jsnpmunverified

This webpack plugin automates the build process for symlinked packages within `node_modules`, typically created using `npm link` or `yarn link`. Designed to streamline local development workflows, it ensures that any changes made to a linked package with a build step (e.g., TypeScript compilation, Babel transpilation) are automatically reflected in the consuming project's webpack compilation without manual intervention. The current stable version is `0.4.0`. Its primary differentiator is solving the common problem of forgetting to rebuild local packages during active development, providing a hands-off solution by integrating directly into the webpack build cycle. This package targets a specific niche within front-end and full-stack development that heavily relies on local package linking for monorepos or component library development.

devops
npm install webpack-build-linked-packages
github ↗package ↗
INSTALL
IMPORT
SIG · WEBPACK-BUILD-LINK
W
webpack-build-linked-packages
devopsjavascriptv0.4.0
Install
—
Import
—
Disk
—
Pass rate
0/ 6
Env Coverage0 / 6
glibc
18–22
musl
18–22
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
musl
node 18–226 runs
build_error
glibc
node 18–226 runs
build_error
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

WebpackBuildLinkedPackages
✓ const WebpackBuildLinkedPackages = require('webpack-build-linked-packages');
✗ import WebpackBuildLinkedPackages from 'webpack-build-linked-packages';
This package is primarily designed for CommonJS environments as indicated by its documentation and usage examples. While Node.js supports ESM, webpack configurations often remain CJS. Directly `import`ing might fail if the consumer's webpack config isn't transpiled for ESM.
Plugin Instance
✓ new WebpackBuildLinkedPackages({ scriptName: 'build' })
The plugin is instantiated with an options object. The `scriptName` option (defaulting to 'build') specifies which npm script to run in linked packages.

This quickstart demonstrates how to integrate the plugin into a basic webpack configuration, ensuring that `npm link`-ed packages have their `prepare` script executed during the webpack build process.

const WebpackBuildLinkedPackages = require('webpack-build-linked-packages'); const path = require('path'); module.exports = { mode: 'development', entry: './src/index.js', output: { path: path.resolve(__dirname, 'dist'), filename: 'bundle.js' }, plugins: [ new WebpackBuildLinkedPackages({ // Optionally specify a different script name than 'build' scriptName: 'prepare' // Example: run 'npm run prepare' in linked packages }) ], // Typical webpack config setup module: { rules: [ { test: /\.js$/, exclude: /node_modules/, use: { loader: 'babel-loader', options: { presets: ['@babel/preset-env'] } } } ] } };
Debug
Known issues
gotchaThe plugin runs an `npm run-script` command. If the specified `scriptName` does not exist in a linked package's `package.json`, it will result in an error during the webpack compilation. This can halt your build process.
fix
Ensure all linked packages have the specified `scriptName` (defaulting to 'build') defined in their `scripts` section of `package.json`. If a package doesn't need a build script, you might need to conditionally apply the plugin or ensure a no-op script exists.
affects: >=0.2.0
gotchaThe plugin invokes `npm run-script` for each linked package. If a linked package's build script is slow or resource-intensive, it can significantly increase your webpack compilation times, especially during watch mode or frequent rebuilds.
fix
Optimize the build scripts within your linked packages for speed. Consider caching strategies or only running essential steps. If performance becomes a critical issue, manually triggering builds for linked packages might be necessary instead of relying on this plugin for every change.
affects: >=0.2.0
gotchaThis plugin only addresses symlinked packages in `node_modules` (e.g., from `npm link` or `yarn link`). It will not run scripts for packages installed via other methods like `file:` protocol in `package.json` or private npm registries without symlinking.
fix
Verify that your local package dependencies are indeed symlinked in `node_modules`. Use `ls -l node_modules/your-linked-package` to check for symbolic links. If you are using other local dependency management strategies, this plugin may not be suitable.
affects: >=0.2.0
Errors
Common errors & fixes
Error: Script 'build' not found in package 'your-linked-package'
The linked package 'your-linked-package' does not have a 'build' script defined in its `package.json` file, but the plugin tried to execute it.
fix
Add a 'build' script to the `scripts` section of `your-linked-package/package.json`, or configure the `webpack-build-linked-packages` plugin with a different `scriptName` that *does* exist in all relevant linked packages (e.g., `new WebpackBuildLinkedPackages({ scriptName: 'prepare' })`).
Webpack compilation fails without a clear error from the plugin, but linked package changes aren't reflected.
The plugin might not be correctly configured, or the linked package itself isn't properly symlinked or its build script is not working as expected when run independently.
fix
1. Double-check that `new WebpackBuildLinkedPackages()` is included in your `plugins` array in `webpack.config.js`. 2. Verify `npm link` or `yarn link` created actual symlinks in `node_modules`. 3. Manually run `npm run <scriptName>` (e.g., `npm run build`) in your linked package's directory to ensure its build script works standalone.
Upgrade
Version history
0.4.0latest on npm
Audit
Dependencies
webpackrequiredPeer dependency, as this is a webpack plugin.
Agent activity
6 hits · last 30 days
node
6
Resources
githubhttps://github.com/mxmul/webpack-build-linked-packages ↗
packagehttps://www.npmjs.com/package/webpack-build-linked-packages ↗
webpack-build-linked-packages — npm install webpack-build-linked-packages · libregistry