Skip to content

Connect Next.js

Set Next.js up with one pull request Xovris opens for you.

Connect GitHub

Terminal window
npx xovris@latest init
Watch the first event arrive

Will it fit your project?

Checks a package.json fits – in your browser, sent nowhere.

Checked right here, by the same rules the set-up command uses. Nothing is sent anywhere.

    Run the wizard

    Xovris sets Next.js up for you: connect GitHub once and Xovris raises one pull request that installs the SDK and writes the configuration, for you to review and merge – then it shows the first event the moment it arrives. Do it yourself instead: run one command in your Next.js project – it signs you in through your browser, installs the SDK, writes the configuration and proves the first event arrived, and you never copy a key.

    Xovris makes this change for you: connect GitHub once and Xovris raises a pull request that lists every change, for you to review and merge.

    Connect GitHub

    What the wizard changes

    Before writing anything the wizard shows each change. It records every change in a manifest, so removal is exact.

    The wizard writes the configuration; its install test has not yet passed in CI on the latest Next.js.

    This set-up works on npm, pnpm, yarn and bun, as of 14 November 2026.

    Timed on the same small app each run, from the command to the first real error stored: 5 of 5 runs reached it, a median of 46.9 s (90th percentile 59.8 s) and 2 answers or presses from the person, measured 14 November 2026 in Xovris’s own test setting.

    PostHog’s own set-up on the same app: 5 of 5 runs reached it, a median of 390.1 s and 10 answers or presses from the person.

    Sentry’s own set-up on the same app: 4 of 5 runs reached it, a median of 70.9 s and 12 answers or presses from the person.

    Sentry’s runs that did not reach it: the set-up stopped with an error (exit code 1) (1).

    Every stack the race has run, side by side

    1. Detects Next.js and your package manager
    2. Opens your browser to sign you in – no key to paste
    3. Installs @xovris/next
    4. Writes to .env.local XOVRIS_INGEST_URL, XOVRIS_INGEST_KEY, NEXT_PUBLIC_XOVRIS_INGEST_URL, NEXT_PUBLIC_XOVRIS_INGEST_KEY
    5. Waits until your first event is stored, then says so
    6. Records every change, so this takes it all out again: npx xovris@latest remove

    Variables it writes

    The wizard writes these to .env.local and adds that file to .gitignore if it is not already ignored. It refuses to write a key into a file git tracks.

    VariablePurpose
    XOVRIS_INGEST_URLWhere events are sent
    XOVRIS_INGEST_KEYThe ingestion key for this project (write-only: it can send events, never read them)
    NEXT_PUBLIC_XOVRIS_INGEST_URLWhere browser events are sent
    NEXT_PUBLIC_XOVRIS_INGEST_KEYThe browser ingestion key (write-only)

    If you already use another tool

    The wizard looks for existing instrumentation first and tells you what it will do before it changes anything, so you never send each error twice.

    FoundWhat the wizard does
    OpenTelemetryAdds Xovris as a second OpenTelemetry exporter – your existing setup keeps working unchanged.
    SentryOffers to run both side by side for a while, or to switch over; it never sends one error to Xovris twice.
    Datadog and New RelicLeaves the existing agent in place and offers to export through OpenTelemetry instead of adding a second agent.

    Check it works

    The wizard ends by waiting for your first stored event. To check again later, run:

    Terminal window
    npx xovris@latest verify

    Remove it

    This puts back every change the setup made and switches its key off, then confirms both:

    Terminal window
    npx xovris@latest remove

    What you get

    SignalState
    Server errorsIncluded
    Browser errorsIncluded
    TracesThrough OpenTelemetry
    MetricsThrough OpenTelemetry
    LogsNot collected
    ReleasesIncluded
    Readable stack tracesIncluded

    Supported versions

    Written for Next.js 15.3 or later (before 17), on Node.js 20.19 or later.

    Frameworknext >=15.3.0 <17
    RuntimeNode.js >=20.19
    Package managersnpm, pnpm, yarn, bun
    Packagesnpm install @xovris/next

    Ask Xovris

    Open the full page

    Your data is never used to train our AI. How your data is kept

    A problem is called fixed only once it works again. How each fix is checked

    XOVRIS LTD, registered in England and Wales, company number 17499910. Registered office: 66 Paul Street, London EC2A 4NA.