# vercel/ncc

Compile a Node.js project into a single file. Supports TypeScript, binary addons, dynamic requires.

Repository: https://github.com/vercel/ncc
Canonical: https://ross.abutalabs.com/products/ncc
Homepage: https://npmjs.com/@vercel/ncc
Language: JavaScript
License: MIT
License Family: permissive
Last push: 2026-08-13T03:20:10+00:00

## Health v2 (maintenance only)
Score: 93/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 97, release rhythm 85, longevity 100
- inputs: {"age_days": 2850, "days_push": 20, "days_rel": 20, "gap_med": 48.0, "n_releases_24m": 7}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 9837, forks 324 (observed 2026-08-28T04:10:37.443487+00:00)

## What it is
A zero-configuration CLI that compiles a Node.js project, including all its dependencies, into a single output file, similar to how gcc compiles binaries. It supports TypeScript out of the box, binary addons, dynamic requires, source maps, minification, and ES module output.

## Use cases
- bundle a node.js project into a single file
- publish minimal packages to npm
- ship only relevant app code to serverless environments
- compile typescript node project without configuring a bundler
- reduce node app bootup time and i/o overhead
- create a standalone executable-style node script

## When to choose
- you want a single-file Node.js bundle with zero bundler configuration
- your project uses TypeScript and you want transpilation built in
- you deploy to serverless environments and want minimal uploaded code
- you want gcc-like compilation experience for Node.js

## When to avoid
- you are bundling for the browser rather than Node.js
- you need fine-grained bundler customization or plugins
- your project relies on patterns incompatible with bundling

## Facets
- artifact type: cli-tool
- maturity: stable
- function: build-tool, cli, developer-tools
- domain: developer-tools, backend
- platform: cli, cross-platform
- tags: bundler, single-file-bundle, typescript, serverless, zero-config, webpack, command-line, nodejs

## Member repositories
- vercel/ncc (main) score 93

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:37.443487+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:20:55.003729+00:00, confidence not recorded.
  - readme: https://github.com/vercel/ncc (fetched 2026-08-28T04:10:37.443487+00:00, sha abfc905f4e7c)
- Data as of 2026-08-30T08:39:29.467469+00:00.