Skip to content

docs: document catalog: protocol for workspace dependencies (2.8)#3096

Merged
bartlomieju merged 1 commit into
denoland:2.8from
lunadogbot:docs/2.8-catalog-protocol
May 20, 2026
Merged

docs: document catalog: protocol for workspace dependencies (2.8)#3096
bartlomieju merged 1 commit into
denoland:2.8from
lunadogbot:docs/2.8-catalog-protocol

Conversation

@lunadogbot
Copy link
Copy Markdown
Contributor

Summary

Documents the new catalog: protocol shipping in Deno 2.8 (denoland/deno#32947). Catalogs let a workspace root declare shared dependency versions in one place; members reference them with \"pkg\": \"catalog:\" or \"pkg\": \"catalog:<name>\".

  • Adds a new "Centralized dependency versions with catalog:" section to runtime/fundamentals/workspaces.md.
  • Covers the default catalog, named catalogs (catalogs), and catalogs declared in package.json.
  • Notes the precedence rule when both deno.json and package.json define catalogs (package.json wins, no merging) and the root-only restriction.

Test plan

  • deno task serve — workspaces page renders, new section sits cleanly between "Sharing and managing dependencies" and "Using workspace protocol in package.json".
  • deno fmt — clean.

@crowlKats crowlKats changed the base branch from main to 2.8 May 5, 2026 11:39
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. package.json (or deno.json) overstates where catalog: can be used. denoland/deno#32947 adds PackageJsonDepValue::Catalog, and the config schema describes catalogs as being for workspace member package.json files; catalog: is not an import-map / deno.json dependency protocol. Please remove (or deno.json) or explicitly say only package.json dependencies reference catalogs, while root deno.json / package.json can declare them.
  • nit: last_modified: 2025-11-04 should be bumped for this content addition.

@bartlomieju bartlomieju force-pushed the docs/2.8-catalog-protocol branch from 1d205ee to 0620b97 Compare May 20, 2026 13:25
@bartlomieju bartlomieju merged commit 1aae87a into denoland:2.8 May 20, 2026
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.

3 participants