parcel-plugin-assets-list

Parcel Plugin for Assets Manifest

This plugin adds a new asset file type handler *.assets which reads a file of newline-separated file paths and adds them to the parcel outputs. Each file referenced in the list will be hashed by parcel and copied to the output folder (e.g. dist/)

To use this plugin, install it into your parcel project:

yarn add parcel-plugin-assets-list
# or
npm install parcel-plugin-assets-list

Then create an assets file, for example a file app.assets:

# HTML templates
templates/a.html
templates/b.html

# Stylesheets
scss/styles.scss

# Javascript
js/whatever.js

Now when you build with parcel it will copy those files into dist with a hashed name. In addition it will store the mapping of those files from the original name to the new name in a few ways:

• app.js: A javascript module you can import from your js files to get a javascript object mapping the name in the file to the resulting hashed filename
• app.json: A JSON file with the same mapping as above but in raw JSON, for consumption on the server side if you don't use JavaScript on the server.
• app.assets: A simple text-based file format with the original file path, a colon, a space (:) and the output path. Could be used instead of JSON if you like.

The actual filename depends on the input file name.