Inspector

Standalone admin client for exploring Jazz sync servers, schemas, permissions, and subscriptions.

The Jazz Inspector is a standalone client for inspecting a Jazz app through any reachable sync server. It is not tied to Jazz Cloud: if you have a server URL, app ID, and admin credential, you can connect to that app's sync server directly.

Admin access only

The inspector uses adminSecret, not an end-user session token. On the sync connection, that authenticates the client as the backend, so normal permission policies are bypassed. Treat it like production infrastructure access and never expose it to end users.

Connecting

Open v2.inspector.jazz.tools and enter:

Server URL — base URL of the sync server
App ID — Jazz app namespace to inspect
Admin secret — app admin credential
Env — logical environment such as dev, staging, or prod
Branch — legacy connection namespace, usually main (this does not select a branch view)

After connecting, choose the published schema hash you want to inspect. The inspector stores the connection name, server URL, app ID, environment, and schema hash locally. Admin secrets are kept only in memory: re-enter the credential after reloading or reopening a saved connection. Development links prefill connection details without including the credential. Legacy credentials in saved connections or URL fragments are removed and must be entered again.

Features

Data Explorer

Browse every table in the selected schema, inspect rows reactively, sort columns, and add typed filters. Relation cells link to the referenced table, so you can follow relations without manually rebuilding the query.

The explorer also supports admin writes: edit cells inline, open a row sidebar for full-row edits, insert new rows, and delete existing ones.

Schema and permissions view

Each table includes a schema view showing the stored structural schema for that table. In standalone mode, the same page also shows the currently published sync-server permissions for that table, which is useful when you want to confirm what policy bundle the server is enforcing.

Subscriptions

The Subscriptions tab shows active subscriptions from the inspected page runtime and active server-managed subscriptions from the connected sync server. You can inspect the table, propagation mode, branch-view options, and compiled query JSON, then jump straight into the matching table view in Data Explorer.

Schema switching

If an app has multiple published schema hashes, the inspector lets you switch between them without reconnecting. This is useful when checking migrations, comparing stored shapes, or debugging data that was authored under an older schema.

Development overlay

The Vite, SvelteKit, and Next.js development integrations can serve an in-app inspector overlay that opens the embedded inspector against the running app's local runtime. In React, use JazzProvider or JazzSessionProvider from jazz-tools/react to attach that runtime. The overlay is enabled by default during development and can be disabled with the integration's inspector: false option. Next.js serves the assets through a development-only loopback server and rewrite; production builds do not include that rewrite or enable the overlay.

For remote or self-hosted sync servers, the hosted client at v2.inspector.jazz.tools is the easiest way to inspect the server directly.