Skip to content

docs: document npm tarball installs (2.8)#3077

Open
lunadogbot wants to merge 1 commit into
denoland:2.8from
lunadogbot:docs/2.8-install-tarballs
Open

docs: document npm tarball installs (2.8)#3077
lunadogbot wants to merge 1 commit into
denoland:2.8from
lunadogbot:docs/2.8-install-tarballs

Conversation

@lunadogbot
Copy link
Copy Markdown
Contributor

Summary

Documents the new ability to install npm packages directly from local or remote tarballs in Deno 2.8 (denoland/deno#32945).

  • New "Installing from npm tarballs" section in runtime/reference/cli/install.md with examples for local file, npm-registry URL, and GitHub URL.
  • Documents detection rules (.tgz/.tar.gz local; any non-git+ http URL remote), transitive resolution behavior, lockfile recording, and the local cache directory .deno_tarball_cache/.
  • Calls out the package.json-only limitation as an info admonition.

Test plan

  • deno task serve — section renders, examples readable.

Adds a section to install.md describing direct tarball installs from
local files and any http(s) URL, matching npm/pnpm/bun behavior.
Documents the detection rules (.tgz / .tar.gz local vs. any http(s)
remote), transitive resolution, lockfile integrity recording, and the
package.json-only limitation.

Refs denoland/deno#32945
@crowlKats crowlKats changed the base branch from main to 2.8 May 5, 2026 11:44
Copy link
Copy Markdown
Contributor

@fibibot fibibot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  1. Starting in Deno 2.8, deno install accepts npm tarballs directly documents behavior from denoland/deno#32945, but that runtime PR is still OPEN. Until the implementation lands in the 2.8 branch/current canary, this page would publish a CLI feature that users cannot run yet; please land the runtime change first or mark this PR as blocked on it.
  • nit: last_modified: 2026-03-12 should be bumped for this content addition.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants