{"id":18478,"library":"koa-webpack-middleware","title":"koa-webpack-middleware","description":"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.","status":"deprecated","version":"1.0.7","language":"javascript","source_language":"en","source_url":"https://github.com/leecade/koa-webpack-middleware","tags":["javascript","react","hot","middleware","webpack","koa","koa2","hmr"],"install":[{"cmd":"npm install koa-webpack-middleware","lang":"bash","label":"npm"},{"cmd":"yarn add koa-webpack-middleware","lang":"bash","label":"yarn"},{"cmd":"pnpm add koa-webpack-middleware","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency: required runtime for middleware","package":"koa","optional":false}],"imports":[{"note":"Default export is not available; named import only.","wrong":"const devMiddleware = require('koa-webpack-middleware').devMiddleware","symbol":"devMiddleware","correct":"import { devMiddleware } from 'koa-webpack-middleware'"},{"note":"Must use named import for hotMiddleware.","wrong":"import hotMiddleware from 'koa-webpack-middleware'","symbol":"hotMiddleware","correct":"import { hotMiddleware } from 'koa-webpack-middleware'"},{"note":"Package has no default export; only named exports.","wrong":"import KoaWebpackMiddleware from 'koa-webpack-middleware'","symbol":"koa-webpack-middleware (entire module)","correct":"import { devMiddleware, hotMiddleware } from 'koa-webpack-middleware'"}],"quickstart":{"code":"import Koa from 'koa';\nimport webpack from 'webpack';\nimport { devMiddleware, hotMiddleware } from 'koa-webpack-middleware';\n\nconst app = new Koa();\nconst compiler = webpack(require('./webpack.config'));\n\napp.use(devMiddleware(compiler, {\n  noInfo: false,\n  quiet: false,\n  lazy: false,\n  watchOptions: {\n    aggregateTimeout: 300,\n    poll: true\n  },\n  publicPath: '/assets/',\n  stats: { colors: true }\n}));\n\napp.use(hotMiddleware(compiler, {\n  log: console.log,\n  path: '/__webpack_hmr',\n  heartbeat: 10 * 1000\n}));\n\napp.listen(3000);","lang":"javascript","description":"Sets up Koa2 with webpack dev and hot middleware for HMR during development."},"warnings":[{"fix":"Migrate to koa-webpack: npm install koa-webpack","message":"This package is unmaintained since 2016. It does not support webpack 5 or later. Use koa-webpack instead.","severity":"deprecated","affected_versions":">=0.0.0"},{"fix":"Use Koa version ^2.0.0","message":"Requires Koa 2.x; not compatible with Koa 1.x.","severity":"breaking","affected_versions":">=0.0.0"},{"fix":"Use named imports as shown in documentation","message":"No default export - must use named imports { devMiddleware, hotMiddleware }","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Add these plugins to webpack config. For webpack 4+, use NoEmitOnErrorsPlugin instead of NoErrorsPlugin.","message":"Requires webpack plugins: HotModuleReplacementPlugin, NoErrorsPlugin (deprecated), OccurrenceOrderPlugin (deprecated) for HMR to work.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Include 'webpack-hot-middleware/client?path=/__webpack_hmr&timeout=20000' in your entry array.","message":"HMR client entry must be manually added with specific options (path, timeout). Not auto-injected.","severity":"gotcha","affected_versions":">=0.0.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"npm install webpack-dev-middleware --save-dev","cause":"Missing peer dependency webpack-dev-middleware","error":"Error: Cannot find module 'webpack-dev-middleware'"},{"fix":"npm install webpack-hot-middleware --save-dev","cause":"Missing peer dependency webpack-hot-middleware","error":"Error: Cannot find module 'webpack-hot-middleware'"},{"fix":"Use import { devMiddleware } from 'koa-webpack-middleware'","cause":"Incorrect import (using default import instead of named)","error":"TypeError: devMiddleware is not a function"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}