Next.js

Install: pnpm add @watchtowerobservability/browser

Initialize

import { useNextRouteTracking } from "@watchtowerobservability/browser/next";
// client component: useNextRouteTracking(usePathname(), useParams());
// call init() once in a client-side provider; it is a no-op during server rendering.

Replay and privacy

Replay is off until enabled in project settings or replay.enabled. Default mask level is strict: all text is masked and inputs are never recorded. Per element:

• data-wt-mask masks the element's text.

• data-wt-block removes the element and its subtree from the recording.

• data-wt-unmask re-shows text (only below strict level).

Exclude routes with replay: { excludeRoutes: ["/billing", /^\/admin/] }.

Content Security Policy

Replay chunks are compressed in a worker, and data is sent to your Watchtower edge:

worker-src blob:;
connect-src 'self' https://<your-watchtower-edge>;
script-src 'self';

The recorder chunk (replay.js) is served from your own origin.

Source maps

Use the build plugin so errors resolve to original code. The upload key is a secret API key from WT_API_KEY, never the publishable key. Maps are deleted after upload by default.

webpack: new WatchtowerWebpackPlugin({ api, project }) from @watchtowerobservability/browser/webpack-plugin, with productionBrowserSourceMaps: true.

Replay, issues and traces

Errors captured by the SDK become issues. An issue links to the replay of the first affected session, and a session's trace_id links to the backend trace. Linking replays to MCP clients is Phase 5.