Starlight

Get your tracking snippet

In your Rybbit dashboard, open Site Settings → Tracking Script and copy your snippet. It looks like this:

<script src="https://app.rybbit.io/api/script.js?siteId=YOUR_SITE_ID" defer></script>

YOUR_SITE_ID is the numeric ID of your site. If you self-host Rybbit, app.rybbit.io is the domain of your own instance.

Add the snippet to Starlight

Open astro.config.mjs at the root of your project and add a script entry to the head array of the starlight() integration:

import { defineConfig } from "astro/config";
import starlight from "@astrojs/starlight";

export default defineConfig({
  integrations: [
    starlight({
      title: "My Docs",
      head: [
        {
          tag: "script",
          attrs: {
            src: "https://app.rybbit.io/api/script.js?siteId=YOUR_SITE_ID",
            defer: true,
          },
        },
      ],
    }),
  ],
});

Each head entry becomes an HTML element with the given attributes; defer: true renders as a boolean attribute. Rebuild with npm run build and deploy the dist/ directory.

Starlight serves each page as a full document, so every navigation is a normal pageview and no route-change handling is needed.

Verify installation

Open your live site in a new tab and click through a few pages. Within a few seconds the pageviews appear in the Rybbit dashboard.

If nothing shows up:

• View the page source and search for script.js?siteId= to confirm the snippet is on the page.
• Open the browser Network tab and check that script.js returns 200 and that POST requests go to /api/track.
• Disable ad blockers, or set up a proxy so the script loads from your own domain.
• See the script troubleshooting guide for other common causes.