feat(cli): Add preview shortcuts (#14574)

Jacob Lamb · ematipico · sarah11918 · web-flow · commit 4356485b0f70 · 2025-11-19T16:32:04.000+01:00
Co-authored-by: Emanuele Stoppa &lt;my.burning@gmail.com&gt;
Co-authored-by: Sarah Rainsberger &lt;5098874+sarah11918@users.noreply.github.com&gt;
Co-authored-by: Florian Lefebvre &lt;contact@florian-lefebvre.dev&gt;
diff --git a/.changeset/real-ends-switch.md b/.changeset/real-ends-switch.md
@@ -0,0 +1,9 @@
+---
+'astro': minor
+---
+
+Adds new CLI shortcuts available when running `astro preview`:
+
+- `o` + `enter`: open the site in your browser
+- `q` + `enter`: quit the preview
+- `h` + `enter`: print all available shortcuts
diff --git a/packages/astro/src/core/preview/static-preview-server.ts b/packages/astro/src/core/preview/static-preview-server.ts
@@ -1,6 +1,7 @@
 import type http from 'node:http';
 import { performance } from 'node:perf_hooks';
 import { fileURLToPath } from 'node:url';
+import type * as vite from 'vite';
 import { preview, type PreviewServer as VitePreviewServer } from 'vite';
 import type { AstroSettings } from '../../types/astro.js';
 import type { Logger } from '../logger/core.js';
@@ -47,6 +48,20 @@ export default async function createStaticPreviewServer(
 		throw err;
 	}
 
+	// Set up shortcuts
+
+	const customShortcuts: Array<vite.CLIShortcut> = [
+		// Disable default Vite shortcuts that don't work well with Astro
+		{ key: 'r', description: '' },
+		{ key: 'u', description: '' },
+		{ key: 'c', description: '' },
+		{ key: 's', description: '' },
+	];
+
+	previewServer.bindCLIShortcuts({
+		customShortcuts,
+	});
+
 	// Log server start URLs
 	logger.info(
 		'SKIP_FORMAT',
