Registry / web-framework / koa-webpack-middleware

koa-webpack-middleware

library1.0.7jsnpmunverified

Webpack dev and hot module replacement middleware for Koa2 (Koa v2.x). Version 1.0.7 is the latest stable release (last updated 2016). This package wraps webpack-dev-middleware and webpack-hot-middleware for Koa2, enabling development-time HMR with webpack. It is designed specifically for Koa2 (v2.x) and does not support Koa v1. Compared to alternatives like koa-webpack, this package is simpler but outdated and unmaintained. It requires a specific older webpack configuration (e.g., NoErrorsPlugin, OccurrenceOrderPlugin) and does not work with modern webpack 5. Users should consider migrating to koa-webpack or using webpack-dev-middleware directly.

web-framework devops

npm install koa-webpack-middleware

github ↗package ↗

INSTALL

IMPORT

SIG · KOA-WEBPACK-MIDDLE

koa-webpack-middleware

web-frameworkjavascriptv1.0.7

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.

devMiddleware

✓ import { devMiddleware } from 'koa-webpack-middleware'

✗ const devMiddleware = require('koa-webpack-middleware').devMiddleware

Default export is not available; named import only.

hotMiddleware

✓ import { hotMiddleware } from 'koa-webpack-middleware'

✗ import hotMiddleware from 'koa-webpack-middleware'

Must use named import for hotMiddleware.

koa-webpack-middleware (entire module)

✓ import { devMiddleware, hotMiddleware } from 'koa-webpack-middleware'

✗ import KoaWebpackMiddleware from 'koa-webpack-middleware'

Package has no default export; only named exports.

Sets up Koa2 with webpack dev and hot middleware for HMR during development.

import Koa from 'koa'; import webpack from 'webpack'; import { devMiddleware, hotMiddleware } from 'koa-webpack-middleware'; const app = new Koa(); const compiler = webpack(require('./webpack.config')); app.use(devMiddleware(compiler, { noInfo: false, quiet: false, lazy: false, watchOptions: { aggregateTimeout: 300, poll: true }, publicPath: '/assets/', stats: { colors: true } })); app.use(hotMiddleware(compiler, { log: console.log, path: '/__webpack_hmr', heartbeat: 10 * 1000 })); app.listen(3000);

Debug

Known issues

deprecatedThis package is unmaintained since 2016. It does not support webpack 5 or later. Use koa-webpack instead.

fix

Migrate to koa-webpack: npm install koa-webpack

affects: >=0.0.0

breakingRequires Koa 2.x; not compatible with Koa 1.x.

fix

Use Koa version ^2.0.0

affects: >=0.0.0

gotchaNo default export - must use named imports { devMiddleware, hotMiddleware }

fix

Use named imports as shown in documentation

affects: >=0.0.0

gotchaRequires webpack plugins: HotModuleReplacementPlugin, NoErrorsPlugin (deprecated), OccurrenceOrderPlugin (deprecated) for HMR to work.

fix

Add these plugins to webpack config. For webpack 4+, use NoEmitOnErrorsPlugin instead of NoErrorsPlugin.

affects: >=0.0.0

gotchaHMR client entry must be manually added with specific options (path, timeout). Not auto-injected.

fix

Include 'webpack-hot-middleware/client?path=/__webpack_hmr&timeout=20000' in your entry array.

affects: >=0.0.0

Errors

Common errors & fixes

Error: Cannot find module 'webpack-dev-middleware'

Missing peer dependency webpack-dev-middleware

fix

npm install webpack-dev-middleware --save-dev

Error: Cannot find module 'webpack-hot-middleware'

Missing peer dependency webpack-hot-middleware

fix

npm install webpack-hot-middleware --save-dev

TypeError: devMiddleware is not a function

Incorrect import (using default import instead of named)

fix

Use import { devMiddleware } from 'koa-webpack-middleware'

Upgrade

Version history

1.0.7latest on npm

Audit

Dependencies

koarequiredPeer dependency: required runtime for middleware

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/leecade/koa-webpack-middleware ↗

packagehttps://www.npmjs.com/package/koa-webpack-middleware ↗