Skip to content

Full Toolkit for Next-Level Domain Analysis

Refactor analytics reporting 📈

Felix Wotschofsky14c3115a696e
diff --git a/app/_components/feedback-prompt.tsx b/app/_components/feedback-prompt.tsx
index 067c7bf..3d59d13 100644
--- a/app/_components/feedback-prompt.tsx
+++ b/app/_components/feedback-prompt.tsx
@@ -3,7 +3,6 @@
import { useLocalStorage } from '@uidotdev/usehooks';
import { XIcon } from 'lucide-react';
import ms from 'ms';
-import { usePlausible } from 'next-plausible';
import { type FC, useCallback, useState } from 'react';
import { Button } from '@/components/ui/button';
@@ -16,11 +15,13 @@ import {
DialogTitle,
} from '@/components/ui/dialog';
+import { useAnalytics } from '@/lib/analytics';
+
const INITIAL_DELAY = ms('10m');
const TIMEOUT_PERIOD = ms('7d');
export const FeedbackPrompt: FC = () => {
- const plausible = usePlausible();
+ const { reportEvent } = useAnalytics();
const [lastDismissed, setLastDismissed] = useLocalStorage(
'feedback-prompt.last-dismissed',
@@ -36,19 +37,19 @@ export const FeedbackPrompt: FC = () => {
const handleNegative = useCallback(() => {
window.open('https://wotschofsky.com/#contact', '_blank');
handleDismiss();
- plausible('Feedback: Negative');
- }, [handleDismiss, plausible]);
+ reportEvent('Feedback: Negative', {});
+ }, [handleDismiss, reportEvent]);
const handleNeutral = useCallback(() => {
handleDismiss();
- plausible('Feedback: Neutral');
- }, [handleDismiss, plausible]);
+ reportEvent('Feedback: Neutral', {});
+ }, [handleDismiss, reportEvent]);
const handlePositive = useCallback(() => {
setDialogOpen(true);
handleDismiss();
- plausible('Feedback: Positive');
- }, [setDialogOpen, handleDismiss, plausible]);
+ reportEvent('Feedback: Positive', {});
+ }, [setDialogOpen, handleDismiss, reportEvent]);
return (
<>
diff --git a/app/_components/search-form.tsx b/app/_components/search-form.tsx
index 3313687..13bf7c4 100644
--- a/app/_components/search-form.tsx
+++ b/app/_components/search-form.tsx
@@ -2,7 +2,6 @@
import { useDebounce, useMeasure } from '@uidotdev/usehooks';
import { SearchIcon } from 'lucide-react';
-import { usePlausible } from 'next-plausible';
import { useParams, usePathname, useRouter } from 'next/navigation';
import { toASCII } from 'punycode';
import {
@@ -22,6 +21,7 @@ import { Card } from '@/components/ui/card';
import { Input } from '@/components/ui/input';
import { ClientOnly } from '@/components/client-only';
+import { useAnalytics } from '@/lib/analytics';
import { EXAMPLE_DOMAINS } from '@/lib/data';
import {
cn,
@@ -120,7 +120,7 @@ type SearchFormProps = {
export const SearchForm: FC<SearchFormProps> = (props) => {
const isFirstRender = useFirstRender();
- const plausible = usePlausible();
+ const { reportEvent } = useAnalytics();
const router = useRouter();
const pathname = usePathname();
@@ -191,8 +191,8 @@ export const SearchForm: FC<SearchFormProps> = (props) => {
case 'domain':
setInvalid(false);
redirectUser(parsed.value);
- plausible('Search Form: Submit', {
- props: { domain: parsed.value },
+ reportEvent('Search Form: Submit', {
+ domain: parsed.value,
});
return;
case 'invalid':
@@ -200,7 +200,7 @@ export const SearchForm: FC<SearchFormProps> = (props) => {
return;
}
},
- [setInvalid, setIpDetailsOpen, redirectUser, plausible],
+ [setInvalid, setIpDetailsOpen, redirectUser, reportEvent],
);
const { suggestions } = useSuggestions(domain);
@@ -219,14 +219,12 @@ export const SearchForm: FC<SearchFormProps> = (props) => {
setSuggestionsVisible(false);
redirectUser(value);
- plausible('Search Form: Click Suggestion', {
- props: {
- domain: value,
- isExample: !domain,
- },
+ reportEvent('Search Form: Click Suggestion', {
+ domain: value,
+ isExample: !domain,
});
},
- [domain, setDomain, redirectUser, plausible],
+ [domain, setDomain, redirectUser, reportEvent],
);
const handleInput = useCallback<ChangeEventHandler<HTMLInputElement>>(
diff --git a/app/lookup/[domain]/(dns)/_components/location-selector.tsx b/app/lookup/[domain]/(dns)/_components/location-selector.tsx
index ed12d5e..65d09c5 100644
--- a/app/lookup/[domain]/(dns)/_components/location-selector.tsx
+++ b/app/lookup/[domain]/(dns)/_components/location-selector.tsx
@@ -1,7 +1,6 @@
'use client';
import { Label } from '@radix-ui/react-label';
-import { usePlausible } from 'next-plausible';
import { usePathname, useRouter, useSearchParams } from 'next/navigation';
import { type FC, useCallback } from 'react';
@@ -13,6 +12,7 @@ import {
SelectValue,
} from '@/components/ui/select';
+import { useAnalytics } from '@/lib/analytics';
import { REGIONS } from '@/lib/data';
type LocationSelectorProps = {
@@ -24,7 +24,7 @@ export const LocationSelector: FC<LocationSelectorProps> = ({
initialValue,
disabled,
}) => {
- const plausible = usePlausible();
+ const { reportEvent } = useAnalytics();
const router = useRouter();
const pathname = usePathname();
@@ -43,11 +43,9 @@ export const LocationSelector: FC<LocationSelectorProps> = ({
const search = current.size ? `?${current.toString()}` : '';
router.push(`${pathname}${search}`);
- plausible('Location Selector: Change', {
- props: { location: value },
- });
+ reportEvent('Location Selector: Change', { location: value });
},
- [router, pathname, searchParams, plausible],
+ [router, pathname, searchParams, reportEvent],
);
return (
diff --git a/app/lookup/[domain]/(dns)/_components/resolver-selector.tsx b/app/lookup/[domain]/(dns)/_components/resolver-selector.tsx
index 6872147..94ced04 100644
--- a/app/lookup/[domain]/(dns)/_components/resolver-selector.tsx
+++ b/app/lookup/[domain]/(dns)/_components/resolver-selector.tsx
@@ -1,7 +1,6 @@
'use client';
import { Label } from '@radix-ui/react-label';
-import { usePlausible } from 'next-plausible';
import { usePathname, useRouter, useSearchParams } from 'next/navigation';
import { type FC, useCallback } from 'react';
@@ -13,6 +12,8 @@ import {
SelectValue,
} from '@/components/ui/select';
+import { useAnalytics } from '@/lib/analytics';
+
type ResolverSelectorProps = {
initialValue?: string;
};
@@ -20,7 +21,7 @@ type ResolverSelectorProps = {
export const ResolverSelector: FC<ResolverSelectorProps> = ({
initialValue,
}) => {
- const plausible = usePlausible();
+ const { reportEvent } = useAnalytics();
const router = useRouter();
const pathname = usePathname();
@@ -39,11 +40,9 @@ export const ResolverSelector: FC<ResolverSelectorProps> = ({
const search = current.size ? `?${current.toString()}` : '';
router.push(`${pathname}${search}`);
- plausible('Resolver Selector: Change', {
- props: { resolver: value },
- });
+ reportEvent('Resolver Selector: Change', { resolver: value });
},
- [router, pathname, searchParams, plausible],
+ [router, pathname, searchParams, reportEvent],
);
return (
diff --git a/app/lookup/[domain]/_components/copy-button.tsx b/app/lookup/[domain]/_components/copy-button.tsx
index a0f4e0c..a4a114f 100644
--- a/app/lookup/[domain]/_components/copy-button.tsx
+++ b/app/lookup/[domain]/_components/copy-button.tsx
@@ -1,7 +1,6 @@
'use client';
import { CheckIcon, ClipboardIcon } from 'lucide-react';
-import { usePlausible } from 'next-plausible';
import { type FC, useCallback, useState } from 'react';
import { toast } from 'sonner';
@@ -12,12 +11,14 @@ import {
TooltipTrigger,
} from '@/components/ui/tooltip';
+import { useAnalytics } from '@/lib/analytics';
+
type CopyButton = {
value: string;
};
export const CopyButton: FC<CopyButton> = ({ value }) => {
- const plausible = usePlausible();
+ const { reportEvent } = useAnalytics();
const [wasCopied, setWasCopied] = useState(false);
const copy = useCallback(() => {
@@ -27,8 +28,8 @@ export const CopyButton: FC<CopyButton> = ({ value }) => {
toast('Copied to clipboard');
- plausible('Copy Button: Click', { props: { value } });
- }, [value, setWasCopied, plausible]);
+ reportEvent('Copy Button: Click', { value });
+ }, [value, setWasCopied, reportEvent]);
if (wasCopied) {
return <CheckIcon className="mx-1 inline-block h-4 w-4 -translate-y-0.5" />;
diff --git a/app/lookup/[domain]/_components/ip-link.tsx b/app/lookup/[domain]/_components/ip-link.tsx
index b4635a8..97e717f 100644
--- a/app/lookup/[domain]/_components/ip-link.tsx
+++ b/app/lookup/[domain]/_components/ip-link.tsx
@@ -1,7 +1,6 @@
'use client';
import { InfoIcon } from 'lucide-react';
-import { usePlausible } from 'next-plausible';
import { type FC, useCallback, useState } from 'react';
import {
@@ -11,6 +10,8 @@ import {
TooltipTrigger,
} from '@/components/ui/tooltip';
+import { useAnalytics } from '@/lib/analytics';
+
import { IpDetailsModal } from './ip-details-modal';
type IpLinkProps = {
@@ -18,13 +19,13 @@ type IpLinkProps = {
};
export const IpLink: FC<IpLinkProps> = ({ value }) => {
- const plausible = usePlausible();
+ const { reportEvent } = useAnalytics();
const [isOpen, setOpen] = useState(false);
const open = useCallback(() => {
setOpen(true);
- plausible('IP Details: Open', { props: { ip: value } });
- }, [setOpen, plausible, value]);
+ reportEvent('IP Details: Open', { ip: value });
+ }, [setOpen, reportEvent, value]);
return (
<>
diff --git a/app/lookup/[domain]/_components/share-button.tsx b/app/lookup/[domain]/_components/share-button.tsx
index 5b954ab..d6d73fe 100644
--- a/app/lookup/[domain]/_components/share-button.tsx
+++ b/app/lookup/[domain]/_components/share-button.tsx
@@ -1,14 +1,15 @@
'use client';
import { Share2Icon } from 'lucide-react';
-import { usePlausible } from 'next-plausible';
import { type FC, useCallback } from 'react';
import { toast } from 'sonner';
import { Button } from '@/components/ui/button';
+import { useAnalytics } from '@/lib/analytics';
+
export const ShareButton: FC = () => {
- const plausible = usePlausible();
+ const { reportEvent } = useAnalytics();
const onClick = useCallback(() => {
if ('share' in navigator) {
@@ -22,10 +23,10 @@ export const ShareButton: FC = () => {
toast('Copied to clipboard');
}
- plausible('Share: Click', {
- props: { url: window.location.pathname + window.location.search },
+ reportEvent('Share: Click', {
+ url: window.location.pathname + window.location.search,
});
- }, [plausible]);
+ }, [reportEvent]);
return (
<Button
diff --git a/lib/analytics.ts b/lib/analytics.ts
new file mode 100644
index 0000000..f0439fa
--- /dev/null
+++ b/lib/analytics.ts
@@ -0,0 +1,40 @@
+import { usePlausible } from 'next-plausible';
+import { useCallback, useMemo } from 'react';
+
+type EmptyEvent = Record<string, never>;
+
+type Events = {
+ 'Copy Button: Click': { value: string };
+ 'Feedback: Negative': EmptyEvent;
+ 'Feedback: Neutral': EmptyEvent;
+ 'Feedback: Positive': EmptyEvent;
+ 'IP Details: Open': { ip: string };
+ 'Location Selector: Change': { location: string };
+ 'Outbound Link: Click': { url: string };
+ 'Resolver Selector: Change': { resolver: string };
+ 'Search Form: Click Suggestion': { domain: string; isExample: boolean };
+ 'Search Form: Submit': { domain: string };
+ 'Share: Click': { url: string };
+ 'Star Reminder: Click': EmptyEvent;
+ 'Star Reminder: Show': EmptyEvent;
+ 'Star Reminder: Suppress': EmptyEvent;
+ 'Trace: Click': { type: string; domain: string };
+};
+
+export const useAnalytics = () => {
+ const plausible = usePlausible();
+
+ const reportEvent = useCallback(
+ <T extends keyof Events>(event: T, props: Events[T]) => {
+ plausible(event, { props });
+ },
+ [plausible],
+ );
+
+ return useMemo(
+ () => ({
+ reportEvent,
+ }),
+ [reportEvent],
+ );
+};