Instant Preview

Instant Preview is the preview-first path: prove Rover on a live page before anything is installed. Start at Instant Preview. The website hosts preview creation and documents every path — Hosted Preview, the Preview Helper extension, console snippets, and bookmarklets — in one place.

Two config sources

Every preview path boots Rover from one of two config sources.

Workspace config comes in two shapes. The reusable wildcard config is auto-loaded or created when you sign in on the preview page: allowedDomains: ["*"], owned by the signed-in tester, with a 90-day TTL you can extend with Renew 90 days or kill with Revoke. Use it to test any domain. The exact site-scoped config carries a real Workspace site key and its real allowed domains — the advanced path for validating one site key's domain policy.

Path matrix

On mobile, use Hosted Preview — Helper, Console, and Bookmarklet are desktop-first. Script-tag and production installs work everywhere.

Config shape

Reusable wildcard config (recommended for testing)

{
  "siteId": "...",
  "publicKey": "pk_site_...",
  "siteKeyId": "...",
  "apiBase": "https://agent.rtrvr.ai",
  "allowedDomains": ["*"],
  "domainScopeMode": "registrable_domain",
  "sessionScope": "shared_site",
  "openOnInit": true,
  "mode": "full",
  "allowActions": true,
  "capabilities": {
    "roverEmbed": true,
    "cloudAgent": true,
    "cloudScrape": true,
    "externalWebContextScrape": true
  },
  "ui": {
    "voice": { "enabled": true },
    "experience": {
      "audio": {
        "narration": { "enabled": true, "rate": 1, "language": "en-US" }
      },
      "motion": {
        "actionSpotlight": true,
        "actionSpotlightColor": "#c6f24e"
      }
    }
  }
}

Exact site-scoped config

{
  "siteId": "site_123",
  "publicKey": "pk_site_123",
  "siteKeyId": "key_123",
  "apiBase": "https://agent.rtrvr.ai",
  "allowedDomains": ["example.com"],
  "domainScopeMode": "registrable_domain",
  "openOnInit": true,
  "mode": "full",
  "allowActions": true,
  "capabilities": { "roverEmbed": true },
  "ui": { "voice": { "enabled": true } }
}

Required fields for the generic path: siteId plus either publicKey or sessionToken. siteKeyId, apiBase, allowedDomains, domainScopeMode, openOnInit, mode, allowActions, and capabilities.roverEmbed are optional. The website tool validates the JSON before generating anything, so missing fields or bad domain scope surface early.

Preview sessions use Rover's built-in tab behavior: external pages open in a new tab with notice, and allowed-host hops use smart tab selection.

Get config from Workspace

See Workspace docs for install material, site keys, and production setup.

Choose a client

Preview Helper (recommended)

An MV3 Chrome extension, public at rtrvr-ai/rover-preview-helper. It injects Rover from the reusable wildcard config, an exact site-scoped config, or a hosted preview handoff, and re-injects across reloads and history navigation while the page still matches allowedDomains — the most reliable live-inject path.

git clone https://github.com/rtrvr-ai/rover-preview-helper.git
cd rover-preview-helper
pnpm install
pnpm build

The handoff uses a private URL fragment — #rover_helper_payload=<base64url(JSON)> — so config stays out of target-site query params and request logs. The helper reads the fragment, strips it from the URL, and injects Rover. It also remembers your last-used config: after the first handoff or manual paste, later sessions reuse the saved config automatically.

Console snippet

Best when DevTools is already open — fast demos, screen-sharing, and debugging. Generate the snippet from the preview page or the SDK, open DevTools on the target page, paste it into the Console, and press Enter. Injected JavaScript is lost on a full page reload.

Bookmarklet

Best for the drag-to-bookmarks moment and repeated one-click demos. Show the bookmarks bar (Cmd+Shift+B / Ctrl+Shift+B), then drag the Rover button from the preview page into it — drag from the dedicated drag control, never click it on the Rover page itself. Open the target site and click the bookmark. Still current-page only: reloads need another click, and some browsers and sites restrict bookmarklet behavior.

Script tag and SDK helpers

When you can edit the target site's code, generate a script tag instead — paste it into the site's head or body, reload, and Rover stays available on later pages because the site loads it directly. The SDK exports the same generators for your own tooling: console snippet, bookmarklet, and script-tag snippet, straight from Rover config. The SDK does not create the config; Workspace does.

Hosted Preview

Hosted Preview is the Rover-managed demo path. Use it when you do not want to think about site config yet, when you need a temporary demo token, or when mobile, CSP, or reload behavior makes live injection unreliable.

To drive the hosted service directly: create with signed-in Firebase bearer auth via POST /v2/rover/previews; the follow-on get/events/input/cancel/share/bootstrap routes take the preview token in query or body, or bearer auth. Instant Preview API is the source of truth for the contract — auth model, curl examples, response fields, and the OpenAPI spec.

Preview tokens vs site keys

Hosted preview tokens are short-lived demo credentials tied to the signed-in tester's temporary preview session. Workspace site keys are persistent production install credentials. Never treat preview tokens as production keys.

Troubleshooting