sootsim upload

publish the current recorded bundle as a shareable /preview/<id> link

sootsim upload

Capture the currently-loaded bundle + device spec from a running sim and publish it to a shareable /preview/<id> URL. Unlisted-public (unguessable id), requires signed-in desktop auth. A preview must include playback data: pass a gzipped event stream with --events or a webm/mp4/gif recording with --video. The recording embeds inline in the preview page and in any PR sticky comment.

terminal

sootsim upload [options]

Options

flagdescription
--origin <url>upload target (default: auto — prefers localhost, falls back to sootbean.com). Override with SOOTSIM_UPLOAD_ORIGIN env var
--public-origin <url>public preview link origin (default: sootsim.com for prod uploads). Override with SOOTSIM_PREVIEW_ORIGIN env var
--events <path>path to a gzipped events .jsonl.gz file to attach; required unless —video is present
--screenshot <path>path to a PNG thumbnail to attach to the share
--video <path>path to a webm/mp4/gif flow recording — embedded inline in the preview page
--owner <org>associate a session upload with a linked org repo; pass with —repo
--repo <repo>repo name for —owner; the signed-in user must belong to the owning org team
--sim <sim>target a specific sim (see: sootsim list)
--openopen the resulting /preview/<id> url in the browser
--assets-onlydrop API/JSON/HTML records before upload; keep only images, fonts, css, js, and binary blobs. live-data demos hit the real network at replay time instead of serving recorded API snapshots

Examples

terminal

sootsim upload --origin http://localhost:3000 --events ./my-run.jsonl.gz --open
sootsim upload --events ./my-run.jsonl.gz
sootsim upload --video /tmp/soot-flow.webm --video-duration-ms 12000
sootsim upload --events ./my-run.jsonl.gz --assets-only

Ready to build?

Run your React Native app in the browser. No simulators, no native toolchain, no waiting.

npm i -g sootsim