Webpack: Rage to sage

If you’re like me, your first encounter with Webpack was probably hostile. You’re trying to learn some new technology like React, launching a demo project to see how it works and something is broken. You examine the build scripts and suddenly you’re confronted with this arcane looking webpack.config.js file. You cruise over to the documentation for Webpack. It has many pages, none of them marked TL;DR. You hate reading documentation! This is not even what you were trying to do! You’re yak shaving again! Curse you JS tooling cambrian explosion! Gahh!!

Exhale. Webpack is not that complicated, especially for simple work flows. It’s becoming an integral part of the JS ecosystem and so it’s worth sitting down and learning it. You can do this, just focus.


What is the point of Webpack?

Webpack is a module bundler. You may be familiar with Browserify which allows you to use the AMD (Asynchronous Module Definition) syntax (var foo = require('bar');) in your frontend code, much the same and you would in your Node applications. Basically this:

// awesome is exported in another file
var wicked = require('awesome');

These tools basically suck in all the JS files required by your app and concatenate them into one JS file that you can add to your app. This is WAY better that managing a bunch of script tags in your index.html or wherever. You can configure loaders to do the same thing with other static files, like css and images.


But why Webpack? Doesn’t Browserify do this more simply?

There are compelling arguments for both technologies. One big arguement for Webpack is the ability to do React Hot-loading easily, speeding up dev time. But this post isn’t about choosing between the two. For whatever reason, you’re using Webpack now, DEAL WITH IT.

I’m looking at webpack.config.js and I’m angry.

Whoa. It’s cool. Look, let’s start with a very simple example, so we can improve the signal to noise ratio. You can find a repo with this example here: https://github.com/ohall/webpack-example

Let’s say you have an index.js file;

// index.js
var sweet = require('./sweet');

That requires a sweet module sweet.js

// sweet.js
module.exports = function () {
  window.onload = function () {
    var t = document.createTextNode('You did it! Sweet!');

We can set up our super simple webpack.config.js file will export a module with index.js as our entry file and output a file called bundle.js. Webpack figures out the rest.

module.exports = {
    entry: "./index.js",
    output: {
        path: __dirname,
        filename: "bundle.js"

NOTE: __dirname is a reference in Node for the currently executing directory.

Once you’ve installed Webpack globally,

npm install webpack -g

you can run webpack and create a bundle.js file that includes all the modules we need and use it in your HTML. Run the example to see what the bundle looks like.

<!doctype html>
    <script src="bundle.js"></script>


There is SO much more to Webpack, that I’ll dive into in the next post. For now though, you have enough to get you a footing in Webpack and start experimenting. JS tooling can be frustrating, especially when it feels like you have to learn a whole new build system every week. Don’t despair! Start simple, take time to learn it and try to have fun.

Next up: webpack loaders