{"id":26646,"library":"webpack-dev-stats-viewer-middleware","title":"Webpack Dev Stats Viewer Middleware","description":"Express middleware that works with webpack-dev-middleware to expose raw webpack stats at a configurable URL. Version 1.0.0, likely stable with low release cadence. Key differentiator: provides deep visibility into webpack compilation stats (assets, modules, chunks) for debugging and monitoring, leveraging webpack-dev-middleware's serverSideRender flag. Unlike webpack-bundle-analyzer or other visualizers, this package gives raw stats JSON for programmatic inspection.","status":"active","version":"1.0.0","language":"javascript","source_language":"en","source_url":"https://github.com/configurator/webpack-dev-stats-viewer-middleware","tags":["javascript"],"install":[{"cmd":"npm install webpack-dev-stats-viewer-middleware","lang":"bash","label":"npm"},{"cmd":"yarn add webpack-dev-stats-viewer-middleware","lang":"bash","label":"yarn"},{"cmd":"pnpm add webpack-dev-stats-viewer-middleware","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency - this middleware must be used after webpack-dev-middleware with serverSideRender: true","package":"webpack-dev-middleware","optional":false}],"imports":[{"note":"Package only provides a CommonJS module (require). No ESM export.","wrong":"import statsViewer from 'webpack-dev-stats-viewer-middleware';","symbol":"statsViewer","correct":"const statsViewer = require('webpack-dev-stats-viewer-middleware');"},{"note":"Default export is a function; named import will not work.","wrong":"import { statsViewer } from 'webpack-dev-stats-viewer-middleware';","symbol":"default export (function)","correct":"import statsViewer from 'webpack-dev-stats-viewer-middleware';"},{"note":"Package does not ship TypeScript types; use @types/ or define own.","wrong":"","symbol":"TypeScript type (if available)","correct":"import statsViewer from 'webpack-dev-stats-viewer-middleware';"}],"quickstart":{"code":"const express = require('express');\nconst webpack = require('webpack');\nconst webpackMiddleware = require('webpack-dev-middleware');\nconst statsViewer = require('webpack-dev-stats-viewer-middleware');\n\nconst app = express();\nconst compiler = webpack({ mode: 'development', entry: './src/index.js' });\n\napp.use('/dev-server/', webpackMiddleware(compiler, {\n  serverSideRender: true\n}));\n\nstatsViewer(app, '/dev-server/stats');\n\napp.listen(3000, () => console.log('Server running on port 3000'));","lang":"javascript","description":"Set up an Express app with webpack-dev-middleware and add the stats viewer at /dev-server/stats."},"warnings":[{"fix":"Ensure statsViewer URL is a subpath of the webpack-dev-middleware mount path.","message":"URL must be under webpack-dev-middleware's path (e.g., /dev-server/stats) and within the same path prefix used for the middleware.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Add { serverSideRender: true } as second argument to webpack-dev-middleware.","message":"webpack-dev-middleware must be called with serverSideRender: true for the stats object to be attached to the request.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"No immediate fix; monitor for ESM support.","message":"Require-style import may become deprecated if package adopts ESM in future.","severity":"deprecated","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Add { serverSideRender: true } to webpack-dev-middleware options.","cause":"webpack-dev-middleware not configured with serverSideRender: true, so req.stats is missing.","error":"TypeError: Cannot read property 'stats' of undefined"},{"fix":"Use const statsViewer = require('webpack-dev-stats-viewer-middleware'); (CJS) or import statsViewer from 'webpack-dev-stats-viewer-middleware' (ESM, if supported).","cause":"Incorrect import; trying to use default import in CJS environment or named import on a default export.","error":"statsViewer is not a function"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}