@mariotacke/parcel-plugin-static-files-copy

parcel-plugin-static-files-copy

ParcelJS plugin to copy static files from some dir to directory with bundle.

Install

yarn add parcel-plugin-static-files-copy --dev

Usage

1. Create static dir in you project root.
2. Fill it with your static files
3. Run build - and that's all!

Customization

Beyond the default settings, you can:

1. Name of the folder to be copied.
2. Copy multiple folders.
3. Watch for changes during development (rebuilding when necessary).

Example

The following configures the plugin to copy all files in public to the build folder and watch for changes in all source files (** is a deep wildcard).

// package.json
{
	...
    "staticFiles": {
        "staticPath": "public",
        "watcherGlob": "**"
    }
}

Multiple Static Directories

To copy more than one directory to the build folder, specify staticPath as an array. The following copies public and vendor/public:

// package.json
{
	...
    "staticFiles": {
        "staticPath": ["public", "vendor/public"]
    }
}

Watching for Changes

Parcel can rebuild your bundle(s) whenever changes occur in the static directory. This is disabled by default, but it can be enabled by specifying a glob pattern for files that shoudl be watched.

Note the relative file path is used in matching (not just the file name). To match filenames in deep directories, start with a "globstar" (double star). The plugin uses Node's built-in Minimatch Library for glob matching.

The following watches all XML files in the static directory:

// package.json
{
	...
    "staticFiles": {
        "staticPath": "public",
        "watcherGlob": "**/*.xml"
    }
}

To disable watching, either remove the "watcherGlob" key (disabled is the default) or set it to false/null/undefined:

// package.json
{
	...
    "staticFiles": {
        "staticPath": "public",
        "watcherGlob": false
    }
}

Contribute

You're interested in contributing? Awesome! Fork, make change, commit and create pull request. I'll do my best to merge changes!

License

MIT