Docs · Open the panel window

Open the panel window

The plugin serves the panel as an ordinary page on your app's own dev server, at /__runespect/. You need runespect() in the Vite config (Getting started).

app:      http://localhost:5173/
devtools: http://localhost:5173/__runespect/

There is no extension and no extra port: the app and the panel talk over Vite's HMR channel, so it also works over https.

In a build #

With includeInRelease, vite build puts the panel next to the app, at the same address. There is no dev server between them: the two reach each other through the browser, so open them in tabs of the same browser, on the same origin. Keep the slash at the end of the address. A panel on one machine cannot follow an app on another. panelInRelease: false leaves the window out of the build.

Under a Vite base #

The panel moves with the app: base: '/app/' serves it at /app/__runespect/.

With several pages open #

Every page on the dev server reaches the same panel window: a second tab, another route, an island from a separate bundle. The panel follows one page at a time, and its status chip names it. When more than one page has answered, the chip becomes a picker.

To open the panel for a particular page, name its path:

http://localhost:5173/__runespect/?source=/some/path

That beats the page the panel followed last, which is what it picks when you name none. Until that page answers, the panel shows no other page, so the other tabs stay as they are.

Over the network #

The same goes for a build with includeInRelease: anyone who can open it can also open its panel and edit its state. Never deploy it to production.

With vite --host, anyone who can open the app on your network can also open its panel and edit its state. The dev server already serves them your source; see Architecture for what an edit can and cannot do.