Please note that Webpacker 3.1.0 and 3.1.1 has some serious bugs so please consider using either 3.0.2 or 3.2.0

[3.2.0] - 2017-12-16

To upgrade:

bundle update webpacker
yarn upgrade @rails/webpacker

Breaking changes

If you are using react, vue, angular, elm, erb or coffeescript inside your packs/ please re-run the integration installers as described in the README.

bundle exec rails webpacker:install:react
bundle exec rails webpacker:install:vue
bundle exec rails webpacker:install:angular
bundle exec rails webpacker:install:elm
bundle exec rails webpacker:install:erb
bundle exec rails webpacker:install:coffee

Or simply copy required loaders used in your app from https://github.com/rails/webpacker/tree/master/lib/install/loaders into your config/webpack/loaders/ directory and add it to webpack build from config/webpack/environment.js

const erb =  require('./loaders/erb')
const elm =  require('./loaders/elm')
const typescript =  require('./loaders/typescript')
const vue =  require('./loaders/vue')
const coffee =  require('./loaders/coffee')

environment.loaders.append('coffee', coffee)
environment.loaders.append('vue', vue)
environment.loaders.append('typescript', typescript)
environment.loaders.append('elm', elm)
environment.loaders.append('erb', erb)

In .postcssrc.yml you need to change the plugin name from postcss-smart-import to postcss-import:

plugins:
  postcss-import: {}
  postcss-cssnext: {}

Added (npm module)

Upgrade gems and webpack dependencies
postcss-import in place of postcss-smart-import

Removed (npm module)

postcss-smart-import, coffee-loader, url-loader, rails-erb-loader as dependencies
publicPath from file loader #1107

Fixed (npm module)

Return native array type for ConfigList #1098

Added (Gem)

New asset_pack_url helper #1102
New installers for coffee and erb

bundle exec rails webpacker:install:erb
bundle exec rails webpacker:install:coffee

Resolved paths from webpacker.yml to compiler watched list

[3.1.1] - 2017-12-11

Fixed

Include default webpacker.yml config inside npm package

[3.1.0] - 2017-12-11

Added (npm module)

Expose base config from environment

environment.config.set('resolve.extensions', ['.foo', '.bar'])
environment.config.set('output.filename', '[name].js')
environment.config.delete('output.chunkFilename')
environment.config.get('resolve')
environment.config.merge({ output: {
    filename: '[name].js'
  }
})

Expose new API's for loaders and plugins to insert at position

const jsonLoader =  {
  test: /\.json$/,
  exclude: /node_modules/,
  loader: 'json-loader'
}

environment.loaders.append('json', jsonLoader)
environment.loaders.prepend('json', jsonLoader)
environment.loaders.insert('json', jsonLoader, { after: 'style' } )
environment.loaders.insert('json', jsonLoader, { before: 'babel' } )

// Update a plugin
const manifestPlugin = environment.plugins.get('Manifest')
manifestPlugin.opts.writeToFileEmit = false

// Update coffee loader to use coffeescript 2
const babelLoader = environment.loaders.get('babel')
environment.loaders.insert('coffee', {
  test: /\.coffee(\.erb)?$/,
  use:  babelLoader.use.concat(['coffee-loader'])
}, { before: 'json' })

Expose resolve.modules paths like loaders and plugins

environment.resolvedModules.append('vendor', 'vendor')

Enable sourcemaps in style and css loader
Separate css and sass loader for easier configuration. style loader is now css loader, which resolves .css files and sass loader resolves .scss and .sass files.

// Enable css modules with sass loader
const sassLoader = environment.loaders.get('sass')
const cssLoader = sassLoader.use.find(loader => loader.loader === 'css-loader')

cssLoader.options = Object.assign(cssLoader.options, {
  modules: true,
  localIdentName: '[path][name]__[local]--[hash:base64:5]'
})

Expose rest of configurable dev server options from webpacker.yml

quiet: false
headers:
  'Access-Control-Allow-Origin': '*'
watch_options:
  ignored: /node_modules/

pretty option to disable/enable color and progress output when running dev server

dev_server:
  pretty: false

Enforce deterministic loader order in desc order, starts processing from top to bottom
Enforce the entire path of all required modules match the exact case of the actual path on disk using case sensitive paths plugin.
Add url loader to process and embed smaller static files

