Skip to content

aube deploy

  • Usage: aube deploy [FLAGS] <TARGET>

Deploy a workspace package into a target directory with deps inlined

Arguments

<TARGET>

Target directory to deploy into.

Must be empty or not yet exist.

Flags

-D --dev

Install only devDependencies.

Implemented by stripping dependencies and optionalDependencies from the deployed package.json before install runs.

--no-optional

Skip optionalDependencies

-P --prod

Install only production dependencies (default).

Accepted for pnpm compatibility.

--no-prod

Deploy every dependency kind (production + dev + optional).

Opts out of the implicit --prod deploy default. Useful when a deployed package needs its devDependencies at runtime (test harnesses, build-step deploys). Combine with --no-optional to drop optionals while keeping prod + dev. Mutually exclusive with --prod and --dev.

--offline

Fail if any metadata or tarball isn't already in the local cache.

Never hits the network. Useful in multi-stage Dockerfiles where an earlier aube install already populated the store: deploy then reproduces a prod-only tree without re-fetching anything.

--prefer-offline

Prefer cached metadata over revalidation; only hit the network on a miss

--frozen-lockfile

Error if the lockfile drifts from package.json

--no-frozen-lockfile

Always re-resolve, even if the lockfile is up to date

--prefer-frozen-lockfile

Use the lockfile when fresh, re-resolve when stale

--fetch-retries <N>

Number of retry attempts for failed registry fetches.

Overrides fetchRetries / fetch-retries from .npmrc / aube-workspace.yaml when set. Pair with --fetch-timeout to fail fast in scripted test runs.

--fetch-retry-factor <N>

Exponential backoff factor between retry attempts.

Overrides fetchRetryFactor / fetch-retry-factor from .npmrc / aube-workspace.yaml when set. Integer-only — the underlying FetchPolicy.retry_factor is u32. Fractional values like 1.5 are rejected by clap.

--fetch-retry-maxtimeout <MS>

Upper bound (ms) on the computed retry backoff.

Overrides fetchRetryMaxtimeout / fetch-retry-maxtimeout from .npmrc / aube-workspace.yaml when set.

--fetch-retry-mintimeout <MS>

Lower bound (ms) on the computed retry backoff.

Overrides fetchRetryMintimeout / fetch-retry-mintimeout from .npmrc / aube-workspace.yaml when set.

--fetch-timeout <MS>

Per-request HTTP timeout in milliseconds.

Overrides fetchTimeout / fetch-timeout from .npmrc / aube-workspace.yaml when set. Applied via reqwest's .timeout() so it covers headers + body together.

--registry <URL>

Override the default registry URL for this invocation.

Use this npm registry URL for package metadata, tarballs, audit requests, dist-tags, and registry writes.

--disable-global-virtual-store

Force the shared global virtual store off for this invocation.

Packages are materialized inside the project's virtual store instead of symlinked from ~/.cache/aube/virtual-store/.

--enable-global-virtual-store

Force the shared global virtual store on for this invocation.

Overrides CI's default per-project materialization and the disableGlobalVirtualStoreForPackages auto-disable heuristic.

MIT Licenseen.devCopyright © 2026 en.dev