Documentation
aube is a Node.js package manager written in Rust. It installs dependencies before you run scripts, shares package files across projects, and preserves supported lockfiles in their original format.
New to aube? Follow getting started to install it and run your first project script.
Set up your project
| I want to… | Read |
|---|---|
| Install or update aube | Installation |
| Try it in an existing project | pnpm, npm, Yarn, or Bun |
| Run builds, tests, and tools | Scripts and binaries |
| Set up a monorepo | Workspaces |
| Pin Node.js | Node runtime switching |
| Configure CI or a container | CI and containers |
Manage dependencies
- Install dependencies: lockfile modes, offline installs, and package layouts.
- Manage dependencies: add, remove, update, dedupe, and prune.
- Lockfiles: supported formats, precedence, and conversion.
- Configuration: choose where a setting belongs and inspect its effective value.
- Registry and authentication: private packages, tokens, proxies, and TLS.
- Publishing: inspect a package, publish it, and manage releases.
Understand the defaults
Dependency scripts require an allow rule or built-in trust. Resolution checks release age and publishing evidence. Security explains which checks warn, which block, and which need an explicit opt-in.
The default layout isolates dependencies. A global content store shares package files, while the global virtual store also shares directory trees for local installs. Read about node_modules, the global virtual store, and the benchmarks.
Look up a detail
- CLI reference: commands, arguments, and flags.
- Settings reference: defaults and supported configuration sources.
- Error and warning codes: stable identifiers and exit codes.
- Troubleshooting: symptoms, diagnostics, and targeted fixes.
- Embedding: Rust, Node-API, and C ABI integration.
To help improve aube, see contributing or start a Discussion.