Removed

resolve url loader #1042

Added (Gem)

Allow skipping webpacker compile using an env variable

WEBPACKER_PRECOMPILE=no|false|n|f
WEBPACKER_PRECOMPILE=false bundle exec rails assets:precompile

Use WEBPACKER_ASSET_HOST instead of ASSET_HOST for CDN
Alias webpacker:compile task to assets:precompile if is not defined so it works without sprockets

[3.0.2] - 2017-10-04

Added

Allow dev server connect timeout (in seconds) to be configurable, default: 0.01

# Change to 1s
Webpacker.dev_server.connect_timeout = 1

Restrict the source maps generated in production #770
Binstubs #833
Allow dev server settings to be overriden by env variables #843
A new lookup method to manifest to perform lookup without raise and return nil

Webpacker.manifest.lookup('foo.js')
# => nil
Webpacker.manifest.lookup!('foo.js')
# => raises Webpacker::Manifest::MissingEntryError

Catch all exceptions in DevServer.running? and return false #878

Removed

Inline CLI args for dev server binstub, use env variables instead
Coffeescript as core dependency. You have to manually add coffeescript now, if you are using it in your app.

yarn add coffeescript@1.12.7

# OR coffeescript 2.0
yarn add coffeescript

[3.0.1] - 2017-09-01

Fixed

Missing node_modules/.bin/* files by bumping minimum Yarn version to 0.25.2 #727
webpacker:compile task so that fails properly when webpack compilation fails #728
Rack dev server proxy middleware when served under another proxy (example: pow), which uses HTTP_X_FORWARDED_HOST header resulting in 404 for webpacker assets
Make sure tagged logger works with rails < 5 #716

Added

Allow webpack dev server listen host/ip to be configurable using additional --listen-host option
```
./bin/webpack-dev-server --listen-host 0.0.0.0 --host localhost
```

Removed

watchContentBase from devServer config so it doesn't unncessarily trigger live reload when manifest changes. If you have applied this workaround from #724, please revert the change from config/webpack/development.js since this is now fixed.

[3.0.0] - 2017-08-30

Added

resolved_paths option to allow adding additional paths webpack should lookup when resolving modules

  # config/webpacker.yml
  # Additional paths webpack should lookup modules
  resolved_paths: [] # empty by default

Webpacker::Compiler.fresh? and Webpacker::Compiler.stale? answer the question of whether compilation is needed. The old Webpacker::Compiler.compile? predicate is deprecated.
Dev server config class that exposes config options through singleton.
```
Webpacker.dev_server.running?
```
Rack middleware proxies webpacker requests to dev server so we can always serve from same-origin and the lookup works out of the box - no more paths prefixing
env attribute on Webpacker::Compiler allows setting custom environment variables that the compilation is being run with
```
Webpacker::Compiler.env['FRONTEND_API_KEY'] = 'your_secret_key'
```

Breaking changes

Note: requires running bundle exec rails webpacker:install

config/webpack/**/*.js:

The majority of this config moved to the @rails/webpacker npm package. webpacker:install only creates config/webpack/{environment,development,test,production}.js now so if you're upgrading from a previous version you can remove all other files.

webpacker.yml:

Move dev-server config options under defaults so it's transparently available in all environments
Add new HMR option for hot-module-replacement
Add HTTPS

Removed

Host info from manifest.json, now looks like this:

{
  "hello_react.js": "/packs/hello_react.js"
}

Fixed

Update webpack-dev-server.tt to respect RAILS_ENV and NODE_ENV values #502
Use 0.0.0.0 as default listen address for webpack-dev-server
Serve assets using localhost from dev server - #424

  dev_server:
    host: localhost

On Windows, ruby bin/webpacker and ruby bin/webpacker-dev-server will now bypass yarn, and execute via node_modules/.bin directly - #584

Breaking changes

Add compile and cache_path options to config/webpacker.yml for configuring lazy compilation of packs when a file under tracked paths is changed #503. To enable expected behavior, update config/webpacker.yml:
```
  default: &default
    cache_path: tmp/cache/webpacker
  test:
    compile: true

  development:
    compile: true

  production:
    compile: false
```

Make test compilation cacheable and configurable so that the lazy compilation only triggers if files are changed under tracked paths. Following paths are watched by default -

  ["app/javascript/**/*", "yarn.lock", "package.json", "config/webpack/**/*"]

To add more paths:

# config/initializers/webpacker.rb or config/application.rb
Webpacker::Compiler.watched_paths << 'bower_components'

[2.0] - 2017-05-24

Fixed

Update .babelrc to fix compilation issues - #306
Duplicated asset hosts - #320, #397
Missing asset host when defined as a Proc or on ActionController::Base.asset_host directly - #397
Incorrect asset host when running webpacker:compile or bin/webpack in development mode - #397
Update webpacker:compile task to use stdout and stderr for better logging - #395
ARGV support for webpack-dev-server - #286

Added

Elm support. You can now add Elm support via the following methods:
- New app: rails new <app> --webpack=elm
- Within an existing app: rails webpacker:install:elm
Support for custom public_output_path paths independent of source_entry_path in config/webpacker.yml. output is also now relative to public/. - #397

Before (compile to public/packs):
```
  source_entry_path: packs
  public_output_path: packs
```
After (compile to public/sweet/js):
```
  source_entry_path: packs
  public_output_path: sweet/js
```
https option to use https mode, particularly on platforms like - https://community.c9.io/t/running-a-rails-app/1615 or locally - #176
[Babel] Dynamic import() and Class Fields and Static Properties babel plugin to .babelrc

{
  "presets": [
    ["env", {
      "modules": false,
      "targets": {
        "browsers": "> 1%",
        "uglify": true
      },
      "useBuiltIns": true
    }]
  ],

  "plugins": [
    "syntax-dynamic-import",
    "transform-class-properties", { "spec": true }
  ]
}

Source-map support for production bundle

Breaking Change

Consolidate and flatten paths.yml and development.server.yml config into one file - config/webpacker.yml - #403. This is a breaking change and requires you to re-install webpacker and cleanup old configuration files.
```
bundle update webpacker
bundle exec rails webpacker:install

# Remove old/unused configuration files
rm config/webpack/paths.yml
rm config/webpack/development.server.yml
rm config/webpack/development.server.js
```
Warning: For now you also have to add a pattern in .gitignore by hand.
```
 /public/packs
+/public/packs-test
 /node_modules
```

[1.2] - 2017-04-27

Some of the changes made requires you to run below commands to install new changes.

bundle update webpacker
bundle exec rails webpacker:install

Fixed

Support Spring - #205

Spring.after_fork { Webpacker.bootstrap } if defined?(Spring)

Check node version and yarn before installing webpacker - #217
Include webpacker helper to views - #172
Webpacker installer on windows - #245
Yarn duplication - #278
Add back Spring for rails-erb-loader - #216
Move babel presets and plugins to .babelrc - #202

Added

A changelog - #211
Minimize CSS assets - #218

Pack namespacing support - #201

For example:

app/javascript/packs/admin/hello_vue.js
app/javascript/packs/admin/hello.vue
app/javascript/packs/hello_vue.js
app/javascript/packs/hello.vue

Add tree-shaking support - #250
Add initial test case by @kimquy #259
Compile assets before test:controllers and test:system

Removed

Webpack watcher - #295

[1.1] - 2017-03-24

This release requires you to run below commands to install new features.

bundle update webpacker
bundle exec rails webpacker:install

# if installed react, vue or angular
bundle exec rails webpacker:install:[react, angular, vue]

Added (breaking changes)

Static assets support - #153
Advanced webpack configuration - #153

Removed

config.x.webpacker[:digesting] = true

Files

CHANGELOG.md

Latest commit

History

CHANGELOG.md

File metadata and controls

[3.2.0] - 2017-12-16

To upgrade:

Breaking changes

Added (npm module)

Removed (npm module)

Fixed (npm module)

Added (Gem)

[3.1.1] - 2017-12-11

Fixed

[3.1.0] - 2017-12-11

Added (npm module)

Removed

Added (Gem)

[3.0.2] - 2017-10-04

Added

Removed

[3.0.1] - 2017-09-01

Fixed

Added

Removed

[3.0.0] - 2017-08-30

Added

Breaking changes

Removed

Fixed

Breaking changes

[2.0] - 2017-05-24

Fixed

Added

Breaking Change

[1.2] - 2017-04-27

Fixed

Added

Removed

[1.1] - 2017-03-24

Added (breaking changes)

Removed