@rerun-io/web-viewer
TypeScript icon, indicating that this package has built-in type declarations

0.16.0 • Public • Published

Rerun web viewer

Embed the Rerun web viewer within your app.

This package is framework-agnostic. A React wrapper is available at https://www.npmjs.com/package/@rerun-io/web-viewer-react.

Install

$ npm i @rerun-io/web-viewer

ℹ️ Note: The package version is equal to the supported Rerun SDK version. This means that @rerun-io/web-viewer@0.10.0 can only connect to a data source (.rrd file, websocket connection, etc.) that originates from a Rerun SDK with version 0.10.0!

Usage

The web viewer is an object which manages a canvas element:

import { WebViewer } from "@rerun-io/web-viewer";

const rrd = "…";
const parentElement = document.body;

const viewer = new WebViewer();
await viewer.start(rrd, parentElement);
// …
viewer.stop();

The rrd in the snippet above should be a URL pointing to either:

If rrd is not set, the Viewer will display the same welcome screen as https://app.rerun.io.

For a full example, see https://github.com/rerun-io/web-viewer-example. You can open the example via CodeSandbox: https://codesandbox.io/s/github/rerun-io/web-viewer-example

ℹ️ Note: This package only targets recent versions of browsers. If your target browser does not support Wasm imports or top-level await, you may need to install additional plugins for your bundler.

Development

$ npm run build

Readme

Keywords

none

Package Sidebar

Install

npm i @rerun-io/web-viewer

Homepage

rerun.io

Weekly Downloads

350

Version

0.16.0

License

MIT

Unpacked Size

22.4 MB

Total Files

11

Last publish

Collaborators

  • rerun-bot
  • jprochazk