/parcel-plugin-watch-reload

Parcel plugin to watch files not included in the bundles and reload browser if they change

Primary LanguageJavaScriptMIT LicenseMIT

Node.js CI Build Status FOSSA Status

parcel-plugin-watch-reload

📦🔌🗂👀 A Parcel plugin that watches files not included in your bundles (e.g. **/*.php) and reloads your browser if they change (great for CMS theme development like e.g. WordPress). Also, has emojis in readme 👾

Installation

$ npm install parcel-plugin-watch-reload -D

...or

$ yarn add parcel-plugin-watch-reload -D

Setup

Specify which file types should trigger a browser reload in your package.json:

{
  "watchreload": {
    "files": "**/*.php"
  }
}

Arrays of globs are also supported:

{
  "watchreload": {
    "files": ["**/*.php", "**/*.svg"]
  }
}

Without the files setting in your package.json, the plugin will do nothing.

Optional settings

  • Set a reload delay:

    {
      "watchreload": {
        "files": "**/*.php",
        "reloadDelay": 200
      }
    }
  • Overwrite the plugin's settings for Chokidar. The defaults are:

    {
      "watchreload": {
        "files": "**/*.php",
        "chokidarOptions": {
          "ignored": ["node_modules", "bower_components", ".cache"],
          "ignoreInitial": true
        }
      }
    }

That's it! If you start parcel in watch mode with the hmr option set to true (it's the default), each change to a file matching your rules will trigger a browser reload. ✨

License

FOSSA Status