CheatRollup JS module bundler
Light · Postcard
102 × 152 mm · PDF
Dark · Postcard
102 × 152 mm · PDF
Ink saver · Postcard
102 × 152 mm · PDF
Light · A4 landscape
297 × 210 mm · PDF
Dark · A4 landscape
297 × 210 mm · PDF
Ink saver · A4 landscape
297 × 210 mm · PDF
Light · A3 landscape
420 × 297 mm · PDF
Dark · A3 landscape
420 × 297 mm · PDF
Ink saver · A3 landscape
420 × 297 mm · PDF
Start here
rollup -cBuild with the config file
rollup -i <entry> -o <file> -f es
Bundle one file
rollup -i <entry> -d <dir>
Bundle to a folder
rollup -c -wRebuild on change
rollup -c --environment BUILD:production
Pass settings in
rollup -c -p <plugin>
Add a plugin
rollup -i <entry> -o <file> -m
Add a sourcemap
rollup --helpList all flags
Concepts
- Entry input
- Module graph plugins transform
- Chunks only used code
- Output file or dir
Build
rollup -cBuild using rollup.config.(mjs/cjs/js)
rollup -c <file>
Build using a named config
rollup -i <entry> -o <file>
Bundle entry into one file
rollup <entry> -o <file>
Same, entry as plain argument
rollup -i <entry> -d <dir>
Write chunks to a directory
rollup -i <entry> -o <file> -f
<fmt>
Pick output format
es, cjs, iife, umd, amd or system.
rollup -c -wWatch and rebuild
rollup -c --silent
Hide warnings
rollup -c --failAfterWarnings
Fail the build on warnings
rollup -c --forceExit
Force the process to quit when done
rollup -vShow version
Output options
-f iife -n <Name>
Browser global with name
-f umd -n <Name>
Universal module, needs a name
-g <id>:<Global>
Map external to global (iife/umd)
-mWrite sourcemap file
-m inlineEmbed the sourcemap in the bundle
--sourcemapExcludeSources
Leave source text out of maps
--sourcemapBaseUrl <url>
Emit absolute sourcemap URLs
--exports <mode>
Set export mode
auto, default, named or none. Mixed default and named exports
in cjs need named.
--entryFileNames <pattern>
Name entry chunks
For example [name]-[hash].js
--chunkFileNames <pattern>
Name shared chunks
--assetFileNames <pattern>
Name emitted assets
--banner <text>
Text at the top of the bundle
--footer <text>
Text at the end of the bundle
--intro <text>
Text inside the wrapper, top
--outro <text>
Text inside the wrapper, end
--compactMinify wrapper code only
--no-esModuleSkip the __esModule flag
--no-interopSkip the interop block
--no-strictDo not emit use strict
--generatedCode <preset>
Choose es5 or es2015 syntax
--no-indentDo not indent the wrapped output
Dependencies
-e <ids>Keep modules out of the bundle
Comma-separated, e.g. -e react,react-dom
--no-externalLiveBindings
Simplify generated code for externals
--preserveSymlinks
Do not follow symlinks
--shimMissingExports
Replace missing exports with a shim
--inlineDynamicImports
Fold dynamic imports into one file
--preserveModules
One output file per module
--preserveModulesRoot <path>
Strip this prefix from module paths
--context <variable>
Value for top-level this
--extendExtend the global named by -n
--noConflictAdd noConflict() to UMD output
Plugins and config
-p <plugin>
Use a plugin by name
Repeat or comma-separate; -p node-resolve loads
@rollup/plugin-node-resolve.
-p '{name: ..}'
Define a small inline plugin
--environment <KEY[:val]>
Set process.env values for the config
BUILD sets "true"; BUILD:production sets a string.
--configPlugin <plugin>
Transpile the config file (TypeScript)
--bundleConfigAsCjs
Allow __dirname and require in config
-c node:<name>
Load shared config from node_modules
--config<Name>
Custom flag read by a config function
Must start with config; the function gets commandLineArgs.
--stdin=<ext>
Give stdin input a file extension
--no-stdinTreat - as a normal filename
echo '<code>' | rollup -f cjs -o
<file>
Bundle code from stdin
Tree-shaking
--no-treeshakeTurn tree-shaking off
--no-treeshake.annotations
Ignore /*#__PURE__*/ comments
--treeshake.manualPureFunctions <names>
Declare functions as pure
--no-treeshake.moduleSideEffects
Assume imports have no side effects
--no-treeshake.propertyReadSideEffects
Ignore side effects of property reads
--no-treeshake.tryCatchDeoptimization
Shake inside try/catch too
--no-preserveEntrySignatures
Allow entries to lose exports
--no-hoistTransitiveImports
Do not hoist imports into entries
Watch mode
-wWatch files, rebuild on change
--watch.include <files>
Only watch these files
--watch.exclude <files>
Do not watch these files
--watch.buildDelay <ms>
Throttle rebuilds
--no-watch.clearScreen
Keep the terminal on rebuild
--watch.skipWrite
Build without writing files
--watch.onStart <cmd>
Run a shell command on START
--watch.onBundleEnd <cmd>
Run a command after each bundle
--watch.onEnd <cmd>
Run a command when a run finishes
--watch.onError <cmd>
Run a command on error
--waitForBundleInput
Wait for missing input files
Logging and debugging
--logLevel <level>
Choose which logs show
debug, info, warn or silent.
--filterLogs <filter>
Show only matching logs
e.g. code:CIRCULAR_DEPENDENCY; ! negates.
--perfPrint timing per phase
--validateValidate the generated output
--strictDeprecations
Error on deprecated features
--maxParallelFileOps <n>
Limit parallel file reads
--sourcemapDebugIds
Add debug ids to sources and maps
--hashCharacters <set>
Character set for file hashes
--minifyInternalExports
Force or disable short internal names
--no-sanitizeFileName
Keep invalid chars in file names
Recipes
# rollup.config.mjsimport { defineConfig } from 'rollup';export default defineConfig({ input: 'src/index.js', external: ['react'], output: [ { file: 'dist/index.mjs', format: 'es', sourcemap: true }, { file: 'dist/index.cjs', format: 'cjs', sourcemap: true } ]});npm i -D rollup @rollup/plugin-node-resolve @rollup/plugin-commonjs# in the config: plugins: [resolve(), commonjs()]rollup -c --environment BUILD:productionnpm i -D @rollup/plugin-typescriptrollup -c rollup.config.ts --configPlugin typescriptrollup -i src/main.js -o dist/app.js -f iife -n App \ -g jquery:jQuery -e jquery -m
