webpack-rails-manifest-plugin

A missing link to Webpack and Ruby on Rails integration.

This plugin can be used to flush a list of your assets to a manifest.json file and replace the asset pipeline.

Rails

Requiring assets in Rails will be a bit different and needs some configuration. Read our Rails helper documentation.

Usage

This is a Webpack plugin that creates a manifest file for your assets. It can output files to Webpack (as emitting) or as a file on the filesystem.

npm install --save-dev webpack-rails-manifest-plugin

In your webpack.config.js file specify the plugin:

1const RailsManifestPlugin = require('webpack-rails-manifest-plugin');
2
3{
4  plugins: [
5    new RailsManifestPlugin()
6  ]
7}

You'll find the manifest.json file in your output directory. You can read ore about the options here.

Requiring images

All images have to be required in the JavaScript in order for webpack to process them, except the ones you require in your scss file (because wepback is processing your scss file adready)

You can create a new file which will hold all the images, e.g. files.js

1require('images/file1.jpg');
2require('images/file2.jpg');
3require('images/file3.jpg');

And then in application.js (your entrypoint)

1require('files');

You can see an example configuration and its documentation here.

Output

Once you set everything up, you should see this in your manifest.json file:

1{
2  "images/file1.jpg": "963eb32907744d9a0d6b98127162808f.jpg",
3  "images/file2.jpg": "162808f4d9a0963eb3290774127d6b98.jpg",
4  "images/file3.jpg": "d6b98127162969a0808f3eb32907744d.jpg"
5}

Compatibility

This plugin is compatible with Webpack 1.x and 2.x. For rails compatibility please see our Rails helper documentation.

License

The MIT License

© 2016 Infinum Inc.