Webpack is like a magic hydra that can eat any type of file and bundle it into a single output: .js, .ts, .ccs, .scss, .jsx, .tsx,
require
, import
, import
css from .js
, it doesn't matter at all, it just digests all into the same dump.When it works, you are just left in awe. When it doesn't, you're fucked and have to debug for several hours.
Demos under: webpack/.
webpack/template contains a reasonable starter template.
Usage:
cd webpack/template
npm install
npm run build
This will produce, under
dist/
the following minimized files:dist/index.html
: from webpack/template/index.html. You can open it to see:show on the browser. This was added from JavaScript.Hello webpack
dist/index.js
: from webpack/template/index.js and anything in its import tree, e.g.:- webpack/template/main.scss: sass source. It gets embedded the the JavaScript output as a string, and the JavaScript then applies it to the page, making the font blue
lodash
third party library
You can also run this test with the development server on localhost:9000:
which uses unminimized outptus, and automatically push reloads the page whenever you change any of the input files!
npm start
This example shows how to use Sass.
To make things simple, it generates a completely separate
dist/index.js
and dist/main.css
which are manually included from index.html
, and does not do any type of injection (neither Js into HTML nor CSS in Js).This example shows how you could manually include the
dist/index.js
that is output from webpack into your index.html
.This is generally not what you want to do, because what you actually want to do is to use a Js output name with a hash in it, so that browsers only need to refetch when the name changes.
And to do that, we have to let webpack dynamically inject that unpredictable hash as done in webpack/template with:
new HtmlWebpackPlugin({
filename: 'index.html',
// Inject the include to our hashed filename,
// since it is not deterministic due to the hash.
inject: true,
template: path.resolve(__dirname, 'index.html'),
}),
This shows how to produce a minimized fully embedded CSS file with webpack from a sass:
That example produces a
cd webpack/sass
npm install
npm run build
xdg-open index.html
dist/main.css
file which is a compresesd combination of:- webpack/sass/main.scss
- normalize.css, added to the project as a regular
node_modules
package