Skip to content

fliphub/d-l-l

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

⚡🤸 d-l-l

NPM version MIT License fliphub flipfam

easy, automatic, optimized dll config handler for webpack

📦 install

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

👋 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

🖼️ screenshots

without d-l-l

without d-l-l manual

with 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)

  1. when no cache exists, ✚
  2. when there are no manifest files, ✚
  3. when cache-busting-files change, the cache is busted and ✚
  4. every X (default 33) builds
  5. 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