Dev inspector
The inspector is a small floating panel that appears in development. It lets you try theme changes on the real app and shows where the page breaks the design system. It also feeds the same findings to your AI agent.
Turn it on
Nothing to do: ThemeProvider renders it whenever NODE_ENV is not production. Pass devTools={false} to hide it, or render it yourself to change its props:
import { ShavinDevInspector, ThemeProvider } from "@shavin/ui";
<ThemeProvider devTools={false}>
{children}
<ShavinDevInspector position="bottom-left" />
</ThemeProvider>Tabs

The inspector over an example app (the WiseOwl finance dashboard) on the DS Audit tab: the contrast check, the violation count with Re-scan, the highlight toggle, and the list of problems. The hand-written budget alert is outlined on the page.
| Theme | Try brand, gray, radius, scaling, panel and fonts on the live app, then copy the ThemeProvider props. |
| DS Audit | Lists token problems on the current page: raw colours, off-token radius, low contrast. Click one to jump to it. |
| MCP | Bridge connection status and the MCP tools your agent can use with this page. |
| Stream | The events passing between the page and the bridge, for debugging. |
Props
| Prop | What it does |
|---|---|
position | Starting corner: bottom-right (default), bottom-left, top-left or top-right. You can drag it; it snaps to a corner. |
forceShow | Render in production too. Off by default. |
bridgePort | Bridge port, if you changed it. Also read from NEXT_PUBLIC_SHAVIN_BRIDGE_PORT or VITE_SHAVIN_BRIDGE_PORT. |
How your agent sees the page
The inspector sends each audit to the bridge, a local server on port 7036 that starts with your dev server (see MCP setup). Your agent reads it with three tools:
get_live_audit | The current problems on each open page. |
trigger_live_rescan | Asks open pages to audit again after a change. |
wait_for_live_clean | Waits up to a few seconds for the problem count to reach zero, then returns what is left. |
A clean audit means the page uses the tokens correctly. It does not tell you the page looks right, so still look at it yourself.