Improve template example documentation

- Use Sandbox.create() consistently in both JS and Python
- Rename 'sbx' variable to 'sandbox' for clarity
- Use timeout parameter instead of explicit kill() calls
- Personalize section headers per template
- Add descriptive prose for each section

Author: beran-t

docs/template/examples/claude-code.mdx

@@ -3,6 +3,11 @@ title: "Claude Code"
 description: "Claude Code Agent available in a sandbox"
 ---
 
+Run Claude Code in a sandbox to execute AI-generated code safely.
+
+## Install Claude Code
+
+Set up Node.js with Claude Code and the tools it needs: curl for fetching, git for repos, and ripgrep for fast code search.
 
 <CodeGroup>
 
@@ -13,7 +18,6 @@ import { Template } from 'e2b'
 export const template = Template()
   .fromNodeImage('24')
   .aptInstall(['curl', 'git', 'ripgrep'])
-  // Claude Code will be available globally as "claude"
   .npmInstall('@anthropic-ai/claude-code@latest', { g: true })
 
 ```
@@ -26,13 +30,15 @@ template = (
     Template()
     .from_node_image("24")
     .apt_install(["curl", "git", "ripgrep"])
-    # Claude Code will be available globally as "claude"
     .npm_install("@anthropic-ai/claude-code@latest", g=True)
 )
 ```
 
 </CodeGroup>
 
+## Build and publish
+
+Build the template. Claude Code itself is lightweight, so minimal resources work fine.
 
 <CodeGroup>
 
@@ -41,7 +47,7 @@ template = (
 import { Template, defaultBuildLogger } from 'e2b'
 import { template as claudeCodeTemplate } from './template'
 
-Template.build(claudeCodeTemplate, 'claude-code', {
+await Template.build(claudeCodeTemplate, 'claude-code', {
   cpuCount: 1,
   memoryMB: 1024,
   onBuildLogs: defaultBuildLogger(),
@@ -62,59 +68,45 @@ Template.build(claudeCodeTemplate, 'claude-code',
 
 </CodeGroup>
 
+## Run AI prompts
+
+Create a sandbox with your Anthropic API key and pipe prompts to Claude. It can write files, run commands, and build whatever you describe.
+
 <CodeGroup>
 
 ```typescript JavaScript & TypeScript
-// sandbox.ts
 import { Sandbox } from 'e2b'
 
-const sbx = await Sandbox.create('claude-code', {
+const sandbox = await Sandbox.create('claude-code', {
+  timeoutMs: 60_000,
   envs: {
     ANTHROPIC_API_KEY: '<your api key>',
   },
 })
 
-console.log('Sandbox created', sbx.sandboxId)
-
-// Print help for Claude Code
-// const result = await sbx.commands.run('claude --help')
-// console.log(result.stdout)
-
-// Run a prompt with Claude Code
-const result = await sbx.commands.run(
+const result = await sandbox.commands.run(
   `echo 'Create a hello world index.html' | claude -p --dangerously-skip-permissions`,
   { timeoutMs: 0 }
 )
-
 console.log(result.stdout)
-
-sbx.kill()
 ```
 
 ```python Python
-# sandbox.py
 from e2b import Sandbox
 
-sbx = Sandbox(
+sandbox = Sandbox.create(
     'claude-code',
+    timeout=60,
     envs={
         'ANTHROPIC_API_KEY': '<your api key>',
     },
 )
-print("Sandbox created", sbx.sandbox_id)
 
-# Print help for Claude Code
-# result = sbx.commands.run('claude --help')
-# print(result.stdout)
-
-# Run a prompt with Claude Code
-result = sbx.commands.run(
+result = sandbox.commands.run(
     "echo 'Create a hello world index.html' | claude -p --dangerously-skip-permissions",
     timeout=0,
 )
 print(result.stdout)
-
-sbx.kill()
 ```
 
 </CodeGroup>

docs/template/examples/desktop.mdx

@@ -3,6 +3,11 @@ title: "Desktop"
 description: "Sandbox with Ubuntu Desktop and VNC access"
 ---
 
+Ubuntu Desktop with XFCE, accessible via noVNC on port 6080.
+
+## Set up the desktop environment
+
+Install XFCE with all the essentials: file manager, text editor, LibreOffice, and more. noVNC provides browser-based access without a native VNC client.
 
 <CodeGroup>
 
@@ -12,7 +17,6 @@ import { Template, waitForPort } from 'e2b'
 
 export const template = Template()
   .fromUbuntuImage('22.04')
-  // Desktop environment and system utilities
   .runCmd([
     'yes | unminimize',
     'apt-get update',
@@ -48,13 +52,11 @@ export const template = Template()
     'apt-get clean',
     'rm -rf /var/lib/apt/lists/*',
   ])
-  // Streaming server setup
   .runCmd([
     'git clone --branch e2b-desktop https://github.com/e2b-dev/noVNC.git /opt/noVNC',
     'ln -s /opt/noVNC/vnc.html /opt/noVNC/index.html',
     'git clone --branch v0.12.0 https://github.com/novnc/websockify /opt/noVNC/utils/websockify',
   ])
-  // Set default terminal
   .runCmd(
     'ln -sf /usr/bin/xfce4-terminal.wrapper /etc/alternatives/x-terminal-emulator'
   )
@@ -71,8 +73,6 @@ from e2b import Template, wait_for_port
 template = (
     Template()
     .from_image("ubuntu:22.04")
-    # Initial system setup and packages
-    # We are not using .apt_install() here because some packages have interactive prompts (keyboard layout setup, etc.)
     .run_cmd(
         [
             "yes | unminimize",
@@ -109,22 +109,18 @@ template = (
             "rm -rf /var/lib/apt/lists/*",
         ]
     )
-    # Setup NoVNC and websockify
     .run_cmd(
         [
             "git clone --branch e2b-desktop https://github.com/e2b-dev/noVNC.git /opt/noVNC",
             "ln -s /opt/noVNC/vnc.html /opt/noVNC/index.html",
             "git clone --branch v0.12.0 https://github.com/novnc/websockify /opt/noVNC/utils/websockify",
         ]
     )
-    # Set default terminal
     .run_cmd(
         "ln -sf /usr/bin/xfce4-terminal.wrapper /etc/alternatives/x-terminal-emulator"
     )
-    # Copy the start command
     .copy("start_command.sh", "/start_command.sh")
     .run_cmd("chmod +x /start_command.sh")
-    # Set start command to launch the desktop environment
     .set_start_cmd("/start_command.sh", wait_for_port(6080))
 )
 ```
@@ -135,27 +131,25 @@ template = (
 ```bash start_command.sh
 #!/bin/bash
 
-# Set display
 export DISPLAY=${DISPLAY:-:0}
 
-# Start Xvfb
 Xvfb $DISPLAY -ac -screen 0 1024x768x24 -nolisten tcp &
 sleep 2
 
-# Start XFCE session
 startxfce4 &
 sleep 5
 
-# Start VNC server
 x11vnc -bg -display $DISPLAY -forever -wait 50 -shared -rfbport 5900 -nopw \
     -noxdamage -noxfixes -nowf -noscr -ping 1 -repeat -speeds lan &
 sleep 2
 
-# Start noVNC server
 cd /opt/noVNC/utils && ./novnc_proxy --vnc localhost:5900 --listen 6080 --web /opt/noVNC --heartbeat 30 &
 sleep 2
 ```
 
+## Build and publish
+
+Build the template. The desktop environment needs more resources than typical sandboxes.
 
 <CodeGroup>
 
@@ -184,3 +178,29 @@ Template.build(desktopTemplate, 'desktop',
 ```
 
 </CodeGroup>
+
+## Connect to the desktop
+
+Create a sandbox and open the URL in your browser. You'll see a full Ubuntu desktop running in your sandbox.
+
+<CodeGroup>
+
+```typescript JavaScript & TypeScript
+import { Sandbox } from 'e2b'
+
+const sandbox = await Sandbox.create('desktop', { timeoutMs: 60_000 })
+
+const url = sandbox.getHost(6080)
+console.log('Desktop available at:', url)
+```
+
+```python Python
+from e2b import Sandbox
+
+sandbox = Sandbox.create('desktop', timeout=60)
+
+url = sandbox.get_host(6080)
+print('Desktop available at:', url)
+```
+
+</CodeGroup>

docs/template/examples/expo.mdx

@@ -3,24 +3,24 @@ title: "Expo App"
 description: "Expo web app running in the sandbox using Node.js"
 ---
 
-Basic Expo app.
+Expo app with the dev server running on port 8081.
 
-<Note>
-    The development server runs on port 8081 as soon as the sandbox is ready.
-</Note>
+## Create the Expo project
+
+Scaffold a fresh Expo app. The dev server starts automatically when the sandbox boots.
 
 <CodeGroup>
 ```typescript JavaScript & TypeScript
 // template.ts
-import { defaultBuildLogger, waitForURL } from "e2b";
+import { Template, waitForURL } from 'e2b'
 
 export const template = Template()
   .fromNodeImage()
-  .setWorkdir("/home/user/expo-app")
-  .runCmd("npx create-expo-app@latest . --yes")
-  .runCmd("mv /home/user/expo-app/* /home/user/ && rm -rf /home/user/expo-app")
-  .setWorkdir("/home/user")
-  .setStartCmd("npx expo start", waitForURL("http://localhost:8081"));
+  .setWorkdir('/home/user/expo-app')
+  .runCmd('npx create-expo-app@latest . --yes')
+  .runCmd('mv /home/user/expo-app/* /home/user/ && rm -rf /home/user/expo-app')
+  .setWorkdir('/home/user')
+  .setStartCmd('npx expo start', waitForURL('http://localhost:8081'))
 ```
 
 ```python Python
@@ -39,13 +39,17 @@ template = (
 ```
 </CodeGroup>
 
+## Build and publish
+
+Build the template with enough memory for the Expo bundler.
+
 <CodeGroup>
 ```typescript JavaScript & TypeScript
 // build.ts
 import { Template, defaultBuildLogger } from 'e2b'
 import { template as expoTemplate } from './template'
 
-Template.build(expoTemplate, 'expo-app', {
+await Template.build(expoTemplate, 'expo-app', {
   cpuCount: 4,
   memoryMB: 8192,
   onBuildLogs: defaultBuildLogger(),
@@ -64,3 +68,27 @@ Template.build(expoTemplate, 'expo-app',
 )
 ```
 </CodeGroup>
+
+## Access the dev server
+
+Create a sandbox and get the URL. Open it in your browser to see the Expo web preview on port 8081.
+
+<CodeGroup>
+```typescript JavaScript & TypeScript
+import { Sandbox } from 'e2b'
+
+const sandbox = await Sandbox.create('expo-app', { timeoutMs: 60_000 })
+
+const url = sandbox.getHost(8081)
+console.log('Expo app running at:', url)
+```
+
+```python Python
+from e2b import Sandbox
+
+sandbox = Sandbox.create('expo-app', timeout=60)
+
+url = sandbox.get_host(8081)
+print('Expo app running at:', url)
+```
+</CodeGroup>

docs/template/examples/nextjs-bun.mdx

@@ -3,11 +3,11 @@ title: "Next.js App (Bun)"
 description: "Next.js web app running in the sandbox using Bun"
 ---
 
-Basic Next.js app with Tailwind and shadcn UI using Bun.
+Next.js app with Tailwind and shadcn UI using Bun. The dev server starts automatically on port 3000.
 
-<Note>
-    The development server runs on port 3000 as soon as the sandbox is ready.
-</Note>
+## Set up Next.js with Bun
+
+Use Bun for faster installs and hot reloads. This template includes TypeScript, Tailwind, and all shadcn components.
 
 <CodeGroup>
 ```typescript JavaScript & TypeScript
@@ -47,13 +47,17 @@ template = (
 ```
 </CodeGroup>
 
+## Build and publish
+
+Build the template. Bun makes the initial setup noticeably faster than npm.
+
 <CodeGroup>
 ```typescript JavaScript & TypeScript
 // build.ts
 import { Template, defaultBuildLogger } from 'e2b'
 import { template as nextJSTemplate } from './template'
 
-Template.build(nextJSTemplate, 'nextjs-app-bun', {
+await Template.build(nextJSTemplate, 'nextjs-app-bun', {
   cpuCount: 4,
   memoryMB: 4096,
   onBuildLogs: defaultBuildLogger(),
@@ -72,3 +76,27 @@ Template.build(nextjsTemplate, 'nextjs-app-bun',
 )
 ```
 </CodeGroup>
+
+## Access your app
+
+Create a sandbox and grab the URL. The dev server with Turbopack is already running on port 3000.
+
+<CodeGroup>
+```typescript JavaScript & TypeScript
+import { Sandbox } from 'e2b'
+
+const sandbox = await Sandbox.create('nextjs-app-bun', { timeoutMs: 60_000 })
+
+const url = sandbox.getHost(3000)
+console.log('Next.js app running at:', url)
+```
+
+```python Python
+from e2b import Sandbox
+
+sandbox = Sandbox.create('nextjs-app-bun', timeout=60)
+
+url = sandbox.get_host(3000)
+print('Next.js app running at:', url)
+```
+</CodeGroup>