Merge remote-tracking branch 'origin/main' into worktree-agent-ae03f22321b77ddba

Author: bartlomieju

js/tabs.ts

@@ -79,6 +79,15 @@ for (const tabGroup of document.querySelectorAll<HTMLElement>(".deno-tabs")) {
   const storedTabId = localStorage.getItem(`deno-tab-${groupId}`);
   if (storedTabId) {
     document.dispatchEvent(new GroupSelectEvent(groupId, storedTabId));
+  } else if (groupId === "operating-systems") {
+    const ua = navigator.userAgent;
+    let detected: string | null = null;
+    if (/Mac/i.test(ua)) detected = "mac";
+    else if (/Win/i.test(ua)) detected = "windows";
+    else if (/Linux/i.test(ua)) detected = "linux";
+    if (detected) {
+      document.dispatchEvent(new GroupSelectEvent(groupId, detected));
+    }
   }
 
   const anyTabActive = Array.from(tabs).some((tab) =>

runtime/getting_started/installation.md

@@ -8,18 +8,16 @@ oldUrl:
   - /runtime/fundamentals/installation
 ---
 
-Deno works on macOS, Linux, and Windows. Deno is a single binary executable. It
-has no external dependencies. On macOS, both M1 (arm64) and Intel (x64)
-executables are provided. On Windows, both ARM64 and x64 are supported. On
-Linux, only x64 is supported.
+Deno is a single binary executable with no external dependencies. It runs on
+macOS, Linux, and Windows, on both x64 and arm64 architectures.
 
 ## Download and install
 
 [deno_install](https://github.com/denoland/deno_install) provides convenience
 scripts to download and install the binary.
 
 <deno-tabs group-id="operating-systems">
-<deno-tab value="mac" label="macOS" default>
+<deno-tab value="linux" label="Linux">
 
 Using Shell:
 
@@ -33,52 +31,43 @@ Using [npm](https://npmjs.com/package/deno):
 npm install -g deno
 ```
 
-> <small>The startup time of the Deno command gets affected if it's installed
-> via npm. We recommend the shell install script for better performance.</small>
-
-Using [Homebrew](https://formulae.brew.sh/formula/deno):
+Using [Nix](https://nixos.org/download.html):
 
 ```shell
-brew install deno
+nix-shell -p deno
 ```
 
-Using [MacPorts](https://ports.macports.org/port/deno/):
+</deno-tab>
+<deno-tab value="mac" label="macOS" default>
+
+Using Shell:
 
 ```shell
-sudo port install deno
+curl -fsSL https://deno.land/install.sh | sh
 ```
 
-Using [Nix](https://nixos.org/download.html):
+Using [npm](https://npmjs.com/package/deno):
 
 ```shell
-nix-shell -p deno
+npm install -g deno
 ```
 
-Using [asdf](https://asdf-vm.com/):
+Using [Homebrew](https://formulae.brew.sh/formula/deno):
 
 ```shell
-asdf plugin add deno https://github.com/asdf-community/asdf-deno.git
-
-# Download and install the latest version of Deno
-asdf install deno latest
-
-# To set as the default version of Deno globally
-asdf set -u deno latest
-
-# To set as the default version of Deno locally (current project only)
-asdf set deno latest
+brew install deno
 ```
 
-Using [vfox](https://vfox.dev/):
+Using [MacPorts](https://ports.macports.org/port/deno/):
 
 ```shell
-vfox add deno
+sudo port install deno
+```
 
-# Download and install the latest version of Deno
-vfox install deno@latest
+Using [Nix](https://nixos.org/download.html):
 
-# To set the version of Deno globally
-vfox use --global deno
+```shell
+nix-shell -p deno
 ```
 
 </deno-tab>
@@ -100,10 +89,6 @@ Using [npm](https://npmjs.com/package/deno):
 npm install -g deno
 ```
 
-> <small>The startup time of the Deno command gets affected if it's installed
-> via npm. We recommend the PowerShell install script for better
-> performance.</small>
-
 Using [Scoop](https://scoop.sh/):
 
 ```shell
@@ -122,41 +107,16 @@ Using [Winget](https://github.com/microsoft/winget-cli):
 winget install DenoLand.Deno
 ```
 
-Using [vfox](https://vfox.dev/):
-
-```shell
-vfox add deno
-
-# Download and install the latest version of Deno
-vfox install deno@latest
-
-# To set the version of Deno globally
-vfox use --global deno
-```
-
 </deno-tab>
-<deno-tab value="linux" label="Linux">
-
-Using Shell:
-
-```shell
-curl -fsSL https://deno.land/install.sh | sh
-```
-
-Using [npm](https://npmjs.com/package/deno):
-
-```shell
-npm install -g deno
-```
+</deno-tabs>
 
 > <small>The startup time of the Deno command gets affected if it's installed
-> via npm. We recommend the shell install script for better performance.</small>
+> via npm. We recommend the official install script (shell or PowerShell) for
+> better performance.</small>
 
-Using [Nix](https://nixos.org/download.html):
+### Cross-platform package managers
 
-```shell
-nix-shell -p deno
-```
+These version managers work on macOS, Linux, and Windows.
 
 Using [asdf](https://asdf-vm.com/):
 
@@ -185,9 +145,6 @@ vfox install deno@latest
 vfox use --global deno
 ```
 
-</deno-tab>
-</deno-tabs>
-
 You can also build and install from source using
 [Cargo](https://crates.io/crates/deno):
 
@@ -273,6 +230,24 @@ To update a previously installed version of Deno, you can run:
 deno upgrade
 ```
 
+Or using [Homebrew](https://formulae.brew.sh/formula/deno) (macOS):
+
+```shell
+brew upgrade deno
+```
+
+Or using [Scoop](https://scoop.sh/) (Windows):
+
+```shell
+scoop update deno
+```
+
+Or using [Chocolatey](https://chocolatey.org/packages/deno) (Windows):
+
+```shell
+choco upgrade deno
+```
+
 Or using [Winget](https://github.com/microsoft/winget-cli) (Windows):
 
 ```shell
@@ -286,7 +261,7 @@ unzip it, and replace your current executable with it.
 You can also use this utility to install a specific version of Deno:
 
 ```shell
-deno upgrade --version 1.0.1
+deno upgrade --version 2.7.0
 ```
 
 ## Uninstalling
@@ -307,8 +282,10 @@ Then remove the Deno installation directory:
 rm -rf ~/.deno
 ```
 
-Finally, remove the `DENO_INSTALL` export and `PATH` entry from your shell
-config file (`~/.bashrc`, `~/.zshrc`, `~/.config/fish/config.fish`, etc.).
+Finally, remove the line that sources Deno's env file from your shell config
+(`~/.bashrc`, `~/.zshrc`, `~/.profile`, etc.). The shell install script appends
+a line like `. "$HOME/.deno/env"` — delete that line. Fish users should
+additionally remove `~/.config/fish/conf.d/deno.fish`.
 
 </deno-tab>
 <deno-tab value="windows" label="Windows">

runtime/index.md

@@ -1,5 +1,5 @@
 ---
-last_modified: 2025-10-10
+last_modified: 2026-05-28
 title: "Welcome to Deno"
 description: "Learn the basics of Deno, a secure JavaScript, TypeScript, and WebAssembly runtime."
 pagination_next: /runtime/getting_started/first_project/
@@ -17,51 +17,49 @@ oldUrl:
 `dee-no`) is an
 [open source](https://github.com/denoland/deno/blob/main/LICENSE.md) JavaScript,
 TypeScript, and WebAssembly runtime with secure defaults and a great developer
-experience. It's built on [V8](https://v8.dev/),
-[Rust](https://www.rust-lang.org/), and [Tokio](https://tokio.rs/).
+experience.
 
 ## Why Deno?
 
-- Deno is
-  **[TypeScript-ready out of the box](/runtime/fundamentals/typescript/).** Zero
-  config or additional steps necessary.
-- Deno is **[secure by default](/runtime/fundamentals/security/).** Where other
-  runtimes give full access every script they run, Deno allows you to enforce
-  granular permissions.
-- Deno has a **robust built-in toolchain.** Unlike Node or browser JavaScript,
-  Deno includes a [standard library](/runtime/reference/std/), along with a
-  first-party [linter/formatter](/runtime/fundamentals/linting_and_formatting/),
-  [test runner](/runtime/fundamentals/testing/), and more.
-- Deno is **fully compatible with [Node and npm](/runtime/fundamentals/node/).**
-- Deno is **fast and reliable**.
-- **[Deno is open-source](https://github.com/denoland/deno).**
+- **Works with your existing [Node.js projects](/runtime/fundamentals/node/).**
+  Drop Deno into a repo with `package.json` and `node_modules` and it just runs;
+  mix `npm:` imports with native ES modules as you migrate.
+- **Modern module system.** ES modules with URL imports, [JSR](https://jsr.io)
+  for typed packages, and [workspaces](/runtime/fundamentals/workspaces/).
+- **[TypeScript-first](/runtime/fundamentals/typescript/).** Run `.ts` files
+  directly. No `tsc`, no build step, no config.
+- **[Secure by default](/runtime/fundamentals/security/).** Code runs in a
+  sandbox with no file, network, or environment access until you grant it.
+- **A full toolchain, no plumbing.** Built-in
+  [formatter](/runtime/fundamentals/linting_and_formatting/),
+  [linter](/runtime/fundamentals/linting_and_formatting/),
+  [test runner](/runtime/fundamentals/testing/), benchmarking, and
+  [a lot more](/runtime/reference/cli/). No `devDependencies` to wire up.
 
 ## Quick install
 
 Install the Deno runtime on your system using one of the terminal commands
 below:
 
 <deno-tabs group-id="operating-systems">
-<deno-tab value="mac" label="macOS" default>
+<deno-tab value="linux" label="Linux">
 
 ```sh
 curl -fsSL https://deno.land/install.sh | sh
 ```
 
 </deno-tab>
-<deno-tab value="windows" label="Windows">
-
-In Windows PowerShell:
+<deno-tab value="mac" label="macOS" default>
 
-```powershell
-irm https://deno.land/install.ps1 | iex
+```sh
+curl -fsSL https://deno.land/install.sh | sh
 ```
 
 </deno-tab>
-<deno-tab value="linux" label="Linux">
+<deno-tab value="windows" label="Windows">
 
-```sh
-curl -fsSL https://deno.land/install.sh | sh
+```shell title="pwsh"
+irm https://deno.land/install.ps1 | iex
 ```
 
 </deno-tab>
@@ -75,12 +73,13 @@ system path. You can verify the installation by running:
 deno --version
 ```
 
-## First steps
+## Next steps
 
-Deno can run JavaScript and [TypeScript](https://www.typescriptlang.org/) with
-no additional tools or configuration required, all in a secure,
-batteries-included runtime.
+With Deno installed, dive into the rest of the Getting Started guide:
 
 - [Making a Deno project](/runtime/getting_started/first_project/)
 - [Setting up your environment](/runtime/getting_started/setup_your_environment/)
-- [Using the CLI](/runtime/getting_started/command_line_interface)
+- [Using the CLI](/runtime/getting_started/command_line_interface/)
+
+For more installation options (package managers, Docker, building from source),
+see the full [installation guide](/runtime/getting_started/installation/).