sandbox-stable

1# Sandbox SDK — stable package
2 
3Isolated Linux environments on [Cloudflare Containers](https://developers.cloudflare.com/containers/index.md), driven from Workers.
4 
5**Prefer the main Sandbox docs and installed stable types over memory.** This skill is a gate, a contract, and a retrieval map—not a full manual.
6 
7This line is the **current stable** default npm package. The main [Sandbox documentation](https://developers.cloudflare.com/sandbox/index.md) describes it. Existing apps can stay here and keep shipping.
8 
9We recommend **new projects** on `@cloudflare/sandbox@next` with **`sandbox-next`**. When you can, plan a move with **`sandbox-migrate-to-next`** so you are ready when 1.0 becomes the stable release. Do not force that port unless the user asks.
10 
11## 1. Gate — confirm the package line
12 
13Before writing code, inspect the app:
14 
15| Check | Must match |
16| ----- | ---------- |
17| npm dependency | Default `@cloudflare/sandbox` (**not** `@next` / preview tags) |
18| Container image | Matching **stable** image (not `cloudflare/sandbox:next`) |
19 
20| If you find… | Action |
21| ------------ | ------ |
22| `@cloudflare/sandbox@next` or a `next` image | **Stop.** Load **`sandbox-next`**. |
23| User wants to port to 1.0 / `@next` | **Stop.** Load **`sandbox-migrate-to-next`**. Do not half-apply preview APIs on a stable package. |
24…