Skip to content

docs: document hoisted node_modules linker mode (2.8)#3097

Open
lunadogbot wants to merge 1 commit into
denoland:2.8from
lunadogbot:docs/2.8-hoisted-linker
Open

docs: document hoisted node_modules linker mode (2.8)#3097
lunadogbot wants to merge 1 commit into
denoland:2.8from
lunadogbot:docs/2.8-hoisted-linker

Conversation

@lunadogbot
Copy link
Copy Markdown
Contributor

Summary

Documents the new hoisted node_modules linker mode shipping in Deno 2.8 (denoland/deno#32788). Adds a sub-section to runtime/fundamentals/node.md that explains the two layouts (isolated default vs. hoisted) and shows how to opt in with nodeModulesLinker: "hoisted" in deno.json or --node-modules-linker=hoisted on the CLI.

  • Side-by-side layout examples (real files vs. symlinks for isolated; nested versions for hoisted).
  • Recommends sticking with isolated mode unless a specific tool needs hoisted, since isolated catches phantom dependencies.

Test plan

  • deno task serve — node.md renders, new section sits between manual node_modules creation and Node-API addons.
  • deno fmt — clean.

@crowlKats crowlKats changed the base branch from main to 2.8 May 5, 2026 11:38
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.

1 participant