🍾🍾🍾It's our absolute pleasure to announce Webpack 4 Support 🚀🚀🚀
HEADLINES (May 2018): Now Independently supports Webpack 4: Yep that's right. The universal family is now fully Webpack 4. Thank you to all our users for your loyalty and patience! If you love Universal, then you are gonna fall head over heels when we bring out the main course!
So... why did we rebuild
extract-css-chunks? What does it offer?
It's got all the goodness of
mini-css-extract-plugin but with 2 gleaming, sought after benefits.
Compared to the existing loaders, we are offering a single solution as opposed to needing to depend on multiple loaders to cater for different features:
- HMR: It also has first-class support for Hot Module Replacement across ALL those css files/chunks!!!
- cacheable stylesheets
- smallest total bytes sent compared to "render-path" css-in-js solutions that include your CSS definitions in JS
- Faster than the V2!
- Async loading
- No duplicate compilation (performance)
- Easier to use
- Specific to CSS
- SSR Friendly development build, focused on frontend DX
- Works seamlessly with the Universal family
- Works fantastically as a standalone style loader (You can use it for any webpack project! with no extra dependencies!)
Additionally, if you are already a user of the universal family -- we will be waving goodbye to the mandatory
The functionality is still available to you via chunk flushing, and it can come in super handy when needing to easily resolve style assets as urls that might need to be passed to a third party.
Webpack 4 Standalone Installation:
If you are just looking for something that works like
mini-css-extract-plugin but with HMR, then look no further.
NOTE: We have aligned out loader implementation to be the same as
If you already use
mini-css-extract-plugin, then you can just change the
require statement - it's that easy
yarn add --dev extract-css-chunks-webpack-plugin
const ExtractCssChunks =moduleexports =module:rules:test: /\.css$/use:ExtractCssChunksloader"css-loader"plugins:// Options similar to the same options in webpackOptions.output// both options are optionalfilename: "[name].css"chunkFilename: "[id].css"hot: true // if you want HMR - we try to automatically inject hot reloading but if it's not working, add it to the configorderWarning: true // Disable to remove warnings about conflicting order between importsreloadAll: true // when desperation kicks in - this is a brute force HMR flagcssModules: true // if you use cssModules, this can help.
The server needs to be handled differently, we still want one chunk. Luckily webpack 4 supports LimitChunkCountPlugin
What about Webpack 3?
This is a breaking change. The entire loader has been fundamentally rewritten specifically for Webpack 4. Aiming to support our existing user base, allowing them to upgrade their infrastructure to support Webpack 4 based universally code-split server-side rendered react applications.
There have been some challenges along the way since the release of webpack 4. Ultimately the only remaining hurdle is code split, async style loading.
If you do need Webpack 3, make sure to stick with the latest
v3.x.x is only intended for users with Webpack 4
Note: this is a companion package to:
- babel-plugin-universal-import or babel-plugin-dual-import
Recommended Installation For Universal
yarn add react-universal-component webpack-flush-chunks yarn add --dev extract-css-chunks-webpack-plugin babel-plugin-universal-import
The main thing is you need to cater to the new chunking system of webpack!
With webpack.optimize.CommonsChunkPlugin plugin no longer part of Webpack 4, we need another way to define the code-splitting. Luckily we have
optimization configs built into webpack now
There are more aggressive ways to code split, thanks to webpack 4. Check out the RUC Readme if you are looking for a more aggressive code split optimization configuration. These are just examples, you should be able to configure them as you see fit
const ExtractCssChunks =moduleexports =module:rules:test: /\.css$/use:ExtractCssChunksloaderloader: 'css-loader'options:modules: truelocalIdentName: '[name]__[local]--[hash:base64:5]'optimization:// FOR PRODUCTIONminimizer:uglifyOptions:output:comments: falseascii_only: truecompress:comparisons: false// END// NEEDED BOTH IN PROD AND DEV BUILDSruntimeChunk:name: 'bootstrap'splitChunks:chunks: 'initial'cacheGroups:vendors:test: /[\\/]node_modules[\\/]/name: 'vendor'plugins:hot:true cssModules: true //if you want HMR - we try to automatically inject hot reloading but if it's not working, add it to the config;
Here's the sort of CSS you can expect to serve:
If you need to resolve your stylesheets on the client side, for whatever reason.
webpack-flush-chunks will scoop up the exact stylesheets to embed in your response. It will give you an object which can be embedded on page
Here's how you do it:
const UniversalComponent =<UniversalComponent page='Foo' />
const app = ReactDOMServerconst js styles cssHash =res
As for asynchronous calls to
import() on user navigation, babel-plugin-universal-import is required if you're using react-universal-component. And if you aren't, you must use: babel-plugin-dual-import.
These babel plugins request both your js + your css. Very Nice! This is the new feature of the 2.0. Read Sokra's (author of webpack) article on how on how this is the future of CSS for webpack. Use this and be in the future today.
You can pass the same options as
new ExtractCssChunks, such as:
filename: devMode ? '[name].css' : '[name].[hash].css'chunkFilename: devMode ? '[id].css' : '[id].[hash].css'
Keep in mind, by default
[name].cssis used when
process.env.NODE_ENV === 'development'and
[name].[contenthash].cssduring production, so you can likely forget about having to pass anything.
Blank array in HMR script?
If you have issues with HMR, but enabled the loader, plugin, and already tried
hot: true, reloadAll:true, then your webpack config might be more abstract than my simple lookup functions. In this case, Ive exported out the actual hot loader, you can add this manually and as long as you've got the plugin and loader -- it'll work
rules:test: /\.css$/use:ExtractCssChunkshotLoader // for those who want to manually force hotLoadingExtractCssChunksloaderloader: 'css-loader'options:modules: truelocalIdentName: '[name]__[local]--[hash:base64:5]'
The most common workflow when working with webpack is to write a "development" / "production" value in to the 'process.env.NODE_ENV' namespace, typically, using webpack's built-in "DefinePlugin" plugin. e.g:
For example, when running the build using some form of npm script:
cross-env is optional but recommended.
What about Glamorous, Styled Components, Styled-Jsx, Aphrodite, etc?
If you effectively use code-splitting, Extract Css Chunks can be a far better option than using emerging solutions like Glamorous, Styled Components, and slightly older tools like Aphrodite, Glamor, etc. We aren't fans of either rounds of tools because of several issues, but particularly because they all have a runtime overhead. Every time your React component is rendered with those, CSS is generated and updated within the DOM. On the server, you're going to also see unnecessary cycles for flushing the CSS along the critical render path. Next.js's
styled-jsx, by the way, doesn't even work on the server--not so good when it comes to flash of unstyled content (FOUC).
The reason Extract CSS Chunk can be a better option is because we also generate multiple sets of CSS based on what is actually "used", but without the runtime overhead. The difference is our definition of "used" is modules determined statically (which may not in fact be rendered) vs. what is in the "critical render path" (as is the case with the other tools).
So yes, our CSS may be mildly larger and include unnecessary css, but our
On top of that, those are extra packages all with a huge number of issues in their Github repos corresponding to various limitations in the CSS they generate--something that is prevented when your definition for "CSS-in-JS" is simply importing CSS files compiled as normal by powerful proven CSS-specific processors.
Now with that out of the way, for completeness let's compare what bytes of just the CSS are sent over the wire. The difference basically is minimal. Whereas solutions that flush from the critical render path will capture no more than the precise bits of CSS from the
if/else branches followed, Extract Css Chunks is all about you effectively using code-splitting to insure, for example, you don't serve your Administration Panel's CSS in your public-facing site, etc. In other words, it's all about avoiding serving large swaths of CSS from completely different sections of your app. I.e. the biggest gains available to you.
Read more on the topic ^^
This is where the real problem lies--where the real amount of unnecessary CSS comes from. If you effectively code-split your app, you may end up with 10 chunks. Now you can serve just the corresponding CSS for that chunk. If you try to go even farther and remove the css not used in the render path, you're likely achieving somewhere between 1-20% of the gains you achieved by thorough code-splitting. In other words, code splitting fulfills the 80/20 rule and attains the simple sweetspot of 80% optimization you--as a balanced, level-headed, non-neurotic and professional developer--are looking to achieve.
In short, by putting code splitting in appropriate places you have a lot of control over the CSS files that are created and can send a sensible minimal amount of associated bytes over the wire for the first request, perhaps even the smallest amount of all options.
It's our perspective that you have achieved 80-99% of the performance gains (i.e. the creation of small relevant css files) at this static stage. Offloading this work to the runtime stage is ultimately nit-picking and results in diminishing returns. When you factor that your JS bundle has to contain that JS anyway, those solutions make less and less sense from the perspective of reducing bytes delivered in the initial request.
There may be other reasons to use those tools (e.g. you don't like setting up webpack configs, or somehow you're really fond of pre-creating many
<div /> elements with their styles), but we prefer a simple standards-based way (without HoCs or specialized style components) to import styles just as you would in React Native. However to give the other tools credit, many of them likely started out with a different problem motivating them: avoiding webpack configs so you can include packages and their contained CSS without client apps being required to setup something like CSS loaders in Webpack. Having your CSS completely contained in true JS has its use cases, but at the application level--especially when you're already using something like Webpack--we fail to see its benefits. About all they share is a solution to avoiding flashes of unstyled content (FOUC), except one can save you a lot more bytes in what you send over the wire and save you from a continual runtime overhead where it's not needed. Honorable Mention: StyleTron's concept of "atomic declaration-level deduplication" where it will make a class out of, say,
color: blue so you don't need to send redundant styles certainly is a novel innovation, but again if the code still exists in your JS and you're building an application using Webpack (instead of a package), what's the point. In fact, it just makes editing the stylesheets in your browser developer tools more complicated. One benefit of critical render path solutions is the browser can spend less time matching the smaller number of styles to new DOM nodes as they appear, but then again it also has to spend the time injecting and parsing the new styles constantly, which is likely costlier.
extract-css-chunks-webpack-plugin and your pre-processors of choice that innately get styles right for the browser. As long as you're using CSS Modules, you're still at the cutting edge of CSS-in-JSS. Let's just say the other tools took one wrong turn and took it too far, when we already were at our destination.
SUMMARY OF BENEFITS COMPARED TO "CRITICAL-RENDER-PATH" SOLUTIONS:
- no continual runtime overhead during
renderusing HoCs that inject styles
- smaller JS bundles without CSS injection
- You DO NOT need to clutter your component code with a specialized way of applying CSS (HoCs, styled elements)!
- The way you import module-based styles is exactly how you would import styles in React Native that exist in a separate file, which allows for extremely interchangeable code between React Native and regular React. Hurray!
- pretty much already does everything covered by @vjeux's 2014 css-in-js talk, besides dead code elimination. Dead code elimination is only solved for the other tools--as per the explanation above how the CSS is in the JS anyway--so much as Webpack and Uglify can remove JS that is not used. Either way, it's not a stretch to eventually add this feature to
extract-text-webpack-pluginas well as this plugin. Hey, maybe it already has it??
Emotion is different. They allow for the extraction of static styles via their extract mode. We're very much looking forward to this being the perfect companion to the css chunks approach.
Read more on the topic ^^
Currently however extract mode does not support IE11. So that means it's a no go, but we have hopes that in the future they'll solve that problem.
The reason Emotion doesn't work in IE11+ is because they currently try to preserve any dynamic aspects of your CSS-in-JS by converting it CSS vars, which isn't supported in IE11. That was a very smart approach, but unfortunately not good enough.
The vision we'd like to see for that package is where dynamic css stays inline, and where only static CSS is extracted into stylesheets, in which case CSS vars aren't needed. I've heard from them they have some "hidden flags" that allow for something close to this. When, and if, they take this feature all the way, look forward to us pushing it as our recommended approach. Go Emotion!
Linaria is another modern CSS-in-JSS library. It's focused around static styles, which may make it a perfect fit for usage with this plugin. Check it out:
What if I don't use SSR and use html-webpack-plugin?
For that case you can use css-chunks-html-webpack-plugin which will extract CSS chunks paths into your HTML file.
We love CSS modules; no less, no more.
Long live the dream of Code Splitting Everywhere!
We use commitizen, so run
npm run cm to make commits. A command-line form will appear, requiring you answer a few questions to automatically produce a nicely formatted commit. Releases, semantic version numbers, tags and changelogs will automatically be generated based on these commits thanks to semantic-release. Be good.
More from FaceySpacey in Reactlandia
- redux-first-router. It's made to work perfectly with Universal. Together they comprise our "frameworkless" Redux-based approach to what Next.js does (splitting, SSR, prefetching, and routing). People are lovin it by the way 😎