webpack-serve-overlay

A rudimentary overlay for webpack-serve, based off the one used in webpack-dev-server.

This package is targeted at serves as a quick fully functional way of being able to have the same overlay as webpack-dev-server in webpack-serve with minimal fuss & expense.

Usage

Install the package:

npm i webpack-serve-overlay

Then require the overlay at the top of your index.jsx (or equivalent):

// becomes dead code in builds other than dev,
// which webpack should pick up and remove.
if(process.env.NODE_ENV === 'development') {
    require('webpack-serve-overlay');
}

and you'll be away laughing.

Configuration

The overlay works by using a WebSocket that connects to webpack-serve à la webpack-hot-client.
This means that it shouldn't require any extra settings or configuration.

However, just in case, you can manually specify the WebSocket url by setting the WEBPACK_SERVE_OVERLAY_WS_URL env property.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

Unreleased

0.3.0 - 2018-08-01

Implemented usage of __hotClientOptions__ in the same manner as webpack-hot-client, making this package pretty much feature-complete, as it now works in nearly the same as the old overlay. v1 will likely be released soon after, with no expected changes.

Changed

• The errorOverlay now uses __hotClientOptions__ in the same manner as webpack-hot-client to get the WebSocket url to connect to webpack-serve.

0.2.2 - 2018-06-30

README.md adjustments & npm unpublish re-publish.

0.2.1 - 2018-06-30

This bug fix release doesn't actually change any code. Instead it changes the insertion method recommended by the README.md as it was discovered the overlay prevents hot-reload from refreshing the page if it's included as an entry.

See issue #5 for more information.

0.2.0 - 2018-06-30

Added

• Ability to provide WebSocket url via WEBPACK_SERVE_OVERLAY_WS_URL env property. (45db16e)

0.1.0 - 2018-06-30

Added

• Initial commit