{"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,"search_vec":"'18':40 '3.0.0':34 '5':37 'altern':57 'blank':23 'built':65 'built-in':64 'compil':19 'current':30 'customiz':27 'dashboard':75 'default':22 'dev':55,61 'display':13 'includ':58 'javascript':76 'legaci':47 'like':72 'middlewar':6 'node':39 'overlay':68 'packag':42 'page':16,24 'plugin':7,71 'progress':15,67 'replac':20 'screen':29 'separ':70 'serv':3,11,50 'server':56,62 'specif':44 'stabl':31 'support':35 'v1/v2':51 'version':32 'wait':28 'waitpag':4 'webpack':2,10,18,36,49,54,60,74 'webpack-dashboard':73 'webpack-dev-serv':53,59 'webpack-serv':9,48 'webpack-serve-waitpag':1","created_at":"2026-04-25T11:25:10.538456+00:00","updated_at":"2026-04-25T11:25:10.538456+00:00","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,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"","cli_version":null,"type":"library","homepage":null,"github":"https://github.com/elisherer/webpack-serve-waitpage","docs":null,"changelog":null,"pypi":null,"npm":"https://www.npmjs.com/package/webpack-serve-waitpage","openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-17","next_check":"2026-07-24","install_tag":null}}