Integrating with Next.js

Next.js enables a React application to be rendered on either the client-side or server-side, improving first-page load performance and capability. Integrating TrackJS will require an isomorphic adapter to inject either the browser agent or the node agent at runtime.

Attach TrackJS into Next.js through a custom <app> as described in the Next.js documentation.

Custom _app.js

The pages/_app.js override of the Application enables us to attach the standard React componentDidCatch handler. The rest of the code is boilerplate from the Next.js documentation.

import App from "next/app";
// the Isomorphic Adapter is a custom shim you need to add to run TrackJS on both browser and server.
// see below.
import { TrackJS } from "./util/trackjs-isomorphic.js";

if (!TrackJS.isInstalled()) {
    token: "YOUR_TOKEN"

function MyApp({ Component, pageProps }) {
  return <Component {...pageProps} />

// Standard React extension point for capturing errors.
MyApp.componentDidCatch = (error, errorInfo) => {
  this.setState({ error });
  // Anything else you want to do with the error.

export default MyApp;
Next.js custom App with TrackJS

TrackJS Isomorphic Adapter

To use the agent effectively in both NodeJS and on the browser, you need to add a small isomorphic adapter to your application. This allows you to get the correct agent object in your code.

module.exports = process.browser ?
  require("trackjs") :
TrackJS Isomorphic Adapter

Server API

Next.js is commonly augmented with Express for a data API. See the Express integration for details.