Skip to content

Secure, Fast, and Extensible Sandbox runtime for AI agents.

feat(docs): redesign homepage with animated dark theme

贾岛ea5f724ad034
diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
index 220186ea2..d01a7521a 100644
--- a/docs/.vitepress/config.mts
+++ b/docs/.vitepress/config.mts
@@ -413,9 +413,10 @@ export default defineConfig({
],
footer: {
+ // VitePress renders message first, followed by copyright.
message: "Copyright © OpenSandbox a Series of LF Projects, LLC",
copyright:
- 'For web site terms of use, trademark policy and other project policies please see <a href="https://lfprojects.org/">https://lfprojects.org/</a>.',
+ 'For web site terms of use, trademark policy and other project policies please see <a href="https://lfprojects.org/" target="_blank" rel="noopener noreferrer">https://lfprojects.org/</a>.',
},
search: {
diff --git a/docs/.vitepress/theme/HomePage.vue b/docs/.vitepress/theme/HomePage.vue
new file mode 100644
index 000000000..5733089a4
--- /dev/null
+++ b/docs/.vitepress/theme/HomePage.vue
@@ -0,0 +1,737 @@
+<script setup lang="ts">
+import { computed, onMounted, onUnmounted, ref } from "vue";
+import { withBase } from "vitepress";
+import "./home.css";
+
+const github = "https://github.com/opensandbox-group/OpenSandbox";
+const reducedMotion = ref(false);
+const selectedSdk = ref(0);
+const copyState = ref("Copy");
+let motionQuery: MediaQueryList | undefined;
+let copyTimer: ReturnType<typeof setTimeout> | undefined;
+
+// Deterministic positions keep the server render and hydration identical.
+const particles = Array.from({ length: 24 }, (_, index) => ({
+ left: `${(index * 37 + 13) % 100}%`,
+ top: `${12 + ((index * 23) % 82)}%`,
+ "--particle-size": `${1.5 + (index % 3) * 0.7}px`,
+ "--particle-x": `${45 + (index % 5) * 22}px`,
+ "--particle-y": `-${100 + (index % 4) * 35}px`,
+ animationDuration: `${9 + (index % 7)}s`,
+ animationDelay: `-${(index * 3) % 13}s`,
+}));
+
+const sdks = [
+ { name: "Python", command: "pip install opensandbox", link: "/sdks/python" },
+ {
+ name: "TypeScript",
+ command: "npm install @alibaba-group/opensandbox",
+ link: "/sdks/javascript",
+ },
+ {
+ name: "Java / Kotlin",
+ command:
+ 'implementation("com.alibaba.opensandbox:sandbox:{latest_version}")',
+ link: "/sdks/kotlin",
+ },
+ {
+ name: "Go",
+ command: "go get github.com/alibaba/OpenSandbox/sdks/sandbox/go",
+ link: "/sdks/go",
+ },
+ {
+ name: "C# / .NET",
+ command: "dotnet add package Alibaba.OpenSandbox",
+ link: "/sdks/csharp",
+ },
+];
+const currentSdk = computed(() => sdks[selectedSdk.value]);
+const preview = [
+ "from opensandbox import Sandbox",
+ "",
+ 'sandbox = await Sandbox.create("alpine")',
+ "try:",
+ " result = await sandbox.commands.run(",
+ " \"echo 'Hello OpenSandbox!'\"",
+ " )",
+ "finally:",
+ " await sandbox.destroy()",
+];
+const workloads = [
+ {
+ title: "Agent environment",
+ description:
+ "Give agents isolated environments to run tools, manage files, and execute commands.",
+ tools: ["Claude Code", "Codex CLI", "DeerFlow"],
+ link: "/examples/claude-code",
+ icon: "m8 8-4 4 4 4m8-8 4 4-4 4m-3-11-2 14",
+ },
+ {
+ title: "Browsers & desktops",
+ description:
+ "Let agents navigate the web, test interfaces, and interact with a full desktop.",
+ tools: ["Playwright", "Chrome", "Desktop"],
+ link: "/examples/playwright",
+ icon: "M3 8h18M6 5h.01M9 5h.01M5 3h14a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2Z",
+ },
+ {
+ title: "Code & data analysis",
+ description:
+ "Execute model-generated code and work with its results through the Code Interpreter SDK.",
+ tools: ["Code Interpreter"],
+ link: "/examples/code-interpreter",
+ icon: "M4 19h16M6 15v-4m6 4V5m6 10V8",
+ },
+ {
+ title: "Evaluation & training",
+ description:
+ "Run a separate sandbox for each trial, with resource pools and batch creation for parallel workloads.",
+ tools: ["Harbor", "RL workloads"],
+ link: "/examples/harbor-evaluation",
+ icon: "M5 3v4m14-4v4M3 5h4m10 0h4M5 17v4m14-4v4M3 19h4m10 0h4M9 9h6v6H9z",
+ },
+];
+
+function tokens(line: string) {
+ return line
+ .split(/("[^"]*"|'[^']*'|\b(?:from|import|await|try|finally)\b)/g)
+ .map((text) => ({
+ text,
+ tone: /^["']/.test(text)
+ ? "string"
+ : /^(from|import|await|try|finally)$/.test(text)
+ ? "keyword"
+ : "plain",
+ }));
+}
+
+function moveLight(event: PointerEvent) {
+ if (reducedMotion.value || event.pointerType === "touch") return;
+ const element = event.currentTarget as HTMLElement;
+ const bounds = element.getBoundingClientRect();
+ element.style.setProperty(
+ "--pointer-x",
+ `${((event.clientX - bounds.left) / bounds.width - 0.5) * 12}px`,
+ );
+ element.style.setProperty(
+ "--pointer-y",
+ `${((event.clientY - bounds.top) / bounds.height - 0.5) * 10}px`,
+ );
+}
+
+function resetLight(event: PointerEvent) {
+ const element = event.currentTarget as HTMLElement;
+ element.style.setProperty("--pointer-x", "0px");
+ element.style.setProperty("--pointer-y", "0px");
+}
+
+function selectSdk(index: number) {
+ selectedSdk.value = index;
+ copyState.value = "Copy";
+ clearTimeout(copyTimer);
+}
+
+function navigateSdk(event: KeyboardEvent) {
+ if (!["ArrowLeft", "ArrowRight", "Home", "End"].includes(event.key)) return;
+ event.preventDefault();
+ const index =
+ event.key === "Home"
+ ? 0
+ : event.key === "End"
+ ? sdks.length - 1
+ : (selectedSdk.value +
+ (event.key === "ArrowRight" ? 1 : -1) +
+ sdks.length) %
+ sdks.length;
+ selectSdk(index);
+ document.getElementById(`sdk-tab-${index}`)?.focus();
+}
+
+async function copyCommand() {
+ const index = selectedSdk.value;
+ try {
+ await navigator.clipboard.writeText(currentSdk.value.command);
+ if (index === selectedSdk.value) copyState.value = "Copied";
+ } catch {
+ if (index === selectedSdk.value) copyState.value = "Select text to copy";
+ }
+ clearTimeout(copyTimer);
+ copyTimer = setTimeout(() => {
+ copyState.value = "Copy";
+ }, 2500);
+}
+
+function updateMotion() {
+ reducedMotion.value = motionQuery?.matches ?? false;
+}
+
+onMounted(() => {
+ motionQuery = window.matchMedia("(prefers-reduced-motion: reduce)");
+ updateMotion();
+ motionQuery.addEventListener("change", updateMotion);
+});
+onUnmounted(() => {
+ motionQuery?.removeEventListener("change", updateMotion);
+ clearTimeout(copyTimer);
+});
+</script>
+
+<template>
+ <div class="os-home">
+ <section
+ class="os-hero"
+ aria-labelledby="hero-title"
+ @pointermove="moveLight"
+ @pointerleave="resetLight"
+ >
+ <div class="os-atmosphere" aria-hidden="true">
+ <div class="os-nebula os-nebula-blue"></div>
+ <div class="os-nebula os-nebula-violet"></div>
+ <div class="os-aurora-ribbon"></div>
+ <div class="os-starfield"></div>
+ <div class="os-particles">
+ <span
+ v-for="(particle, index) in particles"
+ :key="index"
+ class="os-particle"
+ :style="particle"
+ ></span>
+ </div>
+ <div class="os-horizon"></div>
+ </div>
+ <div class="os-shell os-hero-grid">
+ <div class="os-hero-copy">
+ <h1 id="hero-title">Your agents<br />Your sandbox</h1>
+ <p class="os-hero-description">
+ Run AI agents on your own infrastructure. Give them isolated
+ environments to execute code, use tools, and explore the web.
+ </p>
+ <div class="os-actions">
+ <a
+ class="os-button os-button-primary"
+ :href="withBase('/getting-started/')"
+ >Start building <span aria-hidden="true">↗</span></a
+ >
+ <a
+ class="os-button os-button-secondary"
+ :href="github"
+ target="_blank"
+ rel="noreferrer"
+ ><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true">
+ <path
+ d="M12 .75a11.25 11.25 0 0 0-3.56 21.92c.56.1.77-.24.77-.54v-2.1c-3.13.68-3.79-1.33-3.79-1.33-.51-1.3-1.25-1.64-1.25-1.64-1.03-.7.08-.69.08-.69 1.13.08 1.73 1.16 1.73 1.16 1.01 1.72 2.64 1.22 3.29.93.1-.73.4-1.22.72-1.5-2.5-.28-5.13-1.25-5.13-5.56 0-1.23.44-2.23 1.16-3.02-.12-.29-.5-1.43.11-2.98 0 0 .95-.3 3.1 1.15a10.8 10.8 0 0 1 5.64 0c2.15-1.46 3.1-1.15 3.1-1.15.61 1.55.23 2.69.11 2.98.72.79 1.16 1.79 1.16 3.02 0 4.32-2.63 5.27-5.14 5.55.4.35.76 1.03.76 2.08v3.1c0 .3.2.65.77.54A11.25 11.25 0 0 0 12 .75Z"
+ /></svg
+ >View on GitHub</a
+ >
+ </div>
+ <p class="os-hero-note">Start with Docker. Scale on Kubernetes.</p>
+ <div class="os-open-source">
+ <span class="os-open-source-license">
+ <span class="os-mini-cube" aria-hidden="true">◇</span> Open source
+ <span class="os-dot-separator">·</span> Apache 2.0
+ </span>
+ <a
+ href="https://aaif.io/projects/opensandbox"
+ target="_blank"
+ rel="noreferrer"
+ class="os-affiliation"
+ >
+ <span class="os-dot-separator" aria-hidden="true">·</span>
+ <span>Linux Foundation Project, contributed by Alibaba</span>
+ <span aria-hidden="true">↗</span>
+ </a>
+ </div>
+ </div>
+ <div class="os-stage">
+ <div class="os-stage-aura" aria-hidden="true"></div>
+ <svg
+ class="os-sandbox-art"
+ viewBox="0 0 640 570"
+ fill="none"
+ role="img"
+ aria-labelledby="sandbox-art-title"
+ >
+ <title id="sandbox-art-title">
+ An isolated sandbox connects your agent to code, browsers, and
+ tools.
+ </title>
+ <defs>
+ <linearGradient
+ id="os-edge"
+ x1="150"
+ y1="90"
+ x2="510"
+ y2="430"
+ gradientUnits="userSpaceOnUse"
+ >
+ <stop stop-color="#e1d4ff" />
+ <stop offset=".5" stop-color="#93e2ff" />
+ <stop offset="1" stop-color="#548bff" />
+ </linearGradient>
+ <linearGradient
+ id="os-top"
+ x1="340"
+ y1="90"
+ x2="340"
+ y2="300"
+ gradientUnits="userSpaceOnUse"
+ >
+ <stop stop-color="#8d7eff" stop-opacity=".24" />
+ <stop offset="1" stop-color="#5d8bff" stop-opacity=".06" />
+ </linearGradient>
+ <linearGradient
+ id="os-left"
+ x1="160"
+ y1="180"
+ x2="340"
+ y2="470"
+ gradientUnits="userSpaceOnUse"
+ >
+ <stop stop-color="#739dff" stop-opacity=".27" />
+ <stop offset="1" stop-color="#152765" stop-opacity=".1" />
+ </linearGradient>
+ <linearGradient
+ id="os-right"
+ x1="520"
+ y1="180"
+ x2="340"
+ y2="470"
+ gradientUnits="userSpaceOnUse"
+ >
+ <stop stop-color="#448dff" stop-opacity=".24" />
+ <stop offset="1" stop-color="#4d5ab5" stop-opacity=".06" />
+ </linearGradient>
+ <radialGradient id="os-core">
+ <stop stop-color="#c8f9ff" />
+ <stop offset=".35" stop-color="#63caff" stop-opacity=".5" />
+ <stop offset="1" stop-color="#548bff" stop-opacity="0" />
+ </radialGradient>
+ <linearGradient id="os-chip" x1="0" y1="0" x2="1" y2="1">
+ <stop stop-color="#e0fcff" />
+ <stop offset=".5" stop-color="#87dfff" />
+ <stop offset="1" stop-color="#798bff" />
+ </linearGradient>
+ <filter id="os-glow" x="-80%" y="-80%" width="260%" height="260%">
+ <feGaussianBlur stdDeviation="5" />
+ </filter>
+ </defs>
+ <g class="os-circuit-lines" stroke="#91b4ef" stroke-opacity=".5">
+ <path
+ d="M12 216h78l70 40M520 256l62-36h54M340 82V28M520 360l62 36h54"
+ />
+ <circle cx="12" cy="216" r="3" />
+ <circle cx="636" cy="220" r="3" />
+ <circle cx="636" cy="396" r="3" />
+ <path d="m80 418 260 150 260-150-260-150Z" opacity=".35" />
+ </g>
+ <g
+ class="os-data-stream"
+ stroke="#d3f6ff"
+ stroke-width="2.5"
+ stroke-linecap="round"
+ stroke-dasharray="22 320"
+ >
+ <path d="M12 216h78l70 40" />
+ <path d="M636 220h-54l-62 36" />
+ <path d="M340 0v82" />
+ </g>
+ <g class="os-floating-cube">
+ <path
+ d="m340 80 180 104-180 104-180-104Z"
+ fill="url(#os-top)"
+ stroke="url(#os-edge)"
+ stroke-width="1.6"
+ />
+ <path
+ d="m160 184 180 104v190L160 374Z"
+ fill="url(#os-left)"
+ stroke="url(#os-edge)"
+ stroke-opacity=".85"
+ />
+ <path
+ d="m520 184-180 104v190l180-104Z"
+ fill="url(#os-right)"
+ stroke="url(#os-edge)"
+ stroke-opacity=".85"
+ />
+ <path
+ d="M340 80v190M160 374l180-104 180 104"
+ stroke="#8ea7ff"
+ stroke-opacity=".3"
+ stroke-dasharray="4 6"
+ />
+ <path
+ d="m340 164 122 70-122 71-122-71Z"
+ stroke="#a7caff"
+ stroke-opacity=".6"
+ />
+ <path
+ d="m340 245 122 70-122 71-122-71Z"
+ stroke="#a7caff"
+ stroke-opacity=".35"
+ />
+ <ellipse
+ class="os-core-aura"
+ cx="340"
+ cy="260"
+ rx="124"
+ ry="88"
+ fill="url(#os-core)"
+ />
+ <path
+ d="m340 184 88 51-88 51-88-51Z"
+ fill="#080e22"
+ stroke="#a9e6ff"
+ stroke-width="1.5"
+ />
+ <path
+ d="m252 235 88 51 88-51v21l-88 51-88-51Z"
+ fill="#426de0"
+ fill-opacity=".65"
+ stroke="#96ccff"
+ stroke-opacity=".8"
+ />
+ <path
+ d="m340 208 46 27-46 27-46-27Z"
+ fill="url(#os-chip)"
+ fill-opacity=".75"
+ stroke="#e3fbff"
+ stroke-width="1.5"
+ />
+ <path
+ d="m340 208 46 27-46 27-46-27Z"
+ stroke="#9feaff"
+ stroke-width="5"
+ filter="url(#os-glow)"
+ opacity=".75"
+ />
+ <path
+ d="m340 80 180 104-180 104-180-104Z"
+ stroke="#86b8ff"
+ stroke-width="4"
+ filter="url(#os-glow)"
+ opacity=".7"
+ />
+ <path
+ class="os-energy-trace"
+ d="m340 80 180 104-180 104-180-104Z"
+ stroke="#e1faff"
+ stroke-width="2.5"
+ stroke-linecap="round"
+ stroke-dasharray="72 760"
+ />
+ <circle cx="340" cy="80" r="3.5" fill="#f2edff" />
+ <circle cx="160" cy="184" r="3.5" fill="#c5f3ff" />
+ <circle cx="520" cy="184" r="3.5" fill="#c5f3ff" />
+ <text
+ x="340"
+ y="143"
+ text-anchor="middle"
+ fill="#d5e5ff"
+ font-size="11"
+ font-family="monospace"
+ letter-spacing="2"
+ >
+ sandbox / isolated
+ </text>
+ </g>
+ </svg>
+ <div class="os-art-label os-art-label-agent">
+ <span class="os-status-dot"></span> AI agent
+ </div>
+ <div class="os-art-label os-art-label-tools">
+ Code · Browser · Tools
+ </div>
+ <div class="os-execution-window">
+ <div class="os-window-bar">
+ <div class="os-window-dots" aria-hidden="true">
+ <i></i><i></i><i></i>
+ </div>
+ <span>sandbox.py</span
+ ><span class="os-window-caption">Execution preview</span>
+ </div>
+ <pre
+ class="os-code"
+ ><code><span v-for="(line, index) in preview" :key="index" class="os-code-line"><span class="os-line-number" aria-hidden="true">{{ index + 1 }}</span><span><span v-for="(token, n) in tokens(line)" :key="n" :class="`os-token-${token.tone}`">{{ token.text }}</span></span></span></code></pre>
+ <div class="os-code-output">
+ <span aria-hidden="true">›</span> Hello OpenSandbox!
+ <span class="os-output-cursor" aria-hidden="true"></span>
+ </div>
+ </div>
+ </div>
+ </div>
+ </section>
+ <div class="os-ecosystem">
+ <div class="os-shell os-ecosystem-inner">
+ <span>Fits your stack.</span>
+ <div>
+ <a v-for="sdk in sdks" :key="sdk.name" :href="withBase(sdk.link)">{{
+ sdk.name
+ }}</a
+ ><span class="os-stack-divider"></span
+ ><a :href="withBase('/cli/')">CLI</a
+ ><a :href="withBase('/sdks/mcp')">MCP</a>
+ </div>
+ </div>
+ </div>
+ <section class="os-shell os-section" aria-labelledby="workloads-title">
+ <div class="os-section-heading">
+ <div>
+ <p class="os-section-kicker">A workspace for every workload</p>
+ <h2 id="workloads-title">Let your agents get to work.</h2>
+ </div>
+ <a class="os-text-link" :href="withBase('/examples/')"
+ >Explore examples <span aria-hidden="true">↗</span></a
+ >
+ </div>
+ <div class="os-workload-grid">
+ <a
+ v-for="workload in workloads"
+ :key="workload.title"
+ class="os-workload"
+ :href="withBase(workload.link)"
+ ><div class="os-workload-top">
+ <svg
+ viewBox="0 0 24 24"
+ fill="none"
+ stroke="currentColor"
+ stroke-width="1.4"
+ stroke-linecap="round"
+ stroke-linejoin="round"
+ aria-hidden="true"
+ >
+ <path :d="workload.icon" /></svg
+ ><span aria-hidden="true">↗</span>
+ </div>
+ <h3>{{ workload.title }}</h3>
+ <p>{{ workload.description }}</p>
+ <div class="os-tool-list">
+ <span v-for="tool in workload.tools" :key="tool">{{ tool }}</span>
+ </div></a
+ >
+ </div>
+ </section>
+ <section class="os-shell os-fast-section" aria-labelledby="fast-title">
+ <div class="os-fast-copy">
+ <a
+ class="os-section-kicker"
+ :href="withBase('/architecture/fast-sandbox/')"
+ >Fast Sandbox runtime <span aria-hidden="true">↗</span></a
+ >
+ <h2 id="fast-title">Less waiting.<br />More running.</h2>
+ <p>
+ Fast, high-density sandboxes on Kubernetes. Restore Firecracker
+ microVMs from pre-warmed capacity, and pause with memory and disk
+ state preserved.
+ </p>
+ <a class="os-text-link" :href="withBase('/architecture/fast-sandbox/')"
+ >Explore Fast Sandbox <span aria-hidden="true">↗</span></a
+ >
+ </div>
+ <div class="os-benchmark">
+ <div class="os-benchmark-heading">
+ <span class="os-status-dot"></span> Firecracker warm creation
+ </div>
+ <div class="os-benchmark-stats">
+ <div>
+ <strong>64<span>ms</span></strong>
+ <p>P50 · Serial creation</p>
+ </div>
+ <div>
+ <strong>125.4<span>ms</span></strong>
+ <p>P99 · 10 concurrent</p>
+ </div>
+ </div>
+ <div class="os-runtime-flow">
+ <span>Cached template</span><i aria-hidden="true"></i
+ ><span>Restore microVM</span><i aria-hidden="true"></i
+ ><span class="os-flow-ready">Ready</span>
+ </div>
+ <a
+ :href="withBase('/architecture/fast-sandbox/performance')"
+ class="os-text-link"
+ >Read the benchmark & conditions <span aria-hidden="true">↗</span></a
+ >
+ </div>
+ </section>
+ <section
+ class="os-shell os-section os-control-section"
+ aria-labelledby="control-title"
+ >
+ <div class="os-section-heading">
+ <div>
+ <p class="os-section-kicker">Your infrastructure. Your boundaries.</p>
+ <h2 id="control-title">Give agents access.<br />Keep control.</h2>
+ </div>
+ <p class="os-heading-description">
+ One sandbox API, from your laptop to your cluster. Define what agents
+ can reach and how they use credentials.
+ </p>
+ </div>
+ <div class="os-control-grid">
+ <a :href="withBase('/guides/network-isolation')" class="os-control-item"
+ ><svg
+ viewBox="0 0 40 40"
+ fill="none"
+ stroke="currentColor"
+ stroke-width="1.3"
+ aria-hidden="true"
+ >
+ <rect x="13" y="13" width="14" height="14" rx="3" />
+ <path
+ d="M20 4v9m0 14v9M4 20h9m14 0h9M8 8l6 6m12 12 6 6M8 32l6-6m12-12 6-6"
+ />
+ <circle cx="20" cy="20" r="3" />
+ </svg>
+ <h3>Network access control <span aria-hidden="true">↗</span></h3>
+ <p>
+ Route inbound traffic through a unified ingress gateway. Set
+ outbound access policies for each sandbox.
+ </p></a
+ >
+ <a :href="withBase('/guides/credential-vault')" class="os-control-item"
+ ><svg
+ viewBox="0 0 40 40"
+ fill="none"
+ stroke="currentColor"
+ stroke-width="1.3"
+ aria-hidden="true"
+ >
+ <path d="m20 4 13 5v10c0 8-13 16-13 16S7 27 7 19V9Z" />
+ <circle cx="20" cy="18" r="4" />
+ <path d="M20 22v5" />
+ </svg>
+ <h3>Credential Vault <span aria-hidden="true">↗</span></h3>
+ <p>
+ Let agents call external services while keeping real credentials out
+ of sandbox workloads.
+ </p></a
+ >
+ <a :href="withBase('/architecture/')" class="os-control-item"
+ ><svg
+ viewBox="0 0 40 40"
+ fill="none"
+ stroke="currentColor"
+ stroke-width="1.3"
+ aria-hidden="true"
+ >
+ <path
+ d="m20 4 14 8-14 8-14-8Zm-14 8v16l14 8 14-8V12M20 20v16M6 20l14 8 14-8"
+ />
+ </svg>
+ <h3>Local to cluster <span aria-hidden="true">↗</span></h3>
+ <p>
+ Start locally with Docker. Deploy on Kubernetes through a unified,
+ extensible lifecycle and execution API.
+ </p></a
+ >
+ </div>
+ </section>
+ <section
+ id="get-started"
+ class="os-shell os-start-section"
+ aria-labelledby="start-title"
+ >
+ <div class="os-start-copy">
+ <p class="os-section-kicker">
+ From your first sandbox to your next idea
+ </p>
+ <h2 id="start-title">Make room<br />for your next agent.</h2>
+ <p>
+ Start the server, pick your SDK, and run your first command. Your
+ infrastructure takes it from there.
+ </p>
+ <a
+ class="os-button os-button-primary"
+ :href="withBase('/getting-started/')"
+ >Follow the quick start <span aria-hidden="true">↗</span></a
+ >
+ <div class="os-start-links">
+ <a :href="withBase('/cli/')">Use the CLI</a
+ ><a :href="withBase('/sdks/mcp')">Connect with MCP</a>
+ </div>
+ </div>
+ <div class="os-setup-window">
+ <div class="os-setup-step">
+ <span class="os-step-number">1</span>
+ <h3>Start a local server</h3>
+ <span>Docker + Python 3.10+</span>
+ </div>
+ <pre
+ class="os-server-code"
+ ><code><span class="os-comment"># Initialize your Docker configuration</span>
+uvx opensandbox-server init-config \
+ ~/.sandbox.toml --example docker
+
+<span class="os-comment"># Start the server</span>
+uvx opensandbox-server</code></pre>
+ <div class="os-setup-step">
+ <span class="os-step-number">2</span>
+ <h3>Install your SDK</h3>
+ </div>
+ <div
+ class="os-sdk-tabs"
+ role="tablist"
+ aria-label="SDK language"
+ @keydown="navigateSdk"
+ >
+ <button
+ v-for="(sdk, index) in sdks"
+ :id="`sdk-tab-${index}`"
+ :key="sdk.name"
+ type="button"
+ role="tab"
+ :aria-selected="selectedSdk === index"
+ aria-controls="sdk-install-panel"
+ :tabindex="selectedSdk === index ? 0 : -1"
+ @click="selectSdk(index)"
+ >
+ {{ sdk.name }}
+ </button>
+ </div>
+ <div
+ id="sdk-install-panel"
+ class="os-install-panel"
+ role="tabpanel"
+ :aria-labelledby="`sdk-tab-${selectedSdk}`"
+ tabindex="0"
+ >
+ <div class="os-install-command">
+ <code>{{ currentSdk.command }}</code
+ ><button
+ type="button"
+ :aria-label="`${copyState} install command`"
+ @click="copyCommand"
+ >
+ {{ copyState }}
+ </button>
+ </div>
+ <p v-if="selectedSdk === 2" class="os-install-hint">
+ Add to build.gradle.kts and replace {latest_version} with a
+ published version.
+ </p>
+ <a :href="withBase(currentSdk.link)"
+ >Read the {{ currentSdk.name }} guide
+ <span aria-hidden="true">↗</span></a
+ ><span class="os-sr-only" role="status">{{
+ copyState === "Copied" ? "Install command copied to clipboard." : ""
+ }}</span>
+ </div>
+ </div>
+ </section>
+ <div class="os-shell os-community">
+ <a :href="github" target="_blank" rel="noreferrer"
+ >Built in the open. Build with us. <span aria-hidden="true">↗</span></a
+ >
+ <div>
+ <a :href="withBase('/community/contributing')">Contribute</a
+ ><a
+ href="https://discord.gg/g7FuPs8YeD"
+ target="_blank"
+ rel="noreferrer"
+ >Join Discord</a
+ ><a :href="withBase('/api/')">API reference</a>
+ </div>
+ </div>
+ </div>
+</template>
diff --git a/docs/.vitepress/theme/home.css b/docs/.vitepress/theme/home.css
new file mode 100644
index 000000000..7f100e09e
--- /dev/null
+++ b/docs/.vitepress/theme/home.css
@@ -0,0 +1,1499 @@
+/* Copyright 2026 The OpenSandbox Authors. Licensed under the Apache License, Version 2.0. */
+
+/* The landing page owns its palette; documentation retains the selected theme. */
+.sandbox-home {
+ --vp-c-bg: #060711;
+ --vp-c-bg-alt: #0b0d1a;
+ --vp-c-bg-elv: #111423;
+ --vp-c-bg-soft: #101322;
+ --vp-c-text-1: #f0f1fa;
+ --vp-c-text-2: #a6acc4;
+ --vp-c-text-3: #7b829e;
+ --vp-c-divider: #22263d;
+ --vp-c-gutter: #22263d;
+ --vp-c-brand-1: #a4b3ff;
+ --vp-c-brand-2: #bec8ff;
+ --vp-c-brand-3: #7186f9;
+ --vp-c-brand-soft: #7085ff18;
+ --vp-c-default-soft: #161a2d;
+ --vp-nav-bg-color: #060711;
+ --vp-nav-logo-height: 32px;
+ background: var(--vp-c-bg);
+ color: var(--vp-c-text-1);
+ color-scheme: dark;
+}
+.sandbox-home .VPNavBar {
+ background: #060711e8;
+ backdrop-filter: blur(18px);
+}
+.sandbox-home .VPNavBar .content-body {
+ background: transparent;
+}
+.sandbox-home .VPNavBar .divider-line {
+ background: #ffffff0b;
+}
+.sandbox-home .VPNavBarTitle .title {
+ gap: 10px;
+ font-size: 19px;
+ letter-spacing: -0.6px;
+}
+.sandbox-home .VPNavBarAppearance,
+.sandbox-home .VPNavScreenAppearance,
+.sandbox-home .VPNavBarExtra {
+ display: none;
+}
+.sandbox-home .VPNavScreen {
+ background: #0b0d1a;
+}
+.sandbox-home .VPFooter {
+ padding: 28px 24px;
+ border-color: #ffffff0d;
+ background: #060711;
+}
+.sandbox-home .VPFooter .message,
+.sandbox-home .VPFooter .copyright {
+ color: #9299b3;
+}
+.sandbox-home .DocSearch-Button,
+.sandbox-home .VPNavBarSearch .DocSearch-Button {
+ background: #ffffff05;
+}
+
+.os-home {
+ --os-blue: #8ca6ff;
+ --os-violet: #a492ff;
+ --os-muted: #a0a8c2;
+ --os-border: #ffffff13;
+ --os-mono: "SFMono-Regular", Consolas, "Liberation Mono", monospace;
+ font-family: var(--vp-font-family-base);
+ -webkit-font-smoothing: antialiased;
+ overflow: clip;
+}
+.os-home *,
+.os-home *::before,
+.os-home *::after {
+ box-sizing: border-box;
+}
+.os-home a {
+ text-decoration: none;
+}
+.os-home button {
+ font: inherit;
+ cursor: pointer;
+}
+.os-home a:focus-visible,
+.os-home button:focus-visible,
+.os-home [tabindex="0"]:focus-visible {
+ outline: 2px solid #afc1ff;
+ outline-offset: 6px;
+}
+.os-home a,
+.os-home button {
+ -webkit-tap-highlight-color: transparent;
+}
+.os-shell {
+ width: min(1200px, calc(100% - 96px));
+ margin-inline: auto;
+}
+.os-hero {
+ position: relative;
+ isolation: isolate;
+ border-bottom: 1px solid var(--os-border);
+}
+.os-atmosphere {
+ position: absolute;
+ inset: -64px 0 0;
+ overflow: hidden;
+ z-index: -1;
+ pointer-events: none;
+}
+.os-nebula {
+ position: absolute;
+ border-radius: 50%;
+ filter: blur(68px);
+ will-change: transform;
+}
+.os-nebula-blue {
+ width: 760px;
+ height: 510px;
+ top: 40px;
+ left: calc(50% - 90px);
+ background: radial-gradient(
+ ellipse,
+ #2855e58c,
+ #133ead36 48%,
+ transparent 70%
+ );
+ transform: rotate(-24deg);
+ animation: os-drift-blue 12s ease-in-out infinite alternate;
+}
+.os-nebula-violet {
+ width: 620px;
+ height: 380px;
+ top: -160px;
+ left: calc(50% + 150px);
+ background: radial-gradient(
+ ellipse,
+ #7b44e980,
+ #4c2c8a30 50%,
+ transparent 70%
+ );
+ animation: os-drift-violet 16s ease-in-out infinite alternate;
+}
+.os-aurora-ribbon {
+ position: absolute;
+ top: 55px;
+ left: 47%;
+ width: 820px;
+ height: 260px;
+ background: linear-gradient(
+ 160deg,
+ transparent 25%,
+ #687aff20 40%,
+ #8bbdff40 49%,
+ #8b65ff26 56%,
+ transparent 72%
+ );
+ filter: blur(24px);
+ transform: rotate(-24deg);
+ animation: os-aurora-flow 10s ease-in-out infinite alternate;
+}
+.os-particles {
+ position: absolute;
+ inset: 0;
+ width: 100%;
+ height: 100%;
+ mask-image: linear-gradient(90deg, #0004, #0008 40%, #000 65%);
+}
+.os-particle {
+ position: absolute;
+ width: var(--particle-size);
+ height: var(--particle-size);
+ border-radius: 50%;
+ background: #c5edff;
+ box-shadow:
+ 0 0 7px #8acbff,
+ 0 0 18px #678aff80;
+ opacity: 0;
+ animation: os-particle-float linear infinite;
+}
+.os-particle:nth-child(3n) {
+ background: #c6b4ff;
+ box-shadow:
+ 0 0 8px #a18aff,
+ 0 0 20px #8060ff70;
+}
+.os-starfield {
+ position: absolute;
+ inset: 0;
+ opacity: 0.45;
+ background-image:
+ radial-gradient(1px 1px at 15% 19%, #b8bdff 70%, transparent),
+ radial-gradient(1px 1px at 86% 24%, #cdd8ff 70%, transparent),
+ radial-gradient(1px 1px at 69% 68%, #a3a9ff 70%, transparent),
+ radial-gradient(1px 1px at 39% 82%, #7a8acc 70%, transparent),
+ radial-gradient(1px 1px at 92% 71%, #a3beff 70%, transparent);
+ background-size: 610px 460px;
+ animation: os-stars-drift 36s linear infinite alternate;
+}
+.os-horizon {
+ position: absolute;
+ width: 1050px;
+ height: 370px;
+ top: 340px;
+ left: 46%;
+ border: 1px solid #7186ff27;
+ border-radius: 50%;
+ transform: rotate(-28deg);
+ box-shadow:
+ 0 -2px 18px #5d71ff0c,
+ inset 0 2px 35px #3c5dff09;
+}
+.os-hero-grid {
+ display: grid;
+ grid-template-columns: 1.03fr 1fr;
+ align-items: center;
+ min-height: 685px;
+ gap: 8px;
+ padding-block: 60px 48px;
+}
+.os-hero-copy {
+ position: relative;
+ z-index: 2;
+ padding-bottom: 17px;
+}
+.os-status-dot {
+ display: inline-block;
+ flex-shrink: 0;
+ width: 6px;
+ height: 6px;
+ border-radius: 50%;
+ background: #9cafff;
+ box-shadow: 0 0 10px #7398ff70;
+}
+.os-hero h1 {
+ margin: 0;
+ font-size: clamp(58px, 6vw, 84px);
+ font-weight: 600;
+ line-height: 1.065;
+ letter-spacing: -5px;
+ color: #f2f3ff;
+}
+.os-hero-description {
+ max-width: 465px;
+ margin-top: 25px;
+ color: #a7aec9;
+ font-size: 17px;
+ line-height: 1.8;
+ text-wrap: pretty;
+}
+.os-actions {
+ display: flex;
+ gap: 12px;
+ flex-wrap: wrap;
+ margin-top: 31px;
+}
+.os-button {
+ display: inline-flex;
+ justify-content: center;
+ align-items: center;
+ gap: 20px;
+ min-height: 46px;
+ padding: 0 21px;
+ border: 1px solid transparent;
+ border-radius: 7px;
+ font-size: 13px;
+ font-weight: 600;
+ transition:
+ background 0.2s,
+ border-color 0.2s,
+ box-shadow 0.2s;
+}
+.os-button-primary {
+ background: #e3e8ff;
+ color: #13172f;
+ box-shadow:
+ inset 0 1px 0 #fff,
+ 0 0 25px #839cff16;
+}
+.os-button-primary:hover {
+ background: #fff;
+ box-shadow: 0 0 25px #839cff30;
+}
+.os-button-secondary {
+ border-color: #ffffff24;
+ color: #d5d9ec;
+ background: #ffffff03;
+ gap: 9px;
+}
+.os-button-secondary:hover {
+ background: #ffffff09;
+ border-color: #a8b6ff60;
+}
+.os-button svg {
+ width: 15px;
+ height: 15px;
+}
+.os-hero-note {
+ color: #929ab5;
+ font-size: 12px;
+ margin-top: 16px;
+}
+.os-open-source {
+ display: flex;
+ flex-wrap: wrap;
+ gap: 8px 10px;
+ align-items: center;
+ margin-top: 32px;
+ font-size: 11px;
+ color: #8d95b2;
+}
+.os-open-source-license {
+ display: inline-flex;
+ align-items: center;
+ gap: 10px;
+}
+.os-mini-cube {
+ font-size: 19px;
+ color: #acbaff;
+}
+.os-dot-separator {
+ color: #4e5676;
+}
+.os-stage {
+ position: relative;
+ height: 550px;
+ min-width: 0;
+ margin-right: -33px;
+ transform: translate(var(--pointer-x, 0px), var(--pointer-y, 0px));
+ transition: transform 0.6s ease-out;
+}
+.os-stage-aura {
+ position: absolute;
+ width: 320px;
+ height: 300px;
+ top: 65px;
+ left: 145px;
+ background: radial-gradient(
+ ellipse,
+ #2799ff40,
+ #4857f31a 55%,
+ transparent 75%
+ );
+ filter: blur(70px);
+ border-radius: 50%;
+}
+.os-sandbox-art {
+ position: absolute;
+ width: 630px;
+ max-width: 115%;
+ height: auto;
+ top: -40px;
+ left: -10px;
+ overflow: visible;
+}
+.os-floating-cube {
+ animation: os-cube-float 8s ease-in-out infinite;
+}
+.os-data-stream {
+ animation: os-data-flow 5s linear infinite;
+ filter: drop-shadow(0 0 4px #70cfff);
+}
+.os-energy-trace {
+ animation: os-energy-flow 7s linear infinite;
+ filter: drop-shadow(0 0 5px #70cfff);
+}
+.os-core-aura {
+ animation: os-core-pulse 6s ease-in-out infinite;
+}
+.os-art-label {
+ position: absolute;
+ z-index: 1;
+ display: flex;
+ align-items: center;
+ gap: 8px;
+ border: 1px solid #91bdff66;
+ background: #080d20ed;
+ color: #edf5ff;
+ box-shadow:
+ 0 0 18px #4d91ff17,
+ inset 0 1px 0 #c9e6ff12;
+ backdrop-filter: blur(12px);
+ border-radius: 6px;
+ font-size: 10px;
+ padding: 7px 10px;
+}
+.os-art-label-agent {
+ top: 27px;
+ left: 42%;
+}
+.os-art-label-agent .os-status-dot {
+ background: #a1edff;
+ box-shadow: 0 0 10px #65d6ffb3;
+}
+.os-art-label-tools {
+ top: 165px;
+ right: -3px;
+}
+.os-execution-window {
+ position: absolute;
+ z-index: 2;
+ bottom: -2px;
+ left: 6%;
+ right: 8%;
+ background: linear-gradient(135deg, #080e20fc, #050916fc);
+ border: 1px solid #8eaaff80;
+ border-radius: 10px;
+ box-shadow:
+ 0 24px 75px #0009,
+ 0 0 36px #537dff26,
+ inset 0 1px 0 #e0eeff24;
+ backdrop-filter: blur(20px);
+ overflow: hidden;
+}
+.os-execution-window::before {
+ content: "";
+ position: absolute;
+ inset: 0 12% auto;
+ height: 1px;
+ background: linear-gradient(
+ 90deg,
+ transparent,
+ #bceeff,
+ #a9a5ff,
+ transparent
+ );
+ pointer-events: none;
+}
+.os-window-bar {
+ display: flex;
+ align-items: center;
+ gap: 14px;
+ min-height: 39px;
+ padding: 0 15px;
+ border-bottom: 1px solid #a9c1ff24;
+ background: #a7baff08;
+ color: #d1dffa;
+ font: 10px var(--os-mono);
+}
+.os-window-dots {
+ display: flex;
+ gap: 5px;
+}
+.os-window-dots i {
+ display: block;
+ width: 6px;
+ height: 6px;
+ border-radius: 50%;
+ background: #7ce6c6;
+}
+.os-window-dots i:first-child {
+ background: #ff749a;
+}
+.os-window-dots i:nth-child(2) {
+ background: #ffd17f;
+}
+.os-window-caption {
+ margin-left: auto;
+ font: 9px var(--vp-font-family-base);
+ color: #aebcdb;
+}
+.os-code {
+ padding: 15px 16px 14px;
+ margin: 0;
+ font: 11px/1.95 var(--os-mono);
+ color: #e8efff;
+ tab-size: 4;
+ overflow: auto;
+}
+.os-code-line {
+ display: flex;
+ min-height: 21px;
+ white-space: pre;
+}
+.os-line-number {
+ display: inline-block;
+ width: 29px;
+ flex-shrink: 0;
+ user-select: none;
+ color: #8496bc;
+ font-size: 10px;
+}
+.os-token-keyword {
+ color: #d1acff;
+}
+.os-token-string {
+ color: #9cf2c5;
+}
+.os-code-output {
+ padding: 12px 17px;
+ border-top: 1px solid #9fd9ff29;
+ background: #5fdec510;
+ color: #97f3d3;
+ font: 10px var(--os-mono);
+ display: flex;
+ align-items: center;
+ gap: 12px;
+}
+.os-code-output > span:first-child {
+ color: #8ccfdb;
+}
+.os-output-cursor {
+ width: 5px;
+ height: 11px;
+ background: #a1f0e1;
+ opacity: 0.7;
+ animation: os-cursor 2s steps(2) infinite;
+}
+.os-affiliation {
+ min-width: 0;
+ max-width: 100%;
+ line-height: 1.6;
+ color: #9da7c5;
+ display: inline-flex;
+ align-items: center;
+ gap: 8px;
+}
+.os-affiliation:hover {
+ color: #dbe4ff;
+}
+
+.os-ecosystem {
+ border-bottom: 1px solid var(--os-border);
+ background: #ffffff02;
+}
+.os-ecosystem-inner {
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ gap: 30px;
+ min-height: 91px;
+}
+.os-ecosystem-inner > span {
+ font-size: 12px;
+ color: #8e96b1;
+ white-space: nowrap;
+}
+.os-ecosystem-inner > div {
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ flex: 1;
+ max-width: 885px;
+ gap: 24px;
+}
+.os-ecosystem a {
+ color: #bfc5db;
+ font-size: 16px;
+ font-weight: 500;
+ letter-spacing: -0.4px;
+ white-space: nowrap;
+}
+.os-ecosystem a:hover {
+ color: #e1e7ff;
+}
+.os-stack-divider {
+ height: 19px;
+ width: 1px;
+ background: #ffffff20;
+}
+.os-section {
+ padding-block: 96px;
+}
+.os-section-heading {
+ display: flex;
+ align-items: flex-end;
+ justify-content: space-between;
+ gap: 40px;
+ margin-bottom: 35px;
+}
+.os-section-kicker {
+ display: block;
+ margin: 0 0 13px;
+ color: #a3b4f2;
+ font-size: 12px;
+ line-height: 1.6;
+}
+.os-home h2 {
+ font-size: clamp(31px, 3.4vw, 44px);
+ font-weight: 500;
+ line-height: 1.18;
+ letter-spacing: -1.9px;
+ color: #ebeefa;
+ margin: 0;
+}
+.os-text-link {
+ color: #b4c0ef;
+ font-size: 12px;
+ display: inline-flex;
+ gap: 12px;
+ align-items: center;
+ line-height: 1.7;
+}
+.os-text-link:hover {
+ color: #e0e6ff;
+}
+.os-workload-grid {
+ display: grid;
+ grid-template-columns: repeat(4, minmax(0, 1fr));
+ border: 1px solid var(--os-border);
+ border-radius: 10px;
+ background: linear-gradient(120deg, #1c25471f, #1112240b);
+}
+.os-workload {
+ padding: 26px 25px 24px;
+ min-width: 0;
+}
+.os-workload + .os-workload {
+ border-left: 1px solid var(--os-border);
+}
+.os-workload:hover {
+ background: #7f94ff07;
+}
+.os-workload-top {
+ display: flex;
+ justify-content: space-between;
+ align-items: center;
+ margin-bottom: 37px;
+ color: #aebfed;
+}
+.os-workload-top svg {
+ width: 24px;
+ height: 24px;
+}
+.os-workload-top > span {
+ color: #727f9f;
+ font-size: 16px;
+}
+.os-home h3 {
+ margin: 0;
+ font-size: 16px;
+ line-height: 1.5;
+ font-weight: 500;
+ letter-spacing: -0.3px;
+ color: #dde2f6;
+}
+.os-workload p {
+ color: #a3adc7;
+ font-size: 13px;
+ line-height: 1.85;
+ margin: 12px 0 20px;
+ min-height: 97px;
+}
+.os-tool-list {
+ display: flex;
+ flex-wrap: wrap;
+ gap: 6px;
+}
+.os-tool-list span {
+ color: #a5b1cf;
+ font-size: 9px;
+ line-height: 1.5;
+ border: 1px solid #ffffff12;
+ padding: 3px 6px;
+ border-radius: 4px;
+}
+
+.os-fast-section {
+ display: grid;
+ grid-template-columns: 0.9fr 1.1fr;
+ gap: 80px;
+ align-items: center;
+ padding: 56px 0 69px;
+ border-bottom: 1px solid var(--os-border);
+}
+.os-fast-copy > p:not(.os-section-kicker) {
+ color: var(--os-muted);
+ font-size: 14px;
+ line-height: 1.85;
+ margin-top: 21px;
+ max-width: 410px;
+}
+.os-fast-copy > .os-text-link {
+ margin-top: 22px;
+}
+.os-benchmark {
+ position: relative;
+ padding: 31px;
+ border: 1px solid #a8a0ff26;
+ border-radius: 12px;
+ background:
+ radial-gradient(ellipse at 100% 0%, #6845c01b, transparent 75%), #0e101f;
+}
+.os-benchmark-heading {
+ display: flex;
+ align-items: center;
+ gap: 9px;
+ font-size: 11px;
+ color: #aeb8d9;
+}
+.os-benchmark-stats {
+ display: grid;
+ grid-template-columns: 1fr 1.4fr;
+ margin-block: 26px 30px;
+}
+.os-benchmark-stats > div + div {
+ border-left: 1px solid #ffffff13;
+ padding-left: 28px;
+}
+.os-benchmark strong {
+ font-size: clamp(36px, 4vw, 54px);
+ line-height: 1.1;
+ font-weight: 500;
+ letter-spacing: -2.5px;
+ color: #e2dfff;
+ white-space: nowrap;
+}
+.os-benchmark strong span {
+ font-size: 21px;
+ letter-spacing: -1px;
+ margin-left: 5px;
+ color: #a3a5ca;
+}
+.os-benchmark-stats p {
+ color: #99a3bf;
+ font-size: 10px;
+ margin-top: 10px;
+}
+.os-runtime-flow {
+ display: flex;
+ align-items: center;
+ gap: 12px;
+ font: 9px var(--os-mono);
+ color: #a4acc8;
+ padding-block: 16px;
+ border-block: 1px solid #ffffff0c;
+}
+.os-runtime-flow i {
+ height: 1px;
+ flex: 1;
+ min-width: 10px;
+ background: linear-gradient(90deg, #666fc188, #666fc122);
+}
+.os-flow-ready {
+ color: #a4d7c6;
+}
+.os-benchmark .os-text-link {
+ margin-top: 16px;
+ font-size: 10px;
+}
+.os-control-section {
+ padding-top: 91px;
+}
+.os-heading-description {
+ max-width: 365px;
+ font-size: 13px;
+ color: #9aa5c1;
+ line-height: 1.9;
+ margin: 0 0 4px;
+}
+.os-control-grid {
+ display: grid;
+ grid-template-columns: repeat(3, 1fr);
+ gap: 44px;
+ padding-top: 13px;
+}
+.os-control-item {
+ border-top: 1px solid var(--os-border);
+ padding-top: 26px;
+}
+.os-control-item > svg {
+ color: #8c9ed4;
+ width: 38px;
+ height: 38px;
+ margin-bottom: 21px;
+}
+.os-control-item h3 {
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ font-size: 15px;
+}
+.os-control-item h3 span {
+ font-size: 13px;
+ color: #727d9f;
+}
+.os-control-item:hover h3 {
+ color: #b6c7ff;
+}
+.os-control-item p {
+ font-size: 13px;
+ color: #a1acc7;
+ line-height: 1.85;
+ margin-top: 12px;
+}
+
+.os-start-section {
+ position: relative;
+ display: grid;
+ grid-template-columns: 0.9fr 1.1fr;
+ gap: 80px;
+ align-items: center;
+ border-block: 1px solid var(--os-border);
+ padding-block: 70px;
+}
+.os-start-section::before {
+ content: "";
+ position: absolute;
+ z-index: -1;
+ width: 620px;
+ height: 400px;
+ left: -260px;
+ top: -10px;
+ background: radial-gradient(ellipse, #2943be16, transparent 70%);
+ pointer-events: none;
+}
+.os-start-copy > p:not(.os-section-kicker) {
+ color: #99a4c0;
+ font-size: 13px;
+ line-height: 1.9;
+ max-width: 350px;
+ margin: 20px 0 25px;
+}
+.os-start-links {
+ display: flex;
+ gap: 21px;
+ font-size: 11px;
+ color: #a9b5d7;
+ margin-top: 22px;
+}
+.os-start-links a:hover {
+ color: #dde5ff;
+}
+.os-setup-window {
+ border: 1px solid #ffffff1a;
+ border-radius: 10px;
+ background: #0d101e;
+ padding: 25px;
+ min-width: 0;
+}
+.os-setup-step {
+ display: flex;
+ gap: 10px;
+ align-items: center;
+}
+.os-step-number {
+ display: grid;
+ place-items: center;
+ width: 21px;
+ height: 21px;
+ background: #8198ff0f;
+ color: #a0b2f0;
+ border: 1px solid #8198ff30;
+ border-radius: 5px;
+ font: 10px var(--os-mono);
+}
+.os-setup-step h3 {
+ font-size: 12px;
+}
+.os-setup-step > span:last-child:not(.os-step-number) {
+ color: #8a95b2;
+ margin-left: auto;
+ font-size: 9px;
+}
+.os-server-code {
+ color: #c0cbe5;
+ font: 10px/1.95 var(--os-mono);
+ margin: 18px 0 25px;
+ overflow: auto;
+}
+.os-comment {
+ color: #7986a7;
+}
+.os-sdk-tabs {
+ display: flex;
+ margin-top: 19px;
+ border-bottom: 1px solid #ffffff12;
+ gap: 17px;
+}
+.os-sdk-tabs button {
+ color: #929cba;
+ font-size: 10px;
+ padding: 0 0 10px;
+ border-bottom: 1px solid transparent;
+ white-space: nowrap;
+}
+.os-sdk-tabs button[aria-selected="true"] {
+ color: #c6d2ff;
+ border-bottom-color: #a6b8ff;
+}
+.os-install-panel {
+ padding-top: 17px;
+}
+.os-install-command {
+ display: flex;
+ align-items: flex-start;
+ gap: 10px;
+ min-height: 39px;
+}
+.os-install-command code {
+ font: 10px/1.8 var(--os-mono);
+ color: #c4d1f6;
+ overflow-wrap: anywhere;
+ flex: 1;
+}
+.os-install-command button {
+ font-size: 9px;
+ line-height: 1.8;
+ padding: 2px 6px;
+ border: 1px solid #ffffff1b;
+ border-radius: 4px;
+ color: #adb9d9;
+ flex-shrink: 0;
+}
+.os-install-command button:hover {
+ background: #ffffff09;
+}
+.os-install-panel > a {
+ display: inline-block;
+ color: #94a5d5;
+ font-size: 10px;
+ padding-top: 6px;
+}
+.os-install-panel > a span {
+ margin-left: 8px;
+}
+.os-install-hint {
+ color: #969fba;
+ font-size: 10px;
+ line-height: 1.7;
+ margin-bottom: 9px;
+}
+.os-community {
+ padding-block: 33px;
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ gap: 24px;
+ font-size: 12px;
+}
+.os-community > a {
+ color: #c4cde8;
+}
+.os-community > a span {
+ margin-left: 12px;
+}
+.os-community > div {
+ display: flex;
+ gap: 27px;
+ color: #929fbe;
+ font-size: 11px;
+}
+.os-community a:hover {
+ color: #dbe4ff;
+}
+.os-sr-only {
+ position: absolute;
+ width: 1px;
+ height: 1px;
+ padding: 0;
+ margin: -1px;
+ overflow: hidden;
+ clip-path: inset(50%);
+ white-space: nowrap;
+ border: 0;
+}
+
+@keyframes os-drift-blue {
+ from {
+ transform: translate3d(0, 0, 0) rotate(-24deg) scale(1);
+ opacity: 0.8;
+ }
+ to {
+ transform: translate3d(-145px, 90px, 0) rotate(-8deg) scale(1.25);
+ opacity: 1;
+ }
+}
+@keyframes os-drift-violet {
+ from {
+ transform: translate3d(0, 0, 0);
+ opacity: 0.65;
+ }
+ to {
+ transform: translate3d(-140px, 90px, 0) scale(1.25);
+ opacity: 1;
+ }
+}
+@keyframes os-stars-drift {
+ to {
+ transform: translate3d(-22px, 15px, 0);
+ }
+}
+@keyframes os-aurora-flow {
+ from {
+ transform: translate3d(40px, -35px, 0) rotate(-28deg);
+ opacity: 0.45;
+ }
+ to {
+ transform: translate3d(-135px, 110px, 0) rotate(-12deg);
+ opacity: 1;
+ }
+}
+@keyframes os-particle-float {
+ 0% {
+ transform: translate3d(0, 0, 0);
+ opacity: 0;
+ }
+ 18%,
+ 72% {
+ opacity: 0.8;
+ }
+ 100% {
+ transform: translate3d(var(--particle-x), var(--particle-y), 0);
+ opacity: 0;
+ }
+}
+@keyframes os-cube-float {
+ 0%,
+ 100% {
+ transform: translateY(0);
+ }
+ 50% {
+ transform: translateY(-12px);
+ }
+}
+@keyframes os-data-flow {
+ to {
+ stroke-dashoffset: -342;
+ }
+}
+@keyframes os-energy-flow {
+ to {
+ stroke-dashoffset: -832;
+ }
+}
+@keyframes os-core-pulse {
+ 0%,
+ 100% {
+ opacity: 0.55;
+ }
+ 50% {
+ opacity: 1;
+ }
+}
+@keyframes os-cursor {
+ 50% {
+ opacity: 0.1;
+ }
+}
+
+@media (min-width: 1600px) {
+ .os-hero-grid {
+ min-height: 745px;
+ }
+}
+@media (max-width: 1100px) {
+ .sandbox-home .VPNavBarMenu,
+ .sandbox-home .VPNavBarSocialLinks {
+ display: none;
+ }
+ .sandbox-home .VPNavBarHamburger {
+ display: flex;
+ }
+ .sandbox-home .VPNavScreen {
+ display: block;
+ }
+ .os-shell {
+ width: calc(100% - 64px);
+ }
+ .os-hero-grid {
+ min-height: 640px;
+ grid-template-columns: 1fr 1fr;
+ }
+ .os-hero h1 {
+ font-size: 65px;
+ letter-spacing: -4px;
+ }
+ .os-hero-description {
+ font-size: 15px;
+ max-width: 390px;
+ }
+ .os-stage {
+ margin-right: -18px;
+ height: 520px;
+ }
+ .os-art-label-tools {
+ right: 0;
+ top: 145px;
+ }
+ .os-execution-window {
+ left: 2%;
+ right: 0;
+ bottom: 5px;
+ }
+ .os-code {
+ font-size: 9px;
+ }
+ .os-code-line {
+ min-height: 19px;
+ }
+ .os-window-caption {
+ font-size: 8px;
+ }
+ .os-ecosystem-inner > div {
+ gap: 16px;
+ }
+ .os-ecosystem a {
+ font-size: 13px;
+ }
+ .os-workload {
+ padding: 23px 19px;
+ }
+ .os-workload p {
+ min-height: 110px;
+ }
+ .os-fast-section,
+ .os-start-section {
+ gap: 45px;
+ }
+ .os-benchmark {
+ padding: 25px;
+ }
+ .os-benchmark strong {
+ font-size: 43px;
+ }
+ .os-benchmark-stats > div + div {
+ padding-left: 20px;
+ }
+ .os-sdk-tabs {
+ gap: 12px;
+ }
+}
+@media (max-width: 800px) {
+ .os-hero-grid {
+ grid-template-columns: 1fr;
+ padding-top: 50px;
+ gap: 20px;
+ }
+ .os-hero-copy {
+ text-align: center;
+ }
+ .os-hero h1 {
+ font-size: 72px;
+ }
+ .os-hero-description {
+ margin-inline: auto;
+ max-width: 460px;
+ }
+ .os-actions,
+ .os-open-source {
+ justify-content: center;
+ }
+ .os-hero-note {
+ margin-top: 15px;
+ }
+ .os-open-source {
+ margin-top: 22px;
+ }
+ .os-stage {
+ width: min(580px, 100%);
+ height: 530px;
+ margin: 0 auto;
+ }
+ .os-execution-window {
+ left: 7%;
+ right: 7%;
+ }
+ .os-code {
+ font-size: 11px;
+ }
+ .os-sandbox-art {
+ left: -15px;
+ }
+ .os-art-label-tools {
+ top: 160px;
+ }
+ .os-stage-aura {
+ left: 100px;
+ }
+ .os-nebula-blue {
+ left: 5%;
+ top: 420px;
+ }
+ .os-nebula-violet {
+ left: 10%;
+ top: 150px;
+ }
+ .os-horizon {
+ left: -10%;
+ top: 630px;
+ }
+ .os-ecosystem-inner {
+ align-items: flex-start;
+ flex-direction: column;
+ gap: 17px;
+ padding-block: 25px;
+ }
+ .os-ecosystem-inner > div {
+ width: 100%;
+ flex-wrap: wrap;
+ justify-content: flex-start;
+ gap: 18px 26px;
+ }
+ .os-ecosystem a {
+ font-size: 14px;
+ }
+ .os-section {
+ padding-block: 65px;
+ }
+ .os-section-heading {
+ align-items: flex-start;
+ flex-direction: column;
+ gap: 18px;
+ margin-bottom: 27px;
+ }
+ .os-workload-grid {
+ grid-template-columns: repeat(2, minmax(0, 1fr));
+ }
+ .os-workload {
+ padding: 26px;
+ }
+ .os-workload:nth-child(3) {
+ border-left: 0;
+ }
+ .os-workload:nth-child(n + 3) {
+ border-top: 1px solid var(--os-border);
+ }
+ .os-workload p {
+ min-height: 67px;
+ }
+ .os-fast-section,
+ .os-start-section {
+ grid-template-columns: 1fr;
+ gap: 30px;
+ padding-block: 38px 60px;
+ }
+ .os-fast-copy > p:not(.os-section-kicker) {
+ max-width: 550px;
+ }
+ .os-benchmark-stats {
+ grid-template-columns: 1fr 1fr;
+ }
+ .os-benchmark strong {
+ font-size: 52px;
+ }
+ .os-heading-description {
+ max-width: 540px;
+ }
+ .os-control-grid {
+ gap: 25px;
+ }
+ .os-control-item h3 {
+ font-size: 13px;
+ }
+ .os-control-item p {
+ font-size: 11px;
+ }
+ .os-start-copy > p:not(.os-section-kicker) {
+ max-width: 450px;
+ }
+ .os-sdk-tabs {
+ gap: 23px;
+ }
+ .os-setup-window {
+ padding: 26px;
+ }
+ .os-server-code {
+ font-size: 11px;
+ }
+ .os-install-command code {
+ font-size: 11px;
+ }
+ .os-community {
+ flex-direction: column;
+ align-items: flex-start;
+ }
+}
+@media (max-width: 480px) {
+ .os-particle:nth-child(n + 13) {
+ display: none;
+ }
+ .os-aurora-ribbon {
+ left: -15%;
+ top: 350px;
+ width: 650px;
+ opacity: 0.65;
+ }
+ .os-shell {
+ width: calc(100% - 40px);
+ }
+ .os-hero-grid {
+ padding-top: 35px;
+ padding-bottom: 30px;
+ gap: 0;
+ }
+ .os-hero h1 {
+ font-size: clamp(48px, 12.8vw, 61px);
+ letter-spacing: -3px;
+ }
+ .os-hero-description {
+ font-size: 14px;
+ line-height: 1.85;
+ margin-top: 22px;
+ }
+ .os-actions {
+ gap: 10px;
+ margin-top: 25px;
+ }
+ .os-button {
+ padding-inline: 16px;
+ font-size: 11px;
+ min-height: 44px;
+ gap: 12px;
+ }
+ .os-open-source {
+ font-size: 9px;
+ gap: 7px;
+ margin-top: 18px;
+ }
+ .os-hero-note {
+ font-size: 10px;
+ }
+ .os-stage {
+ height: 420px;
+ margin-top: 8px;
+ }
+ .os-sandbox-art {
+ top: -5px;
+ width: 490px;
+ max-width: 130%;
+ left: -12%;
+ }
+ .os-stage-aura {
+ width: 230px;
+ left: 50px;
+ top: 0;
+ }
+ .os-art-label-agent {
+ top: 31px;
+ left: 40%;
+ font-size: 8px;
+ padding: 5px 8px;
+ }
+ .os-art-label-tools {
+ display: none;
+ }
+ .os-execution-window {
+ left: 0;
+ right: 0;
+ bottom: -5px;
+ border-radius: 8px;
+ }
+ .os-window-bar {
+ padding-inline: 12px;
+ min-height: 34px;
+ font-size: 9px;
+ gap: 10px;
+ }
+ .os-window-caption {
+ font-size: 8px;
+ }
+ .os-code {
+ font-size: 9px;
+ padding: 11px;
+ }
+ .os-line-number {
+ width: 22px;
+ font-size: 8px;
+ }
+ .os-code-line {
+ min-height: 18px;
+ }
+ .os-code-output {
+ font-size: 9px;
+ padding-block: 10px;
+ }
+ .os-ecosystem-inner {
+ padding-block: 23px;
+ gap: 15px;
+ }
+ .os-ecosystem-inner > div {
+ gap: 13px 23px;
+ }
+ .os-ecosystem a {
+ font-size: 12px;
+ }
+ .os-stack-divider {
+ display: none;
+ }
+ .os-section {
+ padding-block: 54px;
+ }
+ .os-home h2 {
+ font-size: 31px;
+ letter-spacing: -1.4px;
+ }
+ .os-section-kicker {
+ font-size: 10px;
+ }
+ .os-workload-grid {
+ grid-template-columns: 1fr;
+ }
+ .os-workload {
+ padding: 23px;
+ }
+ .os-workload + .os-workload {
+ border-left: 0;
+ border-top: 1px solid var(--os-border);
+ }
+ .os-workload-top {
+ margin-bottom: 20px;
+ }
+ .os-workload p {
+ min-height: 0;
+ max-width: 320px;
+ }
+ .os-home h3 {
+ font-size: 16px;
+ }
+ .os-benchmark {
+ padding: 22px 19px;
+ }
+ .os-benchmark strong {
+ font-size: 42px;
+ }
+ .os-benchmark strong span {
+ font-size: 18px;
+ }
+ .os-benchmark-stats > div + div {
+ padding-left: 18px;
+ }
+ .os-benchmark-stats p {
+ font-size: 8px;
+ }
+ .os-runtime-flow {
+ font-size: 8px;
+ gap: 8px;
+ }
+ .os-control-grid {
+ grid-template-columns: 1fr;
+ gap: 30px;
+ }
+ .os-control-item {
+ position: relative;
+ padding-left: 50px;
+ padding-top: 20px;
+ }
+ .os-control-item > svg {
+ position: absolute;
+ width: 30px;
+ height: 30px;
+ left: 0;
+ top: 22px;
+ }
+ .os-control-item h3 {
+ font-size: 14px;
+ }
+ .os-control-item p {
+ font-size: 12px;
+ margin-top: 8px;
+ }
+ .os-setup-window {
+ padding: 20px 16px;
+ }
+ .os-setup-step > span:last-child:not(.os-step-number) {
+ font-size: 8px;
+ }
+ .os-setup-step h3 {
+ font-size: 11px;
+ }
+ .os-sdk-tabs {
+ gap: 0;
+ justify-content: space-between;
+ }
+ .os-sdk-tabs button {
+ font-size: 9px;
+ min-height: 44px;
+ padding-block: 10px;
+ }
+ .os-install-command button {
+ min-height: 36px;
+ }
+ .os-server-code {
+ font-size: 9px;
+ }
+ .os-install-command code {
+ font-size: 9px;
+ }
+ .os-community {
+ font-size: 11px;
+ }
+ .os-community > div {
+ gap: 23px;
+ font-size: 10px;
+ }
+}
+@media (prefers-reduced-motion: reduce) {
+ .os-particles {
+ display: none;
+ }
+ .os-home *,
+ .os-home *::before,
+ .os-home *::after {
+ animation: none !important;
+ transition: none !important;
+ }
+ .os-stage {
+ transform: none !important;
+ }
+}
diff --git a/docs/architecture/network/egress.md b/docs/architecture/network/egress.md
index 63e47b153..89dee2791 100644
--- a/docs/architecture/network/egress.md
+++ b/docs/architecture/network/egress.md
@@ -25,7 +25,7 @@ Egress is how a sandbox gets a network policy instead of open internet access. I
- **Layer 1 — DNS.** All port-53 traffic is redirected into the sidecar's DNS proxy. Denied domains answer `NXDOMAIN`; allowed domains resolve through to the real upstream, and their resolved addresses are recorded.
- **Layer 2 — Network (`dns+nft` mode).** nftables drops everything not explicitly allowed. Allowed traffic passes by static rule or via DNS-learned address sets: a resolved IP receives a bounded lease (with a grace window for active TCP connections), so "allowed" never silently becomes "allowed forever". UDP and QUIC flows rely on DNS lease timing alone.
-- **Precedence.** First matching rule wins: platform `deny.always`, then platform `allow.always`, then your policy — the platform's deny always beats your allow. Overlays live inside the sidecar image and hot-reload every minute; a reload publishes only after nftables accepts the corresponding static policy. Parse or apply failures keep the last accepted in-memory rules and stay eligible for retry.
+- <span id="precedence"></span>**Precedence.** First matching rule wins: platform `deny.always`, then platform `allow.always`, then your policy — the platform's deny always beats your allow. Overlays live inside the sidecar image and hot-reload every minute; a reload publishes only after nftables accepts the corresponding static policy. Parse or apply failures keep the last accepted in-memory rules and stay eligible for retry.
- **Runtime mutation.** Your policy is set per sandbox and can be mutated at runtime (add, replace, remove by target) through the API the SDKs expose.
**Port floor.** Operators can also ship an `reachable.ports.cap` file next to the overlays: a whitelist of TCP ports (one port or `lo-hi` range per line) that are reachable **at all**. The sidecar derives the complement and enforces it as an always-deny ahead of every user rule — so regardless of what a sandbox's `defaultAction` or allow rules say, only the whitelisted ports pass (TCP only; the same fail-closed ordering that makes a deny rule win over any allow). A missing or empty file means no floor. Under transparent MITM, intercepted ports are governed by the interception config, so keep intercepted ports within the whitelist. Note established connections persist until their lease expires, as with any policy change.
diff --git a/docs/examples/github-copilot-cli-sandbox.md b/docs/examples/github-copilot-cli-sandbox.md
index b24821818..641a22fa7 100644
--- a/docs/examples/github-copilot-cli-sandbox.md
+++ b/docs/examples/github-copilot-cli-sandbox.md
@@ -69,4 +69,4 @@ Never commit a GitHub token. If a token is exposed in terminal output, documenta
- [GitHub Copilot CLI](https://github.com/github/copilot-cli)
- [GitHub Copilot CLI quickstart](https://docs.github.com/en/copilot/get-started/cli-quickstart)
-- [Source code](https://github.com/opensandbox-group/OpenSandbox/tree/main/examples/github-copilot)
+- [Source code](https://github.com/opensandbox-group/OpenSandbox/tree/main/examples/github-copilot-cli-sandbox)
diff --git a/docs/examples/microsoft-agent-framework.md b/docs/examples/microsoft-agent-framework.md
index b8e330dd5..940ef2350 100644
--- a/docs/examples/microsoft-agent-framework.md
+++ b/docs/examples/microsoft-agent-framework.md
@@ -114,6 +114,6 @@ The workflow writes and executes a small Python job in the sandbox, then passes
## References
- [Microsoft Agent Framework Python samples](https://github.com/microsoft/agent-framework/tree/main/python/samples)
-- [Functional workflow with agents](https://github.com/microsoft/agent-framework/blob/main/python/samples/01-get-started/05_functional_workflow_with_agents.py)
+- [Functional workflow with agents](https://github.com/microsoft/agent-framework/blob/main/python/samples/01-get-started/05b_functional_workflow_with_agents.py)
- [OpenSandbox](https://github.com/opensandbox-group/OpenSandbox)
- [Source code on GitHub](https://github.com/opensandbox-group/OpenSandbox/tree/main/examples/microsoft-agent-framework)
diff --git a/docs/index.md b/docs/index.md
index 54d4b6452..a6d47aad3 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,83 +1,14 @@
---
-layout: home
-
-hero:
- name: OpenSandbox
- text: Universal Sandbox Infrastructure for AI Applications
- tagline: Securely run commands, code interpreters, browsers, and developer tools in isolated environments with multi-language SDKs.
- actions:
- - theme: brand
- text: Quick Start
- link: /getting-started/
- - theme: alt
- text: Architecture
- link: /architecture/
- - theme: alt
- text: SDKs
- link: /sdks/
-
-features:
- - title: Sandbox Lifecycle Management
- details: Provision, monitor, renew, pause/resume, and terminate sandbox instances with Docker and Kubernetes runtimes.
- - title: Multi-Language SDKs
- details: Build with Python, Java/Kotlin, JavaScript/TypeScript, C#/.NET, and Go SDKs on top of standardized lifecycle and execution protocols.
- - title: In-Sandbox Execution
- details: Execute shell commands, manage files, run multi-language code interpreters, expose ports, and stream logs and metrics.
- - title: Built for AI Workloads
- details: Supports coding agents, browser automation, remote development, code execution, and reinforcement learning scenarios.
+title: Run AI agents on your own infrastructure
+description: OpenSandbox gives AI agents isolated environments to execute code, run commands, and operate browsers or desktops. Start with Docker and scale on Kubernetes.
+layout: page
+pageClass: sandbox-home
+sidebar: false
+aside: false
---
-## Typical Scenarios
-
-OpenSandbox is listed in the [CNCF Landscape](https://landscape.cncf.io/?item=orchestration-management--scheduling-orchestration--opensandbox).
-
-<div class="scenario-grid">
- <a class="scenario-card" href="/examples/claude-code">
- <h3>Coding Agents</h3>
- <p>Run Claude Code, Gemini CLI, Codex, and other coding agents in isolated sandboxes.</p>
- </a>
- <a class="scenario-card" href="/examples/playwright">
- <h3>Browser Automation</h3>
- <p>Execute Chrome and Playwright workloads with controlled runtime, filesystem, and networking.</p>
- </a>
- <a class="scenario-card" href="/examples/vscode">
- <h3>Remote Development</h3>
- <p>Host VS Code Web and desktop-like environments for secure cloud development workflows.</p>
- </a>
- <a class="scenario-card" href="/examples/code-interpreter">
- <h3>AI Code Execution</h3>
- <p>Run model-generated code safely, stream outputs, and iterate quickly with reproducible environments.</p>
- </a>
-</div>
-
-Explore all examples in [Examples](/examples/).
-
-## Quick Install
-
-::: code-group
-
-```bash [Python SDK]
-pip install opensandbox
-```
-
-```bash [JavaScript SDK]
-npm install @alibaba-group/opensandbox
-```
-
-```kotlin [Kotlin (Gradle)]
-dependencies {
- implementation("com.alibaba.opensandbox:sandbox:{latest_version}")
-}
-```
-
-```bash [Go SDK]
-go get github.com/alibaba/OpenSandbox/sdks/sandbox/go
-```
-
-```bash [C# SDK]
-dotnet add package Alibaba.OpenSandbox
-```
-
-:::
+<script setup>
+import HomePage from './.vitepress/theme/HomePage.vue'
+</script>
-See [Getting Started](/getting-started/) for the full setup guide.
+<HomePage />
diff --git a/docs/sdks/csharp.md b/docs/sdks/csharp.md
index 70b9e954a..0ef882aa1 100644
--- a/docs/sdks/csharp.md
+++ b/docs/sdks/csharp.md
@@ -433,7 +433,7 @@ Read current sandbox resource usage with `await sandbox.Metrics.GetMetricsAsync(
| Create from a published template | `Sandbox.CreateFromTemplateAsync` with `SandboxCreateFromTemplateOptions` |
| Patch metadata | `sandbox.PatchMetadataAsync` or `manager.PatchSandboxMetadataAsync` |
-Poll snapshot status before restoring. Template builds are asynchronous; wait for `Succeeded` before use. Template-backed creation requires `TimeoutSeconds` and inherits workload configuration from the published template. Metadata patch values add/replace keys; `null` deletes a key. See the [lifecycle contract](/api/#1-sandbox-lifecycle-yml) for backend constraints.
+Poll snapshot status before restoring. Template builds are asynchronous; wait for `Succeeded` before use. Template-backed creation requires `TimeoutSeconds` and inherits workload configuration from the published template. Metadata patch values add/replace keys; `null` deletes a key. See the [lifecycle contract](/api/#_1-sandbox-lifecycle-yml) for backend constraints.
Snapshot support depends on the runtime and server configuration. Renew the source sandbox first if its remaining TTL may expire during snapshot creation. This example waits up to 15 minutes and retains the snapshot for reuse:
diff --git a/docs/sdks/javascript.md b/docs/sdks/javascript.md
index adbbdc774..58b8d196a 100644
--- a/docs/sdks/javascript.md
+++ b/docs/sdks/javascript.md
@@ -422,7 +422,7 @@ Read current sandbox resource usage with `await sandbox.getMetrics()`. This is s
| Create from a published template | `Sandbox.createFromTemplate({ templateId, timeoutSeconds, connectionConfig })` |
| Patch metadata | `sandbox.patchMetadata` or `manager.patchSandboxMetadata` |
-Poll snapshot status before restoring. Template builds are asynchronous; wait for `status.phase === "Succeeded"` before use. Template-backed creation requires a TTL and inherits workload configuration from the published template. Metadata patch values add/replace keys; `null` deletes a key. See the [lifecycle contract](/api/#1-sandbox-lifecycle-yml) for backend constraints.
+Poll snapshot status before restoring. Template builds are asynchronous; wait for `status.phase === "Succeeded"` before use. Template-backed creation requires a TTL and inherits workload configuration from the published template. Metadata patch values add/replace keys; `null` deletes a key. See the [lifecycle contract](/api/#_1-sandbox-lifecycle-yml) for backend constraints.
Snapshot support depends on the runtime and server configuration. Renew the source sandbox first if its remaining TTL may expire during snapshot creation. Wait for `Ready` before restoring; the snapshot remains available after this example:
diff --git a/docs/sdks/kotlin.md b/docs/sdks/kotlin.md
index d0b1a5748..001cbb1a4 100644
--- a/docs/sdks/kotlin.md
+++ b/docs/sdks/kotlin.md
@@ -438,7 +438,7 @@ Create-latency reporting is controlled separately by [SDK Telemetry](/sdks/obser
Create a snapshot with `sandbox.createSnapshot` or `manager.createSnapshot`. `SandboxManager` exposes `getSnapshot`, `listSnapshots`, `deleteSnapshot`, and `waitForSnapshotReady` to wait for asynchronous snapshot completion. Restore with `Sandbox.builder().snapshotId(snapshotId).connectionConfig(config).build()`.
-Use `sandbox.patchMetadata` or `manager.patchSandboxMetadata` to add/replace metadata keys; a `null` value removes a key. Runtime support is described by the [lifecycle contract](/api/#1-sandbox-lifecycle-yml).
+Use `sandbox.patchMetadata` or `manager.patchSandboxMetadata` to add/replace metadata keys; a `null` value removes a key. Runtime support is described by the [lifecycle contract](/api/#_1-sandbox-lifecycle-yml).
Snapshot support depends on the runtime and server configuration. Renew the source sandbox first if its remaining TTL may expire during snapshot creation. The JVM helper waits for `Ready` and raises an exception on failure or timeout:
diff --git a/docs/sdks/python.md b/docs/sdks/python.md
index 590208012..0d3fe831c 100644
--- a/docs/sdks/python.md
+++ b/docs/sdks/python.md
@@ -463,7 +463,7 @@ Read current sandbox resource usage with `await sandbox.get_metrics()`. This is
| Create from a published template | `Sandbox.create_from_template(template_id, timeout=..., connection_config=config)` |
| Patch metadata | `sandbox.patch_metadata` or `manager.patch_sandbox_metadata` |
-These APIs also exist on the synchronous SDK. Snapshot creation and template builds are asynchronous: inspect status before restoring or using a template. Templates must reach `Succeeded`; template-backed creation requires a TTL and inherits environment, resources, volumes, and lifecycle hooks from the template. Metadata patch values add/replace keys; `None` deletes a key. See the [lifecycle contract](/api/#1-sandbox-lifecycle-yml) for backend constraints.
+These APIs also exist on the synchronous SDK. Snapshot creation and template builds are asynchronous: inspect status before restoring or using a template. Templates must reach `Succeeded`; template-backed creation requires a TTL and inherits environment, resources, volumes, and lifecycle hooks from the template. Metadata patch values add/replace keys; `None` deletes a key. See the [lifecycle contract](/api/#_1-sandbox-lifecycle-yml) for backend constraints.
Snapshot support depends on the runtime and server configuration. Renew the source sandbox first if its remaining TTL may expire during snapshot creation. This example waits up to 15 minutes, restores a new sandbox, and retains the snapshot for reuse: