rollup-plugin-livereload
Version:
Rollup plugin for LiveReload that watches the bundle and reloads the page on change
107 lines (79 loc) • 2.58 kB
Markdown
# Rollup plugin LiveReload
<a href="LICENSE">
<img src="https://img.shields.io/badge/license-MIT-brightgreen.svg" alt="Software License" />
</a>
<a href="https://github.com/thgh/rollup-plugin-livereload/issues">
<img src="https://img.shields.io/github/issues/thgh/rollup-plugin-livereload.svg" alt="Issues" />
</a>
<a href="http://standardjs.com/">
<img src="https://img.shields.io/badge/code%20style-standard-brightgreen.svg" alt="JavaScript Style Guide" />
</a>
<a href="https://npmjs.org/package/rollup-plugin-livereload">
<img src="https://img.shields.io/npm/v/rollup-plugin-livereload.svg?style=flat-squar" alt="NPM" />
</a>
<a href="https://github.com/thgh/rollup-plugin-livereload/releases">
<img src="https://img.shields.io/github/release/thgh/rollup-plugin-livereload.svg" alt="Latest Version" />
</a>
## Installation
```
npm install --save-dev rollup-plugin-livereload
```
## Usage
```js
// rollup.config.js
import livereload from 'rollup-plugin-livereload'
export default {
entry: 'entry.js',
dest: 'bundle.js',
plugins: [livereload()],
}
```
To make it a real dev-server, combine this plugin with [rollup-plugin-serve].
```js
// rollup.config.js
import serve from 'rollup-plugin-serve'
import livereload from 'rollup-plugin-livereload'
export default {
entry: 'entry.js',
dest: 'bundle.js',
plugins: [
serve(), // index.html should be in root of project
livereload(),
],
}
```
### Options
By default, it watches the current directory. If you also have css output, pass the folder to which the build files are written.
```
livereload('dist')
// --- OR ---
livereload({
watch: 'dist',
verbose: false, // Disable console output
// other livereload options
port: 12345,
delay: 300,
https: {
key: fs.readFileSync('keys/agent2-key.pem'),
cert: fs.readFileSync('keys/agent2-cert.pem')
}
})
```
Options are always passed to [`livereload.createServer()`][livereload]
## Changelog
Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.
## Contributing
Contributions and feedback are very welcome.
To get it running:
1. Clone the project.
2. `npm install`
3. `npm run build`
## Credits
- [Thomas Ghysels](https://github.com/thgh)
- [All Contributors][link-contributors]
## License
The MIT License (MIT). Please see [License File](LICENSE) for more information.
[link-author]: https://github.com/thgh
[link-contributors]: ../../contributors
[livereload]: https://www.npmjs.com/package/livereload
[rollup-plugin-serve]: https://www.npmjs.com/package/rollup-plugin-serve