@swc/cli

Usage#

Run the following to download pre-built binaries:

npm i -D @swc/cli @swc/core

Then, you can transpile your files:

# Transpile one file and emit to stdout
npx swc ./file.js

# Transpile one file and emit to `output.js`
npx swc ./file.js -o output.js

# Transpile and write to /output dir
npx swc ./my-dir -d output

Options#

--filename (-f)#

Filename to use when reading from stdin. This will be used in source maps and errors.

npx swc -f input.js

--config-file#

Path to a .swcrc file to use.

npx swc input.js --config-file .swcrc

--env-name#

The name of the 'env' to use when loading configs and plugins. Defaults to the value of SWC_ENV, or else NODE_ENV, or else development.

npx swc input.js --env-name='test'

--no-swcrc#

Whether or not to look up .swcrc files.

npx swc input.js --no-swcrc

--ignore#

List of glob paths to not compile.

npx swc src --ignore **/*.test.js

--only#

List of glob paths to only compile

Example:

npx swc src --only **/*.js

--watch (-w)#

To automatically recompile files on changes, install chokidar:

npm i -D chokidar

Then, add the -w flag:

npx swc input.js -w

--quiet (-q)#

Suppress compilation output.

npx swc input.js -q

--source-maps (-s)#

Values: true|false|inline|both

npx swc input.js -s

--source-map-target#

Define the file for the source map.

npx swc input.js -s --source-map-target input.map.js

--source-file-name#

Set sources[0] on returned source map

--source-root#

The root from which all sources are relative.

--out-file (-o)#

Compile all input files into a single file.

npx swc input.js -o output.js

--out-dir (-d)#

Compile an input directory of modules into an output directory.

npx swc src -d dist

--copy-files (-D)#

When compiling a directory, copy over non-compilable files.

npx swc src --copy-files

--include-dotfiles#

Include dotfiles when compiling and copying non-compilable files.

npx swc src --include-dotfiles

--config (-C)#

Override a config from .swcrc file.

npx swc src -C module.type=amd -C module.moduleId=hello

--sync#

Invoke swc synchronously. Useful for debugging.

npx swc src --sync

--log-watch-compilation#

Log a message when a watched file is successfully compiled.

npx swc input.js --log-watch-compilation

--extensions#

Use specific extensions.