{"id":20825,"library":"webpack-serve-waitpage","title":"webpack-serve-waitpage","description":"A middleware plugin for webpack-serve that displays a progress page during webpack compilation, replacing the default blank page with a customizable wait screen. Current stable version is 3.0.0 (supports webpack 5 and Node 18). This package is specific to the legacy webpack-serve (v1/v2), not webpack-dev-server. Alternatives include webpack-dev-server's built-in progress overlay or separate plugins like webpack-dashboard.","status":"active","version":"1.0.2","language":"javascript","source_language":"en","source_url":"https://github.com/elisherer/webpack-serve-waitpage","tags":["javascript"],"install":[{"cmd":"npm install webpack-serve-waitpage","lang":"bash","label":"npm"},{"cmd":"yarn add webpack-serve-waitpage","lang":"bash","label":"yarn"},{"cmd":"pnpm add webpack-serve-waitpage","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency – works with webpack 4 or 5","package":"webpack","optional":false},{"reason":"Peer dependency – requires webpack-serve v1 or v2","package":"webpack-serve","optional":false}],"imports":[{"note":"This package is CommonJS only and does not ship ESM. Use require().","wrong":"import webpackServeWaitpage from 'webpack-serve-waitpage';","symbol":"default","correct":"const webpackServeWaitpage = require('webpack-serve-waitpage');"},{"note":"TypeScript definitions are included but not exported; use JSDoc comments or rely on inference.","wrong":"import { WaitpageOptions } from 'webpack-serve-waitpage';","symbol":"types","correct":"// Types are already included in the package; no separate import needed"},{"note":"In versions <0.3.0, .middleware() was required. Since 0.3.0, the default export is the factory directly.","wrong":"app.use(webpackServeWaitpage.middleware(options));","symbol":"middleware invocation","correct":"app.use(webpackServeWaitpage(options));"}],"quickstart":{"code":"const webpackServeWaitpage = require('webpack-serve-waitpage');\n\nmodule.exports = {\n  // ... other webpack config\n  serve: {\n    add: (app, middleware, options) => {\n      app.use(webpackServeWaitpage(options, {\n        theme: 'material',\n        disableWhenValid: true\n      }));\n    }\n  }\n};","lang":"javascript","description":"Shows how to integrate webpack-serve-waitpage as middleware in a webpack-serve config, with custom theme and disableWhenValid option."},"warnings":[{"fix":"Update usage: remove .middleware() call. See quickstart.","message":"Changed from plugin to middleware. In v0.2.0, you had to use webpackServeWaitpage.middleware(). In v0.3.0, you must use the default export directly: app.use(webpackServeWaitpage(options)).","severity":"breaking","affected_versions":">=0.3.0"},{"fix":"If you rely on the wait page always showing, set disableWhenValid: false explicitly.","message":"Option 'disableWhenValid' default changed to true in v1.0.0.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Use webpack-dev-server-waitpage for webpack-dev-server.","message":"Package works only with webpack-serve, not webpack-dev-server. Despite similar names, webpack-serve is a separate tool.","severity":"gotcha","affected_versions":"*"},{"fix":"Upgrade Node.js to v12 or later.","message":"Node.js 10 and below are not supported in v3.0.0.","severity":"deprecated","affected_versions":">=3.0.0"},{"fix":"Check webpack-serve compatibility; see migration guides.","message":"In v2.0.0, support for webpack 5 was added, but configuration path may differ. Ensure webpack-serve is compatible with webpack 5.","severity":"gotcha","affected_versions":">=2.0.0 <3.0.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Run npm install -D webpack-serve-waitpage","cause":"Package not installed or misspelled.","error":"Error: Cannot find module 'webpack-serve-waitpage'"},{"fix":"Use const webpackServeWaitpage = require('webpack-serve-waitpage'); and call it directly.","cause":"Importing incorrectly – e.g., using default import in ESM or accessing .middleware.","error":"TypeError: webpackServeWaitpage is not a function"},{"fix":"Upgrade to v2.1.0 or v3.0.0.","cause":"Bug in v2.1.1 when disableWhenValid is false.","error":"Cannot read property 'includes' of undefined","affected_versions":"2.1.1"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}