ROLLUP(1)

📦
version 3.30.0 · 6 versions
, in ubuntu stonking

🌈 NAME 🌈

ok so hi bestie, welcome to the ROLLUP(1) manual page, general commands manual, and let me just say — rollup is a module bundler for JavaScript and it is literally the moment. 💖 That's the whole name section, that's the vibe, no cap.

✨ SYNOPSIS ✨

rollup [options] <entry file>

like. that's it. that's the whole entrance exam. 🎀

💅 OPTIONS 💅

okay so this is the part where I hold your hand through EVERY single flag, bestie, because there are like a hundred of them and I would never leave you hanging. 🫶

  • -c, --config <filename> — use this config file. if you pass the argument but don't give it a value, it defaults to rollup.config.js. 💜
  • -d, --dir <dirname> — directory for chunks. if it's absent, everything just prints to stdout. ✨
  • -e, --external <ids> — comma-separate list of module IDs to exclude. (yes, the original says "comma-separate", we're keeping it, we don't fix the man page, we love the man page.) 🌸
  • -f, --format <format> — type of output. your choices are amd, cjs, es, iife, umd, system. pick your fighter. 👑
  • -g, --globals <pairs> — comma-separate list of moduleID:Global pairs. 🦋
  • -h, --help — show this help message. the classic. 😭
  • -i, --input <filename> — input, as an alternative to <entry file>. 🌟
  • -m, --sourcemap — generate sourcemap. use -m inline for an inline map. 🔥
  • -n, --name <name> — name for UMD export. 💫
  • -o, --file <output> — single output file. if it's absent, prints to stdout. 🍓
  • -p, --plugin <plugin> — use the plugin specified. may be repeated, so go wild. 💜
  • -v, --version — show version number. 🎀
  • -w, --watch — watch files in bundle and rebuild on changes. main character behavior honestly. 👑
  • --amd.autoId — generate the AMD ID based off the chunk name. ✨
  • --amd.basePath <prefix> — path to prepend to auto generated AMD ID. 🌈
  • --amd.define <name> — function to use in place of define. 🦋
  • --amd.forceJsExtensionForImports — use .js extension in AMD imports. 💅
  • --amd.id <id> — ID for AMD module (default is anonymous). 🎀
  • --assetFileNames <pattern> — name pattern for emitted assets. 🌸
  • --banner <text> — code to insert at top of bundle (outside wrapper). ⭐
  • --chunkFileNames <pattern> — name pattern for emitted secondary chunks. 💖
  • --compact — minify wrapper code. tiny. adorable. iconic. ✨
  • --context <variable> — specify top-level this value. 🌟
  • --no-dynamicImportInCjs — write external dynamic CommonJS imports as require. 🔥
  • --entryFileNames <pattern> — name pattern for emitted entry chunks. 🌈
  • --environment <values> — settings passed to config file (see the example bestie, I got you). 💜
  • --no-esModule — do not add __esModule property. 🎀
  • --exports <mode> — specify export mode (auto, default, named, none). 🦋
  • --extend — extend global variable defined by --name. 👑
  • --no-externalImportAssertions — omit import assertions in "es" output. 🌸
  • --no-externalLiveBindings — do not generate code to support live bindings. 💫
  • --failAfterWarnings — exit with an error if the build produced warnings. dramatic and valid. 😭
  • --filterLogs <filter> — filter log messages. 🍓
  • --footer <text> — code to insert at end of bundle (outside wrapper). ⭐
  • --no-freeze — do not freeze namespace objects. 🧊 nope, wrong emoji, anyway. 🙈
  • --generatedCode <preset> — which code features to use (es5/es2015). 💅
  • --generatedCode.arrowFunctions — use arrow functions in generated code. 🏹
  • --generatedCode.constBindings — use "const" in generated code. ✨
  • --generatedCode.objectShorthand — use shorthand properties in generated code. 🌈
  • --no-generatedCode.reservedNamesAsProps — always quote reserved names as props. 🦋
  • --generatedCode.symbols — use symbols in generated code. 🔮
  • --no-hoistTransitiveImports — do not hoist transitive imports into entry chunks. 💜
  • --no-indent — don't indent result. flat. minimalist. 🎀
  • --inlineDynamicImports — create single bundle when using dynamic imports. 🌸
  • --no-interop — do not include interop block. 🌟
  • --intro <text> — code to insert at top of bundle (inside wrapper). ⭐
  • --logLevel <level> — which kind of logs to display. 👑
  • --no-makeAbsoluteExternalsRelative — prevent normalization of external imports. 🦋
  • --maxParallelFileOps <value> — how many files to read in parallel. multitasking queen energy. 🔥
  • --minifyInternalExports — force or disable minification of internal exports. ✨
  • --noConflict — generate a noConflict method for UMD globals. 🕊️
  • --outro <text> — code to insert at end of bundle (inside wrapper). ⭐
  • --perf — display performance timings. 💅
  • --no-preserveEntrySignatures — avoid facade chunks for entry points. 🎀
  • --preserveModules — preserve module structure. 🌿
  • --preserveModulesRoot — put preserved modules under this path at root level. 🌈
  • --preserveSymlinks — do not follow symlinks when resolving files. 🔗
  • --no-sanitizeFileName — do not replace invalid characters in file names. 💀
  • --shimMissingExports — create shim variables for missing exports. 🫶
  • --silent — don't print warnings. 🤫
  • --sourcemapBaseUrl <url> — emit absolute sourcemap URLs with given base. 🌐
  • --sourcemapExcludeSources — do not include source code in source maps. 🦋
  • --sourcemapFile <file> — specify bundle position for source maps. 📍
  • --sourcemapFileNames <pattern> — name pattern for emitted sourcemaps. 🌸
  • --stdin=ext — specify file extension used for stdin input. 💜
  • --no-stdin — do not read "-" from stdin. ✋
  • --no-strict — don't emit "use strict"; in the generated modules. rebel era. 😤
  • --strictDeprecations — throw errors for deprecated features. 📢
  • --no-systemNullSetters — do not replace empty SystemJS setters with null. 🎀
  • --no-treeshake — disable tree-shaking optimisations. 🌳🚫
  • --no-treeshake.annotations — ignore pure call annotations. 🏷️
  • --treeshake.correctVarValueBeforeDeclaration — deoptimize variables until declared. 🦋
  • --treeshake.manualPureFunctions <names> — manually declare functions as pure. 😇
  • --no-treeshake.moduleSideEffects — assume modules have no side effects. 🌸
  • --no-treeshake.propertyReadSideEffects — ignore property access side effects. 💫
  • --no-treeshake.tryCatchDeoptimization — do not turn off try-catch-tree-shaking. 🪤
  • --no-treeshake.unknownGlobalSideEffects — assume unknown globals do not throw. 🤷
  • --validate — validate output. ✅
  • --waitForBundleInput — wait for bundle input files. 🕰️
  • --watch.buildDelay <number> — throttle watch rebuilds. 🐢
  • --no-watch.clearScreen — do not clear the screen when rebuilding. 🧼🚫
  • --watch.exclude <files> — exclude files from being watched. 🙈
  • --watch.include <files> — limit watching to specified files. 👀
  • --watch.onBundleEnd <cmd> — shell command to run on "BUNDLE_END" event. 🎬
  • --watch.onBundleStart <cmd> — shell command to run on "BUNDLE_START" event. 🎬
  • --watch.onEnd <cmd> — shell command to run on "END" event. 🏁
  • --watch.onError <cmd> — shell command to run on "ERROR" event. 🚨
  • --watch.onStart <cmd> — shell command to run on "START" event. 🚀
  • --watch.skipWrite — do not write files to disk when watching. 🚫💾

🌟 EXAMPLES 🌟

here comes the fun part bestie, actual receipts 💖

  • use settings in config file
rollup -c
  • in config file, process.env.INCLUDE_DEPS === 'true' and process.env.BUILD === 'production'
rollup -c --environment INCLUDE_DEPS,BUILD:production
  • create CommonJS bundle.js from src/main.js
rollup --format=cjs --file=bundle.js -- src/main.js
  • create self-executing IIFE using window.jQuery and window._ as external globals
rollup -f iife --globals jquery:jQuery,lodash:_ \
  -i src/app.js -o build/app.js -m build/app.js.map

📝 NOTES 📝

  • when piping to stdout, only inline sourcemaps are permitted. do not skip this one, it will humble you. 😭

for more information visit https://rollupjs.org

ok that's the whole page, you ate it, you're so good at this 🫶💅✨

and one last thing — this was the rollup manual page, version 3.30.0, dated June 2026, filed under ROLLUP(1) in the general commands manual. go bundle something iconic, bestie. 👑💖

📦 where this page comes from