sandbox-agent/docs
Jordan Coeyman cc5a9e0d73
docs: add Cloudflare Sandbox SDK deployment guide (#57)
* docs: add Cloudflare Sandbox SDK deployment guide

- Add docs/deploy/cloudflare.mdx with full deployment guide
- Add examples/cloudflare/ with working Worker code
- Update docs navigation to include Cloudflare option
- Update deploy index page with Cloudflare card

The example shows how to run sandbox-agent inside a Cloudflare Sandbox
with exposed ports for API access.

Co-authored-by: Shelley <shelley@exe.dev>

* fix: guard server startup to avoid port conflicts

Add health check before starting sandbox-agent to prevent 'address already
in use' errors on subsequent requests. The isServerRunning() function probes
the health endpoint to determine if setup should be skipped.

Co-authored-by: Shelley <shelley@exe.dev>

* fix: default cloudflare/sandbox:0.7.0 (latest does not exist)

* feat(cloudflare): add React frontend and improve deployment docs

- Add React + Vite frontend for Cloudflare example with sandbox-agent SDK
- Update ensureRunning to poll health endpoint instead of fixed wait
- Fix SDK fetch binding issue (globalThis.fetch.bind)
- Update docs with .dev.vars format warning and container caching tip
- Use containerFetch proxy pattern for reliable local dev

---------

Co-authored-by: Shelley <shelley@exe.dev>
Co-authored-by: Nathan Flurry <git@nathanflurry.com>
Co-authored-by: Nathan Flurry <developer@nathanflurry.com>
2026-02-03 02:15:34 -08:00
..
ai fix: fix bun install bug (#62) 2026-02-02 21:12:41 -08:00
deploy docs: add Cloudflare Sandbox SDK deployment guide (#57) 2026-02-03 02:15:34 -08:00
images docs: documentation overhaul and universal schema reference (#10) 2026-01-28 05:07:15 -08:00
logo chore(site): links and image updates 2026-01-28 02:16:37 -08:00
sdks fix: fix bun install bug (#62) 2026-02-02 21:12:41 -08:00
building-chat-ui.mdx i need to update the terminology of 'capabilities' to 'feature coverage' in the inspector ui and anywhere else its mentioned thats not in the actual api (#61) 2026-02-02 19:00:35 -08:00
cli.mdx fix: correct inspector package name in Dockerfiles and add .dockerignore (#50) 2026-02-01 23:03:51 -08:00
conversion.mdx feat: add Claude adapter improvements for HITL support (#30) 2026-01-29 07:19:10 -08:00
cors.mdx fix: correct inspector package name in Dockerfiles and add .dockerignore (#50) 2026-02-01 23:03:51 -08:00
docs.json docs: add Cloudflare Sandbox SDK deployment guide (#57) 2026-02-03 02:15:34 -08:00
favicon.svg chore(site): diagram mobile and favicon 2026-01-31 22:49:01 -08:00
inspector.mdx fix: correct inspector package name in Dockerfiles and add .dockerignore (#50) 2026-02-01 23:03:51 -08:00
manage-sessions.mdx docs: documentation overhaul and universal schema reference (#10) 2026-01-28 05:07:15 -08:00
openapi.json fix: fix bun install bug (#62) 2026-02-02 21:12:41 -08:00
quickstart.mdx fix: fix bun install bug (#62) 2026-02-02 21:12:41 -08:00
session-transcript-schema.mdx i need to update the terminology of 'capabilities' to 'feature coverage' in the inspector ui and anywhere else its mentioned thats not in the actual api (#61) 2026-02-02 19:00:35 -08:00
telemetry.mdx docs: documentation overhaul and universal schema reference (#10) 2026-01-28 05:07:15 -08:00
theme.css docs: documentation overhaul and universal schema reference (#10) 2026-01-28 05:07:15 -08:00
troubleshooting.mdx fix: detect musl/glibc at runtime for correct Claude binary download 2026-01-28 04:19:35 -08:00