How utoo Redefines npm: Rust‑Powered Performance and Full Compatibility

Background

The npm registry is the largest software‑package ecosystem, but growing project size and dependency complexity cause long install times, large download footprints (e.g., >30 MB for an Ant Design install) and high CPU usage during dependency resolution. Existing alternatives such as pnpm and bun improve performance but introduce compatibility trade‑offs that hinder large‑scale adoption.

utoo is designed with two core goals: extreme performance and complete npm compatibility . It is implemented in Rust and integrates tightly with the npmmirror private protocol, providing a zero‑configuration, fastest npm client in mainland China while remaining a drop‑in replacement for npm.

Performance Benchmarks

Cold‑start install of an Ant Design project on an M2 Pro (8‑core, 32 GB RAM, 300 M wired network): npm 76 s → utoo 1 s (≈ 76× faster).

Full‑cache install: npm 5 s → utoo 0.3 s.

Cache size (manifest only): npm > 600 MB → utoo 3.4 MB (two orders of magnitude reduction).

Real‑World Migration Cases

ant‑design‑pro (bun → utoo): Windows install time reduced from 286 s to 40 s (≈ 7.2× faster).

eggjs (pnpm → utoo): across Ubuntu, macOS and Windows, utoo is 2.6×–3.6× faster than pnpm.

ant‑design CI slimming : merging two install steps reduced total CI time from 48 s to 30 s.

ant‑design/x monorepo : the official documentation now recommends utoo as the default package manager.

Compatibility Strategy

Generates standard package-lock.json v3 files, enabling seamless switching between npm and utoo.

Preserves npm’s hoisting‑based node_modules layout.

Fully implements npm lifecycle scripts (preinstall, install, postinstall, etc.) and automatically detects binding.gyp for native builds.

Injects standard environment variables ( npm_lifecycle_event, INIT_CWD) and ensures node_modules/.bin is on PATH.

Provides a migration command ut deps --from pnpm to convert pnpm-workspace.yaml and related config to npm/utoo format.

Technical Implementation

Core Rust crates : pm (CLI entry point and installation orchestration) and ruborist (dependency‑graph construction and version resolution, analogous to npm’s arborist). ruborist can also be compiled to WebAssembly for in‑browser use.

Four key techniques :

Ruborist dependency engine : two‑phase parsing (BFS graph construction + parallel version resolution) and a three‑level cache—process‑wide memory cache ( Arc<RwLock<HashMap>>), on‑disk cache under ~/.utoo/cache/ (compressed manifests ~3.4 MB), and HTTP/2 network requests with exponential backoff.

Pipeline parallel installation : replaces the traditional sequential “resolve → download → install” flow with a graph where dependency resolution, download workers and clone workers run concurrently, allowing “install while resolving”.

OnceMap deduplication : ensures that when multiple async tasks request the same package, only the first performs the download while others await the result via a Notify mechanism, eliminating redundant I/O.

Deep npmmirror integration : automatically uses the npmmirror registry in Chinese network environments, leveraging a private semver‑request endpoint and abbreviated manifests to shrink payloads, and transparently redirects binary packages (e.g., node‑sass, sharp, esbuild) to domestic mirrors without any .npmrc configuration.

Quick Start

# Install via npm
npm install -g utoo

# Or one‑click script
curl -fsSL https://utoo.land/install | bash

# Common commands
ut install                # install project dependencies
ut add lodash             # add a dependency
ut uninstall lodash       # remove a dependency
ut deps                   # generate/update package-lock.json
utx create-react-app my-app  # run remote CLI (similar to npx)
ut run build              # execute package.json scripts

CI/CD Integration

name: CI
on: [push, pull_request]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
      - uses: utooland/setup-utoo@v1
      - run: ut install
      - run: ut run build
      - run: ut run test

The utooland/setup-utoo@v1 action detects the platform and installs the appropriate utoo binary for macOS (Intel/Apple Silicon), Linux (x64/ARM64/musl) and Windows.

References

GitHub repository: https://github.com/utooland/utoo

Ant Design Pro migration PR #11639: https://github.com/ant-design/ant-design-pro/pull/11639

eggjs migration PR #5830: https://github.com/eggjs/egg/pull/5830

ant-design CI slimming PR #55076: https://github.com/ant-design/ant-design/pull/55076

ant-design/x monorepo recommendation PR #823: https://github.com/ant-design/x/pull/823