@nexoxa/speed-insights

Core Web Vitals — production OG flow: vitals POST to your app, stored on your server, Bridge reads over SSH.

Install

npm i @nexoxa/speed-insights

Next.js

// app/api/nexoxa-speed-insights/collect/route.ts
import { createSpeedCollectHandler, speedOptionsHandler } from "@nexoxa/speed-insights/node";

export const POST = createSpeedCollectHandler();
export const OPTIONS = speedOptionsHandler;

import { SpeedInsights } from "@nexoxa/speed-insights/next";

<SpeedInsights siteKey="nx_your_deployment_key" />

Storage

Events land in .nexoxa/speed-insights/{siteKey}.jsonl on your server. Set NEXOXA_DATA_DIR and mount a Docker volume for persistence.

Production options

Same env vars as @nexoxa/analytics: NEXOXA_RETENTION_DAYS, NEXOXA_MAX_MB, NEXOXA_COLLECT_SECRET, and requireConsent + setSpeedInsightsConsent() for cookie banners.

Privacy guidance: asteron.nexoxa.com/privacy (section 8).

Product: asteron.nexoxa.com/integrations

MIT