When does Webpacker compile?
Webpack builds can take a long time, so we only want to compile when needed.
This card shows what will cause Webpacker (the Rails/Webpack integration) to compile your assets.
While development it is recommended to boot a webpack dev server using
The dev server compiles once when booted. When you access your page on
localhost before the initial compilation, the page may load without assets.
localhost will automatically reload the get the new assets. You cannot speed up this process by reloading manually before the dev server has finished re-compiling, you will just reload the same old assets.
When you don't have a dev server running and call any helper that accesses asset paths (e.g.
image_tag), Rails will compile your entire assets within its process before that helper returns.
This will cause your helper to freeze for many seconds. Since Webpack needs to boot from scratch and re-compile after every change it can make reloading the page extremely slow. For this reason it is recommended to use a dev server during development.
This behavior can be disabled by the
compile: true setting in
Note that this can also cause your RSpec specs to compile assets if you have any view specs, if a model refers to a compiled image path, or similar. See this card for a way to mitigate the damage.
You can call
bin/webpack explicitely to compile files to
When deploying with Capistrano this is done automatically by the
Webpacker only compiles when files changed. It detects changes by making a SHA1 digest over the contents of the following files:
If you make changes to any other files, Webpacker will not recompile.
The digest of the last compilation is cached in
-test with your environment). You can remove that file to force a re-compile.