Skip to content

A Sandbox supplies compute for Project development: running commands, preparing dependencies, and serving a working preview. It supports the editing process while a Site remains the separately managed production destination.

Start with a working preview

Open the Project’s Sandbox view. If the environment is stopped, choose Actions → Start. Ask the Project to serve a page containing “Preview check”, then choose Open preview in Sandbox. In the Browser view, check that the page shows “Preview check”. Change it to “Preview updated” and reload. If the first version persists, inspect the development server output in Terminal. To put the page at a visitor-facing address, follow Release a first Site.

Work in development

Use the Project's working environment to make a change, run the relevant checks, and inspect the application preview. Confirm the preview reflects the code you intend to evaluate before releasing it.

  • Project source and working files describe what you are developing.
  • Development configuration supplies the authorized resources for that work.
  • The Sandbox runs the commands and processes needed for development.
  • A Site runs an explicitly selected production release.

Diagnose an unavailable preview

Start with Sandbox state, then inspect process output in Logs. A stopped environment, failed dependency installation, application startup error, and application authorization failure require different responses.

SymptomCheck
No preview is availableEnvironment and application startup state
The application fails to startDependency, build, and process output
The page opens but a feature failsApplication errors and development service configuration
Production behaves differentlyThe Site's release, credentials, and data

Restarting compute is not a substitute for fixing an application error. Preserve the evidence needed to understand a failure before repeating the operation.

Understand persistence and cost

Compute allocation and retained data have different lifecycles. A stopped runtime does not imply that its retained storage is free or deleted. Sandbox execution follows its own lifecycle and accounting; production VM lifecycle choices are separate.

Chats and Agents can use bounded execution for tasks without becoming Project development environments. A durable File system alone does not supply a persistent application backend. See Runtimes and File system.

Example: inspect a new form

After adding a form to a Project, use its working preview to submit valid and incomplete inputs. If the preview is unavailable, inspect the development process output before repeatedly restarting the Sandbox.

Check the source revision being served and the configured development services. Continue with Project development, then Testing before release.

Availability

Use this guide for Project development Sandboxes. For a Chat or Agent task, inspect the conversation's execution evidence and working files instead of looking for a Project Sandbox. For a production failure, begin with the affected Site.