Web UI

Vesty embeds wry directly. It does not add a Tauri runtime. The editor can be vanilla JavaScript, React, Vue, or Svelte and communicates through vesty-plugin-ui.

Configure assets

TOMLvesty.toml
1[ui]2dir = "ui"3dev_url = "http://localhost:5173"4build = "npm run build"5dist = "dist"6width = 9007height = 5608min_width = 6409min_height = 420

Development uses dev_url. Release packaging copies dist into the bundle and generates a size/hash asset manifest.

Complete the handshake

TypeScript
1import { createBridge } from 'vesty-plugin-ui';23const bridge = createBridge(window, 'pending');4const ready = await bridge.ready();56const gain = ready.paramValues.find((value) => value.id === 'gain');7console.log(gain?.normalized);

ready.params describes parameter metadata. ready.paramValues contains current host/controller values. Do not initialize controls from defaultNormalized when restoring an existing project.

Perform a host edit

TypeScript
1const gestureId = crypto.randomUUID();23await bridge.beginParamEdit('gain', gestureId);4await bridge.performParamEdit('gain', 0.72, gestureId);5await bridge.endParamEdit('gain', gestureId);

The controller updates its parameter only after the host accepts performEdit. A rejection becomes a host_rejected bridge error instead of optimistic local state.

Subscribe to confirmation

TypeScript
1const unsubscribe = bridge.subscribe('param.changed', (event) => {2  if (event.id === 'gain') updateGainControl(event.normalized);3});

Use confirmed events to synchronize multiple editors, host automation, preset changes, and program changes.

Reload behavior

A new bridge.hello on a pending session resets subscriptions, gestures, meters, and the old editor session. The native endpoint refreshes paramValues before each handshake, so reloaded and reopened editors do not display stale controls.

Keep work off the audio thread

JSON parsing, WebView evaluation, subscriptions, and state snapshots run outside process(). Realtime meters cross a bounded queue and are drained asynchronously by the UI thread.