Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/statianzo/webpack-livereload-plugin
LiveReload during webpack --watch
https://github.com/statianzo/webpack-livereload-plugin
hacktoberfest livereload webpack webpack-livereload-plugin
Last synced: 6 days ago
JSON representation
LiveReload during webpack --watch
- Host: GitHub
- URL: https://github.com/statianzo/webpack-livereload-plugin
- Owner: statianzo
- License: isc
- Created: 2015-08-25T23:30:53.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2023-04-16T17:47:00.000Z (over 1 year ago)
- Last Synced: 2024-12-29T14:13:32.236Z (13 days ago)
- Topics: hacktoberfest, livereload, webpack, webpack-livereload-plugin
- Language: JavaScript
- Homepage:
- Size: 632 KB
- Stars: 203
- Watchers: 11
- Forks: 51
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-github-star - webpack-livereload-plugin - -watch | statianzo | 202 | (JavaScript)
README
# webpack-livereload-plugin
[![CI][ci]][ci-url]
[![node][node]][node-url]
LiveReload when running `webpack --watch`
## Installation
Install the package
```sh
npm install --save-dev webpack-livereload-plugin
```
Add the plugin to your webpack config
```js
// webpack.config.js
var LiveReloadPlugin = require('webpack-livereload-plugin');
module.exports = {
plugins: [
new LiveReloadPlugin(options)
]
}
```
Add a script tag to your page pointed at the livereload server
```html
```
## Options
- `protocol` - (Default: protocol of the page, either `http` or `https`) Protocol for livereload `` src attribute value
- `port` - (Default: 35729) The desired port for the livereload server. If you define port 0, an available port will be searched for, starting from 35729.
- `hostname` - (Default: hostname of the page, like `localhost` or `10.0.2.2`) The desired hostname for the appended
`<script>` (if present) to point to
- `appendScriptTag` - (Default: false) Append livereload `<script>`
automatically to `<head>`.
- `ignore` - (Default: `null`) RegExp of files to ignore. Null value means
ignore nothing. It is also possible to define an array and use multiple [anymatch](https://github.com/micromatch/anymatch) patterns.
- `delay` - (Default: `0`) amount of milliseconds by which to delay the live reload (in case build takes longer)
- `useSourceHash` - (Default: `false`) create hash for each file source and only notify livereload if hash has changed
- `useSourceSize` - (Default: `false`) check size for each file source and only notify livereload if size has changed (Faster than `useSourceHash` but it has a downside. If file size hasn't changed no reload is triggered. For example if color has changed from `#000000` to `#ffffff` no reload will be triggered!)
## Why?
Yes, there's already `webpack-dev-server` that handles live reloading
and more complex scenarios. This project aims to solve the case where
you want assets served by your app server, but still want reloads
triggered from webpack's build pipeline.
## HTTPS
If you set `key`, `cert`, or `pfx` options, they'll get passed through to
[tiny-lr as options](https://github.com/mklabs/tiny-lr#options) and it will
serve over HTTPS. You'll also also set `protocol` to `https`.
## FAQ
##### Webpack always generates js and css together
If your webpack is always generating js and css files together you could set
`useSourceHash` to `true` to generate a hash for each changed asset and it
should prevent multiple reloads.
Alternatively if this slows your build process you could set `liveCSS`
and `liveImg` to `false` to prevent multiple reloads.
[node]: https://img.shields.io/node/v/webpack-livereload-plugin.svg
[node-url]: https://nodejs.org
[ci]: https://github.com/statianzo/webpack-livereload-plugin/actions/workflows/ci.yml/badge.svg?branch=master
[ci-url]: https://github.com/statianzo/webpack-livereload-plugin/actions/workflows/ci.yml