From b9d5bb069bdb239ca3223c39bf968afda03b8614 Mon Sep 17 00:00:00 2001
From: Jo Franchetti <jofranchetti@gmail.com>
Date: Fri, 16 Jan 2026 16:22:30 +0000
Subject: [PATCH 1/2] update expose http docs

---
 sandboxes/expose_http.md | 81 +++++++++++++++++++++++++++++++---------
 1 file changed, 64 insertions(+), 17 deletions(-)

diff --git a/sandboxes/expose_http.md b/sandboxes/expose_http.md
index 7c037bb79..d8359f2cc 100644
--- a/sandboxes/expose_http.md
+++ b/sandboxes/expose_http.md
@@ -6,16 +6,36 @@ description: "Learn how to expose HTTP endpoints from Deno Sandboxes, enabling y
 You can run dev servers, preview apps, webhook receivers, or framework CLIs on
 any port and publish them instantly to a secure, random HTTPS URL.
 
-```tsx
+Import the `Sandbox` class from the `@deno/sandbox` module and pass a port to
+the Sandbox.create() method:
+
+```tsx title="main.ts"
+import { Sandbox } from "@deno/sandbox";
+
+await using sandbox = await Sandbox.create({ port: 8000 });
+console.log(sandbox.id);
+
 await sandbox.fs.writeTextFile(
-  "server.js",
-  "Deno.serve(() => new Response('Hello from Sandboxes'));",
+  "main.ts",
+  "export default { fetch: () => new Response('hi') }",
 );
-const runtime = await sandbox.deno.run({ entrypoint: "server.js" });
-const publicUrl = await sandbox.exposeHttp({ port: 8000 });
-console.log(publicUrl); // https://<random>.sandbox.deno.net
+
+const p = await sandbox.sh`deno serve --watch main.ts`.spawn();
+
+console.log("deno now listening on", sandbox.url);
+
+await p.output();
+```
+
+This can then be run by setting your Deploy token and executing:
+
+```sh
+deno run -A --watch main.ts
 ```
 
+Setting the `--watch` flag allows the sandbox to restart automatically when code
+changes are detected, for a low-fi hot-reload experience.
+
 The URL stays live for the sandbox lifetime, making it perfect for short-lived
 QA links or agent generated previews.
 
@@ -36,17 +56,25 @@ with TLS automatically configured.
 
 All requests to a sandbox's URL will send HTTP traffic to the sandbox.
 
-## Step-by-step
+## exposeHttp() usage
+
+Sandboxes also support exposing HTTP on-demand via the `exposeHttp()` method:
+
+```ts
+const previewUrl = await sandbox.exposeHttp({ port: 8000 });
+console.log(`Preview ready at ${previewUrl}`);
+```
+
+This is useful when you want to start a sandbox without HTTP exposure, then
+expose it later (for example, after some initialization or build steps).
+
+:::info Security
 
-1. **Start a server inside the sandbox.** Listen on any unprivileged port (e.g.,
-   `3000`, `8080`).
-2. **Expose the port:** `const url = await sandbox.exposeHttp({ port: 3000 });`
-3. **Share or fetch from the URL.** Requests enter through Deploy’s global edge
-   and are tunneled directly to your sandbox.
+When you call this API, the target HTTP service will be PUBLICLY EXPOSED WITHOUT
+AUTHENTICATION. Anyone with knowledge of the public domain will be able to send
+requests to the exposed service.
 
-Multiple ports can be exposed simultaneously by calling `exposeHttp()` for each
-port. You can also re-use the same exposed URL after restarting your server, as
-long as the sandbox itself remains alive.
+:::
 
 ## Observing traffic
 
@@ -75,6 +103,10 @@ traces. Use the dashboard to:
 ```tsx
 import { Sandbox } from "@deno/sandbox";
 
+export function add(a: number, b: number): number {
+  return a + b;
+}
+
 await using sandbox = await Sandbox.create();
 
 // Install dependencies
@@ -94,6 +126,19 @@ await sandbox.fs.writeTextFile(
     2,
   ),
 );
+await sandbox.fs.mkdir("pages", { recursive: true });
+await sandbox.fs.writeTextFile(
+  "pages/index.js",
+  `export default function Home() {
+  return (
+    <main style={{ fontFamily: "system-ui", padding: "2rem" }}>
+      <h1>Next.js sandbox</h1>
+      <p>Edit pages/index.js to get started.</p>
+    </main>
+  );
+}
+`,
+);
 await sandbox.sh`npm install`;
 
 // Start the dev server
@@ -110,5 +155,7 @@ console.log(`Preview ready at ${previewUrl}`);
 await server.status; // keep running until the process exits
 ```
 
-This pattern lets agents or developers spin up high-fidelity previews, share
-them for feedback, and tear everything down with a single `Ctrl+C`.
+Using Deno Sandbox in this way allows you to spin up full-featured framework
+development servers with minimal code, useful for agents or developers who need
+to spin up high-fidelity previews, share them for feedback, and tear everything
+down with a single `Ctrl+C`.

From efa880458e50abdd377d3399d16b728ee03a8902 Mon Sep 17 00:00:00 2001
From: Jo Franchetti <jofranchetti@gmail.com>
Date: Mon, 19 Jan 2026 09:33:14 +0000
Subject: [PATCH 2/2] Remove add function from expose_http.md

Removed the add function from expose_http.md.
---
 sandboxes/expose_http.md | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/sandboxes/expose_http.md b/sandboxes/expose_http.md
index d8359f2cc..e62c62189 100644
--- a/sandboxes/expose_http.md
+++ b/sandboxes/expose_http.md
@@ -103,10 +103,6 @@ traces. Use the dashboard to:
 ```tsx
 import { Sandbox } from "@deno/sandbox";
 
-export function add(a: number, b: number): number {
-  return a + b;
-}
-
 await using sandbox = await Sandbox.create();
 
 // Install dependencies