⚡🤸 d-l-l

easy, automatic, optimized dll config handler for webpack

📦 install

yarn add d-l-l --dev
npm i d-l-l --save-dev

📘 examples

• react/inferno
• node

🌐 full api

⚙ advanced config examples

🔗 read more webpack dll plugins

🔬 tests

👋 intro

Webpack's Dll and DllReference plugins are a way to split a large JavaScript project into multiple bundles which can be compiled independently. They can be used to optimize build times (both full and incremental) and improve caching for users by putting code which changes infrequently into separate "library" bundles. - Robert Knight

Unfortunately, the DLL plugins come with some problems.

ℹ️️ This package aims to provide solutions for them by allowing you to pass in any existing webpack config, then get it back decorated with dll-reference-plugins and (only when needed) a whole dll-plugin-only config prepended!

❎ problems with dll plugin:

• can be a pain to configure
• requires manually adding plugins, and the entry points in your source code alongside the package dependencies
• requires multiple config files
• requires multiple build scripts
• requires manual cache busting when you change code, which makes it difficult to dynamically include code that does not often change
• does not work without even more configuration on nodejs

✅ solution

• no need to have double config files or double build scripts just for dll
• adding files that do not change often
• adding package dependencies with easy filtering
• easy (even one line) setup
• clearing the cache automatically when needed

🖼️ screenshots

without d-l-l

with d-l-l

❔ how

Webpack allows exporting an array of configs, so when required, a DLL-only config is created using the provided config(s) & prepended to the array of configs.

Cache files are created in a .fliphub folder (can be safely added to gitignore, similar to .happypack or similar). This helps to provide some smart-ish checks:

✚ = (dll config will be prepended)

0. when no cache exists, ✚
1. when there are no manifest files, ✚
2. when cache-busting-files change, the cache is busted and ✚
3. every X (default 33) builds ✚
4. after a day since the last build ✚

see the src code

📖 usage - custom

// webpack.config.js
const DLL = require('d-l-l')

const dll = new DLL()
const configs = dll
  .dir(__dirname)
  .config(config)
  // (dependencies, dev, all)
  .pkgDeps(deps => deps.filter(dep => !/lodash/.test(dep)))
  .toConfig()

module.exports = configs

👾 easy full auto usage

// webpack.config.js
const DLL = require('d-l-l')

const dll = new DLL()
const configs = dll
  .dir(__dirname)
  .config(config)
  .find()
  // defaults to bundledDependencies, fallback to dependencies
  .pkgDeps()
  .toConfig()

module.exports = configs