Add Gizmo Analytics provider

.changeset/add-gizmo-analytics.md

@@ -0,0 +1,5 @@
+---
+'pliny': minor
+---
+
+Add Gizmo Analytics as a new provider in the `Analytics` component. Cookieless, GDPR-friendly tracker; no consent banner required. Configured via `gizmoAnalytics: { gizmoPublicKey: '...' }` in `AnalyticsConfig`.

README.md

@@ -9,6 +9,7 @@ Pliny provides out of the box components to enhance your static site:
   - Umami Analytics
   - Posthog
   - Microsoft Clarity
+  - Gizmo Analytics
 - Comments
   - Disqus
   - Giscus

packages/pliny/src/analytics/Gizmo.tsx

@@ -0,0 +1,28 @@
+import Script from 'next/script'
+
+/**
+ * Props for the Gizmo Analytics component.
+ *
+ * Gizmo is a cookieless web analytics service — no cookies, no
+ * localStorage, no fingerprinting, no consent banner required.
+ * https://gizmoanalytics.io
+ */
+export interface GizmoProps {
+  /** The public API key for your Gizmo site. Starts with `ak_public_`. */
+  gizmoPublicKey: string
+  /** Source URL for the Gizmo tracker script. Defaults to the hosted CDN. */
+  src?: string
+}
+
+/**
+ * A React component that integrates Gizmo Analytics via a script tag.
+ *
+ * @param props - The props for the Gizmo component.
+ * @returns A Script element with the Gizmo analytics tracker.
+ */
+export const Gizmo = ({
+  src = 'https://gizmoanalytics.io/script.js',
+  gizmoPublicKey,
+}: GizmoProps) => {
+  return <Script async defer src={src} data-key={gizmoPublicKey} />
+}

packages/pliny/src/analytics/index.tsx

@@ -5,6 +5,7 @@ import { SimpleAnalytics, SimpleAnalyticsProps } from './SimpleAnalytics.js'
 import { Umami, UmamiProps } from './Umami'
 import { Posthog, PosthogProps } from './Posthog'
 import { Clarity, ClarityProps } from './MicrosoftClarity'
+import { Gizmo, GizmoProps } from './Gizmo'
 
 declare global {
   interface Window {
@@ -21,6 +22,7 @@ export interface AnalyticsConfig {
   posthogAnalytics?: PosthogProps
   simpleAnalytics?: SimpleAnalyticsProps
   clarityAnalytics?: ClarityProps
+  gizmoAnalytics?: GizmoProps
 }
 
 /**
@@ -41,7 +43,7 @@ export interface AnalyticsProps {
 const isProduction = process.env.NODE_ENV === 'production'
 
 /**
- * Supports Plausible, Simple Analytics, Umami, Posthog or Google Analytics.
+ * Supports Plausible, Simple Analytics, Umami, Posthog, Google Analytics, or Gizmo.
  * All components default to the hosted service, but can be configured to use a self-hosted
  * or proxied version of the script by providing the `src` / `apiHost` props.
  *
@@ -71,10 +73,13 @@ export const Analytics = ({ analyticsConfig }: AnalyticsProps) => {
       {isProduction && analyticsConfig.clarityAnalytics && (
         <Clarity {...analyticsConfig.clarityAnalytics} />
       )}
+      {isProduction && analyticsConfig.gizmoAnalytics && (
+        <Gizmo {...analyticsConfig.gizmoAnalytics} />
+      )}
     </>
   )
 }
 
-export { GA, Plausible, SimpleAnalytics, Umami, Posthog, Clarity }
+export { GA, Plausible, SimpleAnalytics, Umami, Posthog, Clarity, Gizmo }
 
-export type { GoogleAnalyticsProps, PlausibleProps, UmamiProps, PosthogProps, SimpleAnalyticsProps, ClarityProps }
+export type { GoogleAnalyticsProps, PlausibleProps, UmamiProps, PosthogProps, SimpleAnalyticsProps, ClarityProps, GizmoProps }