Skip to content

[Sandbox] Reframe sandboxes on cloudflare - #33302

Draft
ghostwriternr wants to merge 4 commits into
productionfrom
sandbox/sandboxes-on-cloudflare
Draft

[Sandbox] Reframe sandboxes on cloudflare#33302
ghostwriternr wants to merge 4 commits into
productionfrom
sandbox/sandboxes-on-cloudflare

Conversation

@ghostwriternr

@ghostwriternr ghostwriternr commented Sep 8, 2026

Copy link
Copy Markdown
Member

WIP: This PR is NOT READY for review.

Summary

As the sandbox SDK becomes leaner towards providing useful utilities and DX beyond what the runtime itself offers, shift the /sandbox navigation to be an overhauled space for 'Sandboxes on Cloudflare', building on top of Dynamic Workers and Containers and covering all sorts of sandbox use-cases we've discovered and how we support them. The leaner SDK utils will also be documented alongside how users can use containers.

Existing @cloudflare/sandbox docs move under /sandbox/sdk/, where the legacy SDK remains documented for existing users, while keeping new user focus entirely on the platform bindings and the new runtime.

Screenshots (optional)

Documentation checklist

  • The change adheres to the documentation style guide.
  • If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.
  • Files which have changed name or location have been allocated redirects.

Purge unused 1.0 preview docs. Move existing Sandbox SDK
pages under /sandbox/sdk/. Leave /sandbox/ as a short
overview of Dynamic Workers and Containers.

Rename the product nav and AI menu link to Sandboxes.
Explain sandboxes as isolated places to run untrusted work,
then route to Dynamic Workers and Containers.
Redirects already send old /sandbox paths to /sandbox/sdk.
Keep published changelog bodies as they went out.
@github-actions github-actions Bot added product:reference-architecture product:_redirects product:changelog product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. product:containers product:sandbox product:artifacts http://developers.cloudflare.com/artifacts/ size/xl labels Sep 8, 2026
@github-actions

github-actions Bot commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

This PR changes current filenames or deletes current files. Make sure you have redirects set up to cover the following paths:

  • /sandbox/1-0-preview/api/errors/
  • /sandbox/1-0-preview/api/
  • /sandbox/1-0-preview/api/interpreter/
  • /sandbox/1-0-preview/api/processes/
  • /sandbox/1-0-preview/api/terminals/
  • /sandbox/1-0-preview/environment/
  • /sandbox/1-0-preview/errors/
  • /sandbox/1-0-preview/extensions/
  • /sandbox/1-0-preview/get-started/
  • /sandbox/1-0-preview/
  • /sandbox/1-0-preview/interpreter/
  • /sandbox/1-0-preview/lifecycle/
  • /sandbox/1-0-preview/migrate/
  • /sandbox/1-0-preview/processes/
  • /sandbox/1-0-preview/terminals/
  • /sandbox/1-0-preview/troubleshooting/
  • /sandbox/concepts/
  • /sandbox/api/backups/
  • /sandbox/api/commands/
  • /sandbox/api/file-watching/
  • /sandbox/api/files/
  • /sandbox/api/
  • /sandbox/api/interpreter/
  • /sandbox/api/lifecycle/
  • /sandbox/api/ports/
  • /sandbox/api/sessions/
  • /sandbox/api/storage/
  • /sandbox/api/terminal/
  • /sandbox/api/tunnels/
  • /sandbox/bridge/http-api/
  • /sandbox/bridge/
  • /sandbox/concepts/architecture/
  • /sandbox/concepts/backup-restore/
  • /sandbox/concepts/containers/
  • /sandbox/concepts/preview-urls/
  • /sandbox/concepts/sandboxes/
  • /sandbox/concepts/security/
  • /sandbox/concepts/sessions/
  • /sandbox/concepts/terminal/
  • /sandbox/configuration/dockerfile/
  • /sandbox/configuration/environment-variables/
  • /sandbox/configuration/
  • /sandbox/configuration/sandbox-options/
  • /sandbox/configuration/transport/
  • /sandbox/configuration/wrangler/
  • /sandbox/get-started/
  • /sandbox/guides/2026-deprecation/
  • /sandbox/guides/background-processes/
  • /sandbox/guides/backup-restore/
  • /sandbox/guides/browser-terminals/
  • /sandbox/guides/code-execution/
  • /sandbox/guides/deploy/
  • /sandbox/guides/docker-in-docker/
  • /sandbox/guides/execute-commands/
  • /sandbox/guides/expose-services/
  • /sandbox/guides/file-watching/
  • /sandbox/guides/git-workflows/
  • /sandbox/guides/
  • /sandbox/guides/manage-files/
  • /sandbox/guides/mount-buckets/
  • /sandbox/guides/outbound-traffic/
  • /sandbox/guides/preview-urls-custom-domain/
  • /sandbox/guides/proxy-requests/
  • /sandbox/guides/streaming-output/
  • /sandbox/guides/websocket-connections/
  • /sandbox/guides/workers-connections/
  • /sandbox/platform/
  • /sandbox/platform/limits/
  • /sandbox/platform/pricing/
  • /sandbox/tutorials/ai-code-executor/
  • /sandbox/tutorials/analyze-data-with-ai/
  • /sandbox/tutorials/automated-testing-pipeline/
  • /sandbox/tutorials/claude-code/
  • /sandbox/tutorials/claude-managed-agents/
  • /sandbox/tutorials/code-review-bot/
  • /sandbox/tutorials/cursor-cloud-agents/
  • /sandbox/tutorials/devin-outposts/
  • /sandbox/tutorials/openai-agents/
  • /sandbox/tutorials/persistent-storage/
  • /sandbox/tutorials/workers-ai-code-interpreter/
  • /sandbox/tutorials/

@ghostwriternr ghostwriternr changed the title [Sandbox] Reframe /sandbox as a docs hub [Sandbox] Reframe sandboxes on cloudflare Sep 8, 2026
@github-actions

github-actions Bot commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/public/__redirects @cloudflare/product-owners, @cloudflare/content-engineering
/src/components/ @kodster28, @cloudflare/content-engineering
/src/content/changelog/sandbox/ @cloudflare/ai-agents, @cloudflare/pm-changelogs, @cloudflare/product-owners
/src/content/directory/sandbox.yaml @cloudflare/ai-agents, @cloudflare/product-owners
/src/content/docs/agents/ @irvinebroque, @rita3ko, @cloudflare/ai-agents, @cloudflare/dev-plat-leads, @cloudflare/product-owners
/src/content/docs/artifacts/ @dinasaur404, @dmmulroy, @mattzcarey, @zebp, @cloudflare/product-owners
/src/content/docs/containers/ @mikenomitch, @th0m, @cloudflare/cloudchamber, @cloudflare/product-owners
/src/content/docs/reference-architecture/ @ncrouch-cflare, @securitypedant, @cloudflare/product-owners
/src/content/docs/sandbox/ @cloudflare/ai-agents, @cloudflare/product-owners

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Sep 8, 2026

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://sandbox-sandboxes-on-cloudflare.previews.developers.cloudflare.com (commit 2fc9b7d)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://10039cb4.previews.developers.cloudflare.com 2fc9b7d 2026-09-08T14:32:15.680Z Visit the dashboard ↗
  • Build: Failed ❌

View logs ↗
2f9124b 2026-09-08T14:11:17.842Z View logs ↗

ResourcesBySelector still looked under sandbox/guides and
sandbox/tutorials after the SDK move, so the build failed.
@github-actions

github-actions Bot commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

Preview URL: https://2fc9b7dd.preview.developers.cloudflare.com
Preview Branch URL: https://sandbox-sandboxes-on-cloudflare.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/sandbox/1-0-preview/api/processes/ https://sandbox-sandboxes-on-cloudflare.preview.developers.cloudflare.com/sandbox/1-0-preview/api/processes/
https://developers.cloudflare.com/sandbox/sdk/ https://sandbox-sandboxes-on-cloudflare.preview.developers.cloudflare.com/sandbox/sdk/
https://developers.cloudflare.com/sandbox/ https://sandbox-sandboxes-on-cloudflare.preview.developers.cloudflare.com/sandbox/
https://developers.cloudflare.com/sandbox/1-0-preview/api/errors/ https://sandbox-sandboxes-on-cloudflare.preview.developers.cloudflare.com/sandbox/1-0-preview/api/errors/
https://developers.cloudflare.com/sandbox/1-0-preview/api/terminals/ https://sandbox-sandboxes-on-cloudflare.preview.developers.cloudflare.com/sandbox/1-0-preview/api/terminals/
https://developers.cloudflare.com/sandbox/1-0-preview/migrate/ https://sandbox-sandboxes-on-cloudflare.preview.developers.cloudflare.com/sandbox/1-0-preview/migrate/
https://developers.cloudflare.com/sandbox/1-0-preview/processes/ https://sandbox-sandboxes-on-cloudflare.preview.developers.cloudflare.com/sandbox/1-0-preview/processes/
https://developers.cloudflare.com/sandbox/1-0-preview/ https://sandbox-sandboxes-on-cloudflare.preview.developers.cloudflare.com/sandbox/1-0-preview/
https://developers.cloudflare.com/sandbox/1-0-preview/errors/ https://sandbox-sandboxes-on-cloudflare.preview.developers.cloudflare.com/sandbox/1-0-preview/errors/
https://developers.cloudflare.com/sandbox/1-0-preview/terminals/ https://sandbox-sandboxes-on-cloudflare.preview.developers.cloudflare.com/sandbox/1-0-preview/terminals/
https://developers.cloudflare.com/sandbox/1-0-preview/api/interpreter/ https://sandbox-sandboxes-on-cloudflare.preview.developers.cloudflare.com/sandbox/1-0-preview/api/interpreter/
https://developers.cloudflare.com/sandbox/1-0-preview/environment/ https://sandbox-sandboxes-on-cloudflare.preview.developers.cloudflare.com/sandbox/1-0-preview/environment/
https://developers.cloudflare.com/sandbox/1-0-preview/get-started/ https://sandbox-sandboxes-on-cloudflare.preview.developers.cloudflare.com/sandbox/1-0-preview/get-started/
https://developers.cloudflare.com/sandbox/1-0-preview/lifecycle/ https://sandbox-sandboxes-on-cloudflare.preview.developers.cloudflare.com/sandbox/1-0-preview/lifecycle/
https://developers.cloudflare.com/sandbox/1-0-preview/troubleshooting/ https://sandbox-sandboxes-on-cloudflare.preview.developers.cloudflare.com/sandbox/1-0-preview/troubleshooting/

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. product:artifacts http://developers.cloudflare.com/artifacts/ product:changelog product:containers product:reference-architecture product:sandbox size/xl

Projects

None yet

Development

Successfully merging this pull request may close these issues.