From 9dd3857c19d5807e374c2b38d22bf9db433c9d05 Mon Sep 17 00:00:00 2001
From: Bryceson Laing <bklaing2@gmail.com>
Date: Tue, 31 Mar 2026 08:46:09 -0500
Subject: [PATCH 1/3] add Vercel analytics

---
 package.json       | 1 +
 src/app/layout.tsx | 4 +++-
 yarn.lock          | 5 +++++
 3 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 7df835a..e944459 100644
--- a/package.json
+++ b/package.json
@@ -17,6 +17,7 @@
     "@radix-ui/react-separator": "^1.1.7",
     "@radix-ui/react-slot": "^1.2.4",
     "@tanstack/react-query": "^5.90.6",
+    "@vercel/analytics": "^2.0.1",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cmdk": "^1.1.1",
diff --git a/src/app/layout.tsx b/src/app/layout.tsx
index 295669f..6a2fe52 100644
--- a/src/app/layout.tsx
+++ b/src/app/layout.tsx
@@ -1,5 +1,6 @@
 import type { Metadata } from "next";
 import "./globals.css";
+import { Analytics } from "@vercel/analytics/next";
 import Script from "next/script";
 import LoadingIndicator from "@/components/LoadingIndicator";
 import { barlow } from "@/lib/fonts";
@@ -30,9 +31,10 @@ export default function RootLayout({
           <Footer />
           <LoadingIndicator />
         </Providers>
+        <Analytics />
         <Script id="feedback-button">
           {`(function(){window.onUsersnapCXLoad=function(e){e.init()};var e=document.createElement("script");e.defer=1,e.src="https://widget.usersnap.com/global/load/b4393e90-ec13-4338-b299-7b6f122b7de3?onload=onUsersnapCXLoad",document.getElementsByTagName("head")[0].appendChild(e)})();`}
-        </Script>{" "}
+        </Script>
       </body>
     </html>
   );
diff --git a/yarn.lock b/yarn.lock
index e334a9a..f048aa8 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -1287,6 +1287,11 @@
   dependencies:
     csstype "^3.0.2"
 
+"@vercel/analytics@^2.0.1":
+  version "2.0.1"
+  resolved "https://registry.yarnpkg.com/@vercel/analytics/-/analytics-2.0.1.tgz#d7d7bd37af7cfbeea95db5f132ae4889f4d26407"
+  integrity sha512-MTQG6V9qQrt1tsDeF+2Uoo5aPjqbVPys1xvnIftXSJYG2SrwXRHnqEvVoYID7BTruDz4lCd2Z7rM1BdkUehk2g==
+
 aria-hidden@^1.2.4:
   version "1.2.6"
   resolved "https://registry.npmjs.org/aria-hidden/-/aria-hidden-1.2.6.tgz"

From a0e9591f30315cbe753b1fa31e718718f1beac38 Mon Sep 17 00:00:00 2001
From: Bryceson Laing <bklaing2@gmail.com>
Date: Wed, 1 Apr 2026 09:00:47 -0500
Subject: [PATCH 2/3] track events for global search, breadcrumbs, and filters

---
 src/app/DisplayEntities.tsx      |  8 ++++++-
 src/components/ActionButtons.tsx | 37 +++++++++++++++++++++++---------
 src/components/Breadcrumbs.tsx   | 23 +++++++++++++++-----
 3 files changed, 52 insertions(+), 16 deletions(-)

diff --git a/src/app/DisplayEntities.tsx b/src/app/DisplayEntities.tsx
index 768e524..331be20 100644
--- a/src/app/DisplayEntities.tsx
+++ b/src/app/DisplayEntities.tsx
@@ -1,5 +1,6 @@
 "use client";
 
+import { track } from "@vercel/analytics";
 import Link from "next/link";
 import { useState } from "react";
 import { EntityBadge } from "@/components/Badges";
@@ -89,7 +90,12 @@ function EntityItem(props: {
   entity: { id: string; name: string; subtype: string };
 }) {
   return (
-    <Item size="sm" className="w-full px-2 py-1" asChild>
+    <Item
+      onClick={() => track("global search", { action: "entity clicked" })}
+      size="sm"
+      className="w-full px-2 py-1"
+      asChild
+    >
       <Link href={`/${props.entity.id}`} prefetch={false} className="size-full">
         <ItemContent className="gap-0">
           <ItemTitle>{props.entity.name}</ItemTitle>
diff --git a/src/components/ActionButtons.tsx b/src/components/ActionButtons.tsx
index 9064677..e554d1b 100644
--- a/src/components/ActionButtons.tsx
+++ b/src/components/ActionButtons.tsx
@@ -1,5 +1,6 @@
 "use client";
 
+import { track } from "@vercel/analytics";
 import { Info } from "lucide-react";
 import Link from "next/link";
 import { useRouter, useSearchParams } from "next/navigation";
@@ -70,6 +71,14 @@ function FilterByRegistrationYear(props: { entity: Entity }) {
       (y) => y.id === searchParams.get(SEARCH_PARAMETERS.REGISTRATION_YEAR),
     ) || null;
 
+  function onItemClick() {
+    track("filters", {
+      on: "registration year",
+      action: "filter clicked",
+    });
+    setOpen(false);
+  }
+
   return (
     <Combobox
       items={data?.registrationYears ?? []}
@@ -105,11 +114,7 @@ function FilterByRegistrationYear(props: { entity: Entity }) {
             const href = `/${props.entity.id}?${params.toString()}`;
 
             return (
-              <ComboboxItem
-                key={item.id}
-                value={item.id}
-                onClick={() => setOpen(false)}
-              >
+              <ComboboxItem key={item.id} value={item.id} onClick={onItemClick}>
                 <Link href={href} prefetch className="size-full">
                   <Item size="sm" className="px-0 py-0.5">
                     <ItemContent className="gap-0">
@@ -139,6 +144,14 @@ function FilterByResourceType(props: { entity: Entity }) {
       (rt) => rt.id === searchParams.get(SEARCH_PARAMETERS.RESOURCE_TYPE),
     ) || null;
 
+  function onItemClick() {
+    track("filters", {
+      on: "resource type",
+      action: "filter clicked",
+    });
+    setOpen(false);
+  }
+
   return (
     <Combobox
       items={data?.resourceTypeData ?? []}
@@ -172,11 +185,7 @@ function FilterByResourceType(props: { entity: Entity }) {
             const href = `/${props.entity.id}?${params.toString()}`;
 
             return (
-              <ComboboxItem
-                key={item.id}
-                value={item.id}
-                onClick={() => setOpen(false)}
-              >
+              <ComboboxItem key={item.id} value={item.id} onClick={onItemClick}>
                 <Link href={href} prefetch className="size-full">
                   <Item size="sm" className="px-0 py-0.5">
                     <ItemContent className="gap-0">
@@ -207,9 +216,16 @@ function FilterByQuery(props: { entity: Entity }) {
 
   const disabled = !query.trim();
 
+  const trackQuery = () =>
+    track("filters", {
+      on: "query",
+      action: "query submitted",
+    });
+
   function onKeyDown(e: KeyboardEvent<HTMLInputElement>) {
     if (e.key === "Enter") {
       e.preventDefault();
+      trackQuery();
       router.push(href);
     }
   }
@@ -234,6 +250,7 @@ function FilterByQuery(props: { entity: Entity }) {
         )}
         disabled={disabled}
         asChild={!disabled}
+        onClick={trackQuery}
       >
         <Link href={href} prefetch>
           Filter by Query
diff --git a/src/components/Breadcrumbs.tsx b/src/components/Breadcrumbs.tsx
index 5f3149e..3787467 100644
--- a/src/components/Breadcrumbs.tsx
+++ b/src/components/Breadcrumbs.tsx
@@ -1,5 +1,6 @@
 "use client";
 
+import { track } from "@vercel/analytics";
 import { ChevronsUpDown, Home, Slash } from "lucide-react";
 import Link from "next/link";
 import { useSearchParams } from "next/navigation";
@@ -86,6 +87,11 @@ function BreadcrumbContent(props: {
 }) {
   const className = `flex flex-row items-center ${props.entity.id === props.active.id ? "bg-black/0 font-semibold" : ""}`;
 
+  function onClick(e: React.MouseEvent<HTMLAnchorElement, MouseEvent>) {
+    track("breadcrumbs", { on: "breadcrumb item", action: "entity clicked" });
+    e.stopPropagation();
+  }
+
   const BreadcrumbPageLink = (wrapperProps: { children: ReactNode }) =>
     props.entity.id === props.active.id ? (
       <BreadcrumbPage {...wrapperProps} className={className} />
@@ -94,7 +100,7 @@ function BreadcrumbContent(props: {
         {...wrapperProps}
         href={`/${props.entity.id}`}
         className={className}
-        onMouseDown={(e) => e.stopPropagation()}
+        onMouseDown={onClick}
       />
     );
 
@@ -161,15 +167,22 @@ function SiblingSelect(props: {
         />
         <ComboboxEmpty>
           No{" "}
-          {props.parent?.type === "provider"
-            ? "repositories"
-            : "organizations"}{" "}
+          {props.parent?.type === "provider" ? "repositories" : "organizations"}{" "}
           found.
         </ComboboxEmpty>
         <ComboboxList>
           {(item: Entity) => {
             return (
-              <ComboboxItem value={item} key={item.id}>
+              <ComboboxItem
+                onClick={() =>
+                  track("breadcrumbs", {
+                    on: "dropdown",
+                    action: "entity clicked",
+                  })
+                }
+                value={item}
+                key={item.id}
+              >
                 <Link
                   href={`/${item.id}?${searchParams.toString()}`}
                   prefetch

From 81e20dcaf49608db0013be466adf6a55a3c8663c Mon Sep 17 00:00:00 2001
From: Bryceson Laing <bklaing2@gmail.com>
Date: Wed, 1 Apr 2026 09:13:24 -0500
Subject: [PATCH 3/3] make event data more consistent

---
 src/app/DisplayEntities.tsx      | 4 +++-
 src/components/ActionButtons.tsx | 6 +++---
 src/components/Breadcrumbs.tsx   | 6 +++---
 3 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/src/app/DisplayEntities.tsx b/src/app/DisplayEntities.tsx
index 331be20..5a54aad 100644
--- a/src/app/DisplayEntities.tsx
+++ b/src/app/DisplayEntities.tsx
@@ -91,7 +91,9 @@ function EntityItem(props: {
 }) {
   return (
     <Item
-      onClick={() => track("global search", { action: "entity clicked" })}
+      onClick={() =>
+        track("global search", { on: "result", action: "clicked" })
+      }
       size="sm"
       className="w-full px-2 py-1"
       asChild
diff --git a/src/components/ActionButtons.tsx b/src/components/ActionButtons.tsx
index e554d1b..0293d84 100644
--- a/src/components/ActionButtons.tsx
+++ b/src/components/ActionButtons.tsx
@@ -74,7 +74,7 @@ function FilterByRegistrationYear(props: { entity: Entity }) {
   function onItemClick() {
     track("filters", {
       on: "registration year",
-      action: "filter clicked",
+      action: "clicked",
     });
     setOpen(false);
   }
@@ -147,7 +147,7 @@ function FilterByResourceType(props: { entity: Entity }) {
   function onItemClick() {
     track("filters", {
       on: "resource type",
-      action: "filter clicked",
+      action: "clicked",
     });
     setOpen(false);
   }
@@ -219,7 +219,7 @@ function FilterByQuery(props: { entity: Entity }) {
   const trackQuery = () =>
     track("filters", {
       on: "query",
-      action: "query submitted",
+      action: "submitted",
     });
 
   function onKeyDown(e: KeyboardEvent<HTMLInputElement>) {
diff --git a/src/components/Breadcrumbs.tsx b/src/components/Breadcrumbs.tsx
index 3787467..9418754 100644
--- a/src/components/Breadcrumbs.tsx
+++ b/src/components/Breadcrumbs.tsx
@@ -88,7 +88,7 @@ function BreadcrumbContent(props: {
   const className = `flex flex-row items-center ${props.entity.id === props.active.id ? "bg-black/0 font-semibold" : ""}`;
 
   function onClick(e: React.MouseEvent<HTMLAnchorElement, MouseEvent>) {
-    track("breadcrumbs", { on: "breadcrumb item", action: "entity clicked" });
+    track("breadcrumbs", { on: "breadcrumb entity", action: "clicked" });
     e.stopPropagation();
   }
 
@@ -176,8 +176,8 @@ function SiblingSelect(props: {
               <ComboboxItem
                 onClick={() =>
                   track("breadcrumbs", {
-                    on: "dropdown",
-                    action: "entity clicked",
+                    on: "dropdown entity",
+                    action: "clicked",
                   })
                 }
                 value={item}