Skip to main content
Get a small web app running inside a sandbox and reachable at a public preview URL — entirely from the bonya CLI. Every command below uses the bonya-dev template. If you haven’t installed the CLI or logged in yet, start with the Quickstart.
1

Create a sandbox

2

Checkpoint before installing anything

Snapshots here are one-way checkpoints — there’s no restore or list command in the CLI today (see Snapshots). Treat the id below as an insurance policy you’d manually rebuild from — a fresh sandbox plus reapplying your changes — not a one-command rollback.
3

Make a workspace directory

4

Upload the app as a tarball

fs upload moves exactly one file’s raw bytes per call — there’s no directory upload (see Files). Package the project locally first, then upload the single archive:
5

Extract it on the sandbox

tar prints nothing on success. Confirm the files landed:
6

Check for a language runtime before assuming it's there

Nothing guarantees a Node runtime is preinstalled on every template (see Templates) — check first, and only proceed with npm install if it succeeds. bonya-dev does include Node:
7

Install dependencies

8

Start the dev server in a managed session

A managed session keeps the process running after your terminal disconnects — unlike exec, which ends when the connection does (see Sessions). session create has no --cwd flag, so cd inside the command itself:
9

Publish a preview URL

token is the default auth mode — the URL alone isn’t enough to reach it; see Previews for the token exchange. Passing --auth public would skip that, at the cost of anyone with the URL being able to reach it.
10

Watch it running

Ctrl+D (or Ctrl+C once) detaches your terminal — it does not kill the session, unlike a plain exec.
11

Clean up

Tear down what this page created, in reverse order:

​
Next steps

Previews

Auth modes, capability upgrades, and preview limitations.

Expose a preview

The guide this tutorial’s preview step is based on.