From 185e83ab12b4e89e150731fa1118440046bc8f40 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bartek=20Iwa=C5=84czuk?= <biwanczuk@gmail.com>
Date: Thu, 18 Jun 2026 11:42:47 +0200
Subject: [PATCH 1/6] docs: add Deno to the package manager tabs

---
 .../PackageManagerCommand.astro               |  2 +-
 src/utils/package-manager.ts                  | 20 +++++++++++++++----
 2 files changed, 17 insertions(+), 5 deletions(-)

diff --git a/src/components/patterns/PackageManagerCommand/PackageManagerCommand.astro b/src/components/patterns/PackageManagerCommand/PackageManagerCommand.astro
index d19ad981a2..02e3013d57 100644
--- a/src/components/patterns/PackageManagerCommand/PackageManagerCommand.astro
+++ b/src/components/patterns/PackageManagerCommand/PackageManagerCommand.astro
@@ -68,7 +68,7 @@ const defaultManager = managers[0];
 
 <script>
   const STORAGE_KEY = 'expressjs:package-manager';
-  const MANAGERS = ['npm', 'yarn', 'pnpm', 'bun'];
+  const MANAGERS = ['npm', 'yarn', 'pnpm', 'bun', 'deno'];
 
   function applyManager(pm: string) {
     document.querySelectorAll<HTMLElement>('[data-pm-command]').forEach((root) => {
diff --git a/src/utils/package-manager.ts b/src/utils/package-manager.ts
index 634f4c62ae..d0b36c7feb 100644
--- a/src/utils/package-manager.ts
+++ b/src/utils/package-manager.ts
@@ -2,7 +2,7 @@
  * Package manager helpers.
  *
  * Converts an `npm`/`npx` command into the equivalent command for the other
- * supported package managers (Yarn, pnpm, Bun) so docs can show a single,
+ * supported package managers (Yarn, pnpm, Bun, Deno) so docs can show a single,
  * authored npm command and let readers pick their tool of choice.
  *
  * Authors write the npm command they already know; everything else is derived.
@@ -10,7 +10,7 @@
  * <pkg> --no-save`) should stay as a plain fenced code block instead.
  */
 
-export const PACKAGE_MANAGERS = ['npm', 'yarn', 'pnpm', 'bun'] as const;
+export const PACKAGE_MANAGERS = ['npm', 'yarn', 'pnpm', 'bun', 'deno'] as const;
 
 export type PackageManager = (typeof PACKAGE_MANAGERS)[number];
 
@@ -19,6 +19,7 @@ export const PACKAGE_MANAGER_LABELS: Record<PackageManager, string> = {
   yarn: 'yarn',
   pnpm: 'pnpm',
   bun: 'bun',
+  deno: 'deno',
 };
 
 /**
@@ -38,6 +39,7 @@ const sameForAll = (command: string): CommandMap => ({
   yarn: command,
   pnpm: command,
   bun: command,
+  deno: command,
 });
 
 const join = (...parts: (string | false | undefined)[]): string =>
@@ -52,7 +54,7 @@ export function convertPackageManagerCommand(command: string): CommandMap {
   const tokens = command.trim().split(/\s+/);
   const [bin, sub, ...rest] = tokens;
 
-  // npx codemod@latest ... -> yarn/pnpm dlx, bunx
+  // npx codemod@latest ... -> yarn/pnpm dlx, bunx, deno run -A npm:
   if (bin === 'npx') {
     const exec = tokens.slice(1).join(' ');
     return {
@@ -60,6 +62,7 @@ export function convertPackageManagerCommand(command: string): CommandMap {
       yarn: join('yarn dlx', exec),
       pnpm: join('pnpm dlx', exec),
       bun: join('bunx', exec),
+      deno: exec ? join('deno run -A', `npm:${exec}`) : null,
     };
   }
 
@@ -73,7 +76,7 @@ export function convertPackageManagerCommand(command: string): CommandMap {
       const packages = rest.filter((t) => !t.startsWith('-'));
       const isDev = flags.some((f) => DEV_FLAGS.has(f));
       const isGlobal = flags.some((f) => GLOBAL_FLAGS.has(f));
-      // `--no-save` only exists on npm and Bun; Yarn and pnpm have no equivalent.
+      // `--no-save` only exists on npm and Bun; Yarn, pnpm and Deno have no equivalent.
       const hasNoSave = flags.includes('--no-save');
       const extra = flags.filter(
         (f) => !DEV_FLAGS.has(f) && !GLOBAL_FLAGS.has(f) && !SAVE_FLAGS.has(f)
@@ -88,6 +91,7 @@ export function convertPackageManagerCommand(command: string): CommandMap {
           yarn: join('yarn install', extras),
           pnpm: join('pnpm install', extras),
           bun: join('bun install', extras),
+          deno: join('deno install', extras),
         };
       }
 
@@ -102,6 +106,9 @@ export function convertPackageManagerCommand(command: string): CommandMap {
           ? null
           : join('pnpm add', isDev && '--save-dev', isGlobal && '--global', pkgs, extras),
         bun: join('bun add', isDev && '--dev', isGlobal && '--global', pkgs, extras),
+        // Deno adds to deno.json/package.json; it has no `--no-save`, and global
+        // tool installs use a different verb (`deno install -g`), so skip those.
+        deno: hasNoSave || isGlobal ? null : join('deno add', isDev && '--dev', pkgs, extras),
       };
     }
 
@@ -117,6 +124,7 @@ export function convertPackageManagerCommand(command: string): CommandMap {
         yarn: isGlobal ? join('yarn global remove', pkgs) : join('yarn remove', pkgs),
         pnpm: join('pnpm remove', isGlobal && '--global', pkgs),
         bun: join('bun remove', isGlobal && '--global', pkgs),
+        deno: isGlobal ? null : join('deno remove', pkgs),
       };
     }
 
@@ -130,6 +138,7 @@ export function convertPackageManagerCommand(command: string): CommandMap {
           yarn: join('yarn init', args),
           pnpm: join('pnpm init', args),
           bun: join('bun init', args),
+          deno: join('deno init', args),
         };
       }
       return {
@@ -137,6 +146,8 @@ export function convertPackageManagerCommand(command: string): CommandMap {
         yarn: join('yarn create', args),
         pnpm: join('pnpm create', args),
         bun: join('bun create', args),
+        // `npm create <starter>` has no first-class Deno equivalent.
+        deno: null,
       };
     }
 
@@ -147,6 +158,7 @@ export function convertPackageManagerCommand(command: string): CommandMap {
         yarn: join('yarn', args),
         pnpm: join('pnpm', args),
         bun: join('bun run', args),
+        deno: join('deno task', args),
       };
     }
 

From 4c753ee070df7c59efb4df42ed86155795b8ae5d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bartek=20Iwa=C5=84czuk?= <biwanczuk@gmail.com>
Date: Thu, 18 Jun 2026 12:56:25 +0200
Subject: [PATCH 2/6] Use deno x and deno create --npm for exec/create mappings

- npx <pkg> -> deno x <pkg> (was deno run -A npm:<pkg>)
- npm create <starter> -> deno create --npm <starter> (was omitted)
---
 src/utils/package-manager.ts | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/src/utils/package-manager.ts b/src/utils/package-manager.ts
index d0b36c7feb..d6bd529878 100644
--- a/src/utils/package-manager.ts
+++ b/src/utils/package-manager.ts
@@ -54,7 +54,7 @@ export function convertPackageManagerCommand(command: string): CommandMap {
   const tokens = command.trim().split(/\s+/);
   const [bin, sub, ...rest] = tokens;
 
-  // npx codemod@latest ... -> yarn/pnpm dlx, bunx, deno run -A npm:
+  // npx codemod@latest ... -> yarn/pnpm dlx, bunx, deno x
   if (bin === 'npx') {
     const exec = tokens.slice(1).join(' ');
     return {
@@ -62,7 +62,7 @@ export function convertPackageManagerCommand(command: string): CommandMap {
       yarn: join('yarn dlx', exec),
       pnpm: join('pnpm dlx', exec),
       bun: join('bunx', exec),
-      deno: exec ? join('deno run -A', `npm:${exec}`) : null,
+      deno: exec ? join('deno x', exec) : null,
     };
   }
 
@@ -146,8 +146,7 @@ export function convertPackageManagerCommand(command: string): CommandMap {
         yarn: join('yarn create', args),
         pnpm: join('pnpm create', args),
         bun: join('bun create', args),
-        // `npm create <starter>` has no first-class Deno equivalent.
-        deno: null,
+        deno: join('deno create --npm', args),
       };
     }
 

From 70945e52fa126cc7496e481578d35e714f69db67 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bartek=20Iwa=C5=84czuk?= <biwanczuk@gmail.com>
Date: Thu, 18 Jun 2026 13:06:19 +0200
Subject: [PATCH 3/6] Address review: deno install -g for global, simplify npx
 mapping

- Use chained ternary like pnpm/bun; global installs -> deno install -g <pkg>
  (deno add is an alias of deno install), instead of returning null
- Drop the unnecessary exec ? ... : null conditional on the deno x mapping
---
 src/utils/package-manager.ts | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/src/utils/package-manager.ts b/src/utils/package-manager.ts
index d6bd529878..aa229f4d90 100644
--- a/src/utils/package-manager.ts
+++ b/src/utils/package-manager.ts
@@ -62,7 +62,7 @@ export function convertPackageManagerCommand(command: string): CommandMap {
       yarn: join('yarn dlx', exec),
       pnpm: join('pnpm dlx', exec),
       bun: join('bunx', exec),
-      deno: exec ? join('deno x', exec) : null,
+      deno: join('deno x', exec),
     };
   }
 
@@ -106,9 +106,11 @@ export function convertPackageManagerCommand(command: string): CommandMap {
           ? null
           : join('pnpm add', isDev && '--save-dev', isGlobal && '--global', pkgs, extras),
         bun: join('bun add', isDev && '--dev', isGlobal && '--global', pkgs, extras),
-        // Deno adds to deno.json/package.json; it has no `--no-save`, and global
-        // tool installs use a different verb (`deno install -g`), so skip those.
-        deno: hasNoSave || isGlobal ? null : join('deno add', isDev && '--dev', pkgs, extras),
+        // `deno add` is an alias of `deno install`; use `deno install -g` for
+        // global installs. Deno has no `--no-save` equivalent.
+        deno: hasNoSave
+          ? null
+          : join(isGlobal ? 'deno install -g' : 'deno add', isDev && '--dev', pkgs, extras),
       };
     }
 

From aa20426d0fdc3fb03d1d5f4a05e65ca04660d323 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bartek=20Iwa=C5=84czuk?= <biwanczuk@gmail.com>
Date: Thu, 18 Jun 2026 13:06:42 +0200
Subject: [PATCH 4/6] Drop comment on deno install case for consistency with
 other managers

---
 src/utils/package-manager.ts | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/utils/package-manager.ts b/src/utils/package-manager.ts
index aa229f4d90..6c24825fe0 100644
--- a/src/utils/package-manager.ts
+++ b/src/utils/package-manager.ts
@@ -106,8 +106,6 @@ export function convertPackageManagerCommand(command: string): CommandMap {
           ? null
           : join('pnpm add', isDev && '--save-dev', isGlobal && '--global', pkgs, extras),
         bun: join('bun add', isDev && '--dev', isGlobal && '--global', pkgs, extras),
-        // `deno add` is an alias of `deno install`; use `deno install -g` for
-        // global installs. Deno has no `--no-save` equivalent.
         deno: hasNoSave
           ? null
           : join(isGlobal ? 'deno install -g' : 'deno add', isDev && '--dev', pkgs, extras),

From 5a60f340997d3abfee00159adeb776ffbe874d6c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bartek=20Iwa=C5=84czuk?= <biwanczuk@gmail.com>
Date: Thu, 18 Jun 2026 17:42:36 +0200
Subject: [PATCH 5/6] Address review: map global uninstall to deno uninstall
 --global

---
 src/utils/package-manager.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/utils/package-manager.ts b/src/utils/package-manager.ts
index 6c24825fe0..aa4394a230 100644
--- a/src/utils/package-manager.ts
+++ b/src/utils/package-manager.ts
@@ -124,7 +124,7 @@ export function convertPackageManagerCommand(command: string): CommandMap {
         yarn: isGlobal ? join('yarn global remove', pkgs) : join('yarn remove', pkgs),
         pnpm: join('pnpm remove', isGlobal && '--global', pkgs),
         bun: join('bun remove', isGlobal && '--global', pkgs),
-        deno: isGlobal ? null : join('deno remove', pkgs),
+        deno: isGlobal ? join('deno uninstall --global', pkgs) : join('deno remove', pkgs),
       };
     }
 

From 6d9e576f8231945a643e62e9832b105ea156aeba Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bartek=20Iwa=C5=84czuk?= <biwanczuk@gmail.com>
Date: Thu, 18 Jun 2026 17:45:36 +0200
Subject: [PATCH 6/6] Use deno uninstall for removals (handles --global)

---
 src/utils/package-manager.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/utils/package-manager.ts b/src/utils/package-manager.ts
index aa4394a230..55943c2dc3 100644
--- a/src/utils/package-manager.ts
+++ b/src/utils/package-manager.ts
@@ -124,7 +124,7 @@ export function convertPackageManagerCommand(command: string): CommandMap {
         yarn: isGlobal ? join('yarn global remove', pkgs) : join('yarn remove', pkgs),
         pnpm: join('pnpm remove', isGlobal && '--global', pkgs),
         bun: join('bun remove', isGlobal && '--global', pkgs),
-        deno: isGlobal ? join('deno uninstall --global', pkgs) : join('deno remove', pkgs),
+        deno: join('deno uninstall', isGlobal && '--global', pkgs),
       };
     }