Skip to main content

DevTools

Inspect queries, mutation history, authentication, and proxy behavior during development.

Better Convex Nuxt integrates a diagnostics view with Nuxt DevTools when DevTools are enabled.

nuxt.config.ts
export default defineNuxtConfig({
  devtools: { enabled: true },
})

Open Nuxt DevTools and select the Better Convex Nuxt panel.

Query inspection

Use the query list and detail view to inspect:

  • function name and arguments;
  • subscription and update lifecycle;
  • current result/error state;
  • timing and update count where available.

When a page shows an unexpected result, confirm the function and exact arguments before adding cache or refresh code.

Mutation timeline

The mutation timeline distinguishes pending, optimistic, successful, and failed calls. Use it to verify whether a UI update came from an optimistic overlay or a confirmed server result.

Auth panels

The auth panel and waterfall show initial settlement, session/token coordination, and identity transitions. The proxy panel helps distinguish browser auth calls from upstream Convex HTTP behavior.

Sensitive data

DevTools are development diagnostics, not a public audit log. Query arguments and results can contain product data. Keep DevTools disabled in production deployments unless the deployment has an explicit protected diagnostics policy.

Public extension boundary

The internal DevTools bridge and sink are not public package APIs. Do not import them from application code.

Report an issue