ncc
github.com
- Free plan
- Linux
What ncc is
ncc is a command-line tool for compiling a Node.js module and its dependencies into one file. Developers can use it when publishing npm packages or preparing application code for serverless environments. The project aims for builds that need little configuration and includes TypeScript support; it also accepts Node.js programs and npm modules. Supported inputs include TypeScript, binary addons, and dynamic requires. Build options include minification, source maps, watched builds, external modules, and ECMAScript target selection. JavaScript files in a `type: module` package boundary and `.mjs` inputs produce ES module output automatically. ncc can also be called from Node.js programs, with options such as caching and asset builds. Install it from npm as `@vercel/ncc`; the global install command is `npm i -g @vercel/ncc`. TypeScript `.ts` and `.tsx` inputs require a `tsconfig.json`. Dynamically loaded assets that cannot be analyzed statically may not work correctly. ncc is free under the MIT license.
Who it suits
ncc suits Node.js developers who want to bundle modules for npm distribution or serverless environments. It is available for Linux and supports TypeScript, but `.ts` and `.tsx` inputs need a `tsconfig.json`.
Good to know, and what to watch
- Free, MIT-licensed CLI.
- Supports TypeScript and binary addons.
- Offers minification, source maps, and watched builds.
- Can be used programmatically from Node.js.
- Dynamically loaded assets may not work correctly.
- TypeScript inputs require a `tsconfig.json`.
Plans
Every plan and price@vercel/ncc
Free plan
The verdict
ncc provides a focused way to compile Node.js modules and dependencies into a single file, with command-line and programmatic options. Check whether your assets can be statically analyzed before relying on the bundle.
What the maker publishes
- Build options
- The CLI supports minification, source maps, watched builds, external modules, and ECMAScript target selection. source
- Build options
- The CLI offers minification, source maps, asset builds, externals, watch mode, and ECMAScript target selection. source
- Compatibility caveat
- Dynamically loaded assets that cannot be statically analyzed may not work correctly. source
- Compatibility caveat
- Dynamically loaded assets that cannot be statically analyzed may not work correctly because files and assets are relocated using a static evaluator. source
- Configuration
- The design goals include zero configuration and built-in TypeScript support. source
- Design goals
- Its design goals include zero configuration, built-in TypeScript support, and support for Node.js programs and npm modules. source
- Distribution
- The README directs users to install ncc from npm as `@vercel/ncc`. source
- Install
- The README gives `npm i -g @vercel/ncc` as the global installation command. source
- Installation
- The README gives `npm i -g @vercel/ncc` as the installation command. source
- Integrations
- The package support guide gives configuration examples for Sequelize with MariaDB and for `@google-cloud/vision` with `google-proto-files`. source
- Intended uses
- The project lists publishing minimal npm packages and shipping relevant app code to serverless environments as motivations. source
- License
- GitHub identifies the repository as MIT licensed. source
- License
- The repository lists an MIT license. source
- Module formats
- When building an `.mjs` file or a `.js` file inside a `type: module` package boundary, ncc automatically creates ES module output. source
- Node.js scope
- The project supports Node.js programs as input and output. source
- Package integration examples
- The package support guide gives configuration examples for Sequelize with MariaDB and `@google-cloud/vision`. source
- Package-specific setup
- The project says some packages may need extra options to work better with ncc static analysis and directs users to its issue queue for troubleshooting. source
- Programmatic use
- The package can be called programmatically from Node.js with options including caching, externals, minification, source maps, and asset builds. source
- Programmatic use
- The README documents using ncc from Node.js with options for caching, externals, minification, source maps, asset builds, and watch mode. source
- Purpose
- ncc is a CLI that compiles a Node.js module and its dependencies into a single file. source
- Support channel
- The package support guide suggests searching the issue queue or posting an issue when a package does not run with ncc. source
- Supported inputs
- It supports TypeScript, binary addons, and dynamic requires. source
- TypeScript requirement
- For `.ts` or `.tsx` inputs, the README says a `tsconfig.json` file is necessary. source
- Use cases
- The project lists publishing minimal npm packages and shipping only relevant app code to serverless environments as motivations. source
Checked against the maker's pages on 9 Oct 2026.