Usage: rollup [options]
Basic options:
-c, --config Use this config file (if argument is used but value
is unspecified, defaults to rollup.config.js)
-d, --dir Directory for chunks (if absent, prints to stdout)
-e, --external Comma-separate list of module IDs to exclude
-f, --format Type of output (amd, cjs, es, iife, umd, system)
-g, --globals Comma-separate list of moduleID:Global
pairs
-h, --help Show this help message
-i, --input Input (alternative to )
-m, --sourcemap Generate sourcemap (-m inline
for inline map)
-n, --name Name for UMD export
-o, --file Single output file (if absent, prints to stdout)
-p, --plugin Use the plugin specified (may be repeated)
-v, --version Show version number
-w, --watch Watch files in bundle and rebuild on changes
--amd.id ID for AMD module (default is anonymous)
--amd.autoId Generate the AMD ID based off the chunk name
--amd.basePath Path to prepend to auto generated AMD ID
--amd.define Function to use in place of define
--amd.forceJsExtensionForImports Use .js
extension in AMD imports
--assetFileNames Name pattern for emitted assets
--banner Code to insert at top of bundle (outside wrapper)
--chunkFileNames Name pattern for emitted secondary chunks
--compact Minify wrapper code
--context Specify top-level this
value
--entryFileNames Name pattern for emitted entry chunks
--environment Settings passed to config file (see example)
--no-esModule Do not add __esModule property
--exports Specify export mode (auto, default, named, none)
--extend Extend global variable defined by --name
--no-externalLiveBindings Do not generate code to support live bindings
--failAfterWarnings Exit with an error if the build produced warnings
--footer Code to insert at end of bundle (outside wrapper)
--no-freeze Do not freeze namespace objects
--no-hoistTransitiveImports Do not hoist transitive imports into entry chunks
--no-indent Don't indent result
--no-interop Do not include interop block
--inlineDynamicImports Create single bundle when using dynamic imports
--intro Code to insert at top of bundle (inside wrapper)
--minifyInternalExports Force or disable minification of internal exports
--namespaceToStringTag Create proper .toString
methods for namespaces
--noConflict Generate a noConflict method for UMD globals
--outro Code to insert at end of bundle (inside wrapper)
--preferConst Use const
instead of var
for exports
--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 Emit absolute sourcemap URLs with given base
--sourcemapExcludeSources Do not include source code in source maps
--sourcemapFile Specify bundle position for source maps
--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
--strictDeprecations Throw errors for deprecated features
--systemNullSetters Replace empty SystemJS setters with null
--no-treeshake Disable tree-shaking optimisations
--no-treeshake.annotations Ignore pure call annotations
--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
--waitForBundleInput Wait for bundle input files
--watch.buildDelay Throttle watch rebuilds
--no-watch.clearScreen Do not clear the screen when rebuilding
--watch.skipWrite Do not write files to disk when watching
--watch.exclude Exclude files from being watched
--watch.include Limit watching to specified files
--watch.onStart Shell command to run on "START"
event
--watch.onBundleStart Shell command to run on "BUNDLE_START"
event
--watch.onBundleEnd Shell command to run on "BUNDLE_END"
event
--watch.onEnd Shell command to run on "END"
event
--watch.onError Shell command to run on "ERROR"
event
--validate Validate output
Examples:
rollup -c
rollup -c --environment INCLUDE_DEPS,BUILD:production
rollup --format=cjs --file=bundle.js -- src/main.js
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
For more information visit https://rollupjs.org