Using a library in your webpack project? Use these tips to make your bundle smaller!
Want to add a tip? See the contribution guide and make a pull request!
Contents:
babel-polyfill
core-js
history
lodash
lodash-es
moment
react
reactstrap
react-bootstrap
react-router
styled-components
whatwg-fetch
- Solutions that work with multiple libraries
babel-polyfill
is a Babel’s package that loads core-js
and a custom regenerator runtime. Babel docs · npm package
For the list of optimizations, see the core-js
section.
core-js
is a set of polyfills for ES5 and ES2015+. npm package
✅ Safe to use by default / How to enable / Added by @iamakulov
If you compile your code with Babel and babel-preset-env
, add the useBuiltIns: true
option. This option configures Babel to only include polyfills that are necessary for target browsers. I.e., if you target your app to support Internet Explorer 11:
// .babelrc
{
"presets": [
[
"env",
{
"targets": {
"browsers": ["last 2 versions", "ie >= 11"]
}
}
]
]
}
enabling useBuiltIns: true
will remove polyfills for all features that Internet Explorer 11 already supports (such as Object.create
, Object.keys
and so on).
✅ Safe to use by default / How to enable / Added by @iamakulov
All browsers that support <script type="module">
also support modern JS features like async
/await
, arrow functions and classes. Use this feature to build two versions of the bundle and make modern browsers load only the modern code. For the guide, see the Philip Walton’s article.
Lodash is an utility library. npm package
✅ Safe to use by default / How to enable / Added by @iamakulov
babel-plugin-lodash
replaces full imports of Lodash with imports of specific Lodash functions:
import _ from 'lodash'
_.map([1, 2, 3], i => i + 1)
↓
import _map from 'lodash/map'
_map([1, 2, 3], i => i + 1)
Note: the plugin doesn’t work with chain sequences – i.e. code like
_([1, 2, 3]).map(i => i + 1).value()
won’t be optimized.
✅ Safe to use by default / How to enable is ↓ / Added by @7rulnik
Some of your dependencies might use the lodash-es
package instead of lodash
. If that’s the case, Lodash will be bundled twice.
To avoid this, alias the lodash-es
package to lodash
:
// webpack.config.js
module.exports = {
resolve: {
alias: {
'lodash-es': 'lodash',
},
},
};
⚠ Use with caution / How to enable / Added by @iamakulov
lodash-webpack-plugin
strips parts of Lodash functionality that you don’t need. For example, if you use _.get()
but don’t need deep path support, this plugin can remove it. Add it to your webpack config to make the bundle smaller.
Use the plugin with caution. The default settings remove a lot of features, and your app might use some of them.
lodash-es
is Lodash with ES imports and exports. npm package
For the list of optimizations, see the lodash
section.
Moment.js is a library for working with dates. npm package
⚠ Use with caution / How to enable / Added by @iamakulov
By default, Moment.js ships with 160+ minified KBs of localization files. If you app is only available in a few languages, you won’t need all these files. Use moment-locales-webpack-plugin
to remove the unused ones.
Use the plugin with caution. The default settings remove all locales; this might break your app if you use some of them.
React is a library for building user interfaces. npm package
✅ Safe to use by default / How to enable / Added by @iamakulov
React doesn’t perform propTypes
checks in production, but the propTypes
declarations still occupy a part of the bundle. Use babel-plugin-transform-react-remove-prop-types
to remove them from during building.
⚠ Use with caution / How to migrate / Added by @iamakulov
Preact is a smaller React alternative with a similar API. Switching to it saves you 250 minified KBs (tested with preact@8.2.7
+ preact-compat@3.17.0
vs. react@16.2.0
+ react-dom@16.2.0
).
Migrate to Preact with caution. Preact is not 100% compatible with React – i.e. it doesn’t support synthetic events and some React 16 features. However, many projects still can be migrated without any codebase changes. See the migration guide.
styled-components
is a CSS-in-JS library. npm package
✅ Safe to use by default / How to enable / Added by @iamakulov
There’s babel-plugin-styled-components
that minifies the CSS code you write with styled-components
. See the minification docs.
whatwg-fetch
is a complete window.fetch()
polyfill. npm package
⚠ Use with caution / How to migrate is ↓ / Added by @iamakulov
unfetch
is a 500 bytes polyfill for window.fetch()
. Unlike whatwg-fetch
, it doesn’t support the full window.fetch()
API, but instead focuses on polyfilling the most used parts.
Migrate to unfetch
with caution. While it supports the most popular API parts, your app might break if it relies on something less common.
Of course, there are also optimization tips for other libaries too. You can use them with common sense to get smaller or more performant bundles.
✅ Safe to use by default / How to enable / Added by @kurtextrem / More Insight about this on Twitter
This handy babel plugin will transform your imports to only import specific components, which ensures not the whole library gets included (if tree-shaking is ineffective for the specific library).
// Before
import { Grid, Row, Col } from 'react-bootstrap';
// After
import Grid from 'react-bootstrap/lib/Grid';
import Row from 'react-bootstrap/lib/Row';
import Col from 'react-bootstrap/lib/Col';
Copyright 2018 Google Inc. All Rights Reserved. Licensed under the Apache License, Version 2.0.