Gatsby

​

Install with the CLI

npx @lucenthq/cli init luc_pk_...

​

Manual setup

GATSBY_LUCENT_PUBLIC_KEY=luc_pk_...

import { LucentTracker } from "@lucenthq/sdk";

const tracker = new LucentTracker({
  publicKey: process.env.GATSBY_LUCENT_PUBLIC_KEY,
});

export const onClientEntry = () => {
  tracker.start();
};

​

Notes

• gatsby-browser.js only runs in the browser, so it’s a safe place to instantiate the tracker at module scope.
• onClientEntry fires once, right after Gatsby boots — before any routes render — which means the tracker catches the very first page view.
• The GATSBY_ prefix makes the variable available in both process.env (server build time) and import.meta.env (not used here).