Changelog
All notable changes to sanity-plugin-ga-dashboard. Follows Keep a Changelog · Semantic Versioning
+Added~Changed×Fixed−Removed⚑Security!Deprecated
v1.0.7Mar 13, 2026latest·3
· 📝 Documentation
·added README.md with comprehensive documentation: architecture overview, full setup guide, configuration reference, dashboard tabs breakdown, all exported TypeScript types, API reference with query params and response shape, and a troubleshooting section with common errors and fixes
·Corrected environment variable names (GA_PROPERTY_ID, GA_SERVICE_ACCOUNT_EMAIL, GA_PRIVATE_KEY) to match actual implementation
·Added requirements table, compatibility matrix, and private key formatting guidance
v1.0.6Mar 12, 2026·1
· 🔧 Changed
·Updated all dependencies to their latest versions, including recharts and jose
v1.0.5Mar 12, 2026·1×1
· 🔧 Changed
·Sitemap submit functionality (submit form, re-submit row button) is temporarily hidden in the Search Console Sitemaps tab and marked as a future enhancement; the underlying logic and API route handler (POST) remain in place for when it is re-enabled
× 🐛 Fixed
×Overflow handling in both GA and Search Console dashboards: main content area now uses overflow: auto + overflowX: hidden so the page scrolls vertically without producing a horizontal scrollbar; data tables use overflowX: auto on their wrapper so wide tables scroll horizontally on narrow viewports instead of breaking the layout
v1.0.4Mar 12, 2026·1
· 🔧 Changed
·recharts and jose are now fully bundled into the package — consumers no longer need to install either as a dependency; the plugin is entirely self-contained
v1.0.3Mar 12, 2026+12
+ ✨ Added
+Google Search Console integration — new searchConsolePlugin for Sanity Studio
+SearchConsoleTool component and SearchConsoleDashboard with seven tabs: Overview, Queries, Pages, Countries, Devices, Search Appearance, and Sitemaps
+Four date range options for Search Console: 7 days, 28 days, 3 months, and 6 months
+Built-in searchConsoleHandler API route (GET + POST) exported via the new sanity-plugin-ga-dashboard/search-console-api sub-path
+8 parallel Search Console API queries (overview, queries, pages, time series, countries, devices, search appearance, sitemaps) using Promise.allSettled()
+Sitemap submit support — POST to the API route to submit or refresh a sitemap via the Search Console API
+Search appearance label mapping with human-readable names for all known Google Search result types (Rich Result, AMP, Video, Web Story, etc.)
+Country name resolution from ISO 3166-1 alpha-3 codes to display names for 60+ countries
+Tooltip info icons on metrics and sections with plain-English explanations
+Skeleton shimmer loading state and smooth fade-in animations for the Search Console dashboard
+New exported types: SearchConsolePluginConfig, SearchConsoleData, ScDateRange, ScQuery, ScPage, ScCountry, ScDevice, ScSearchAppearance, Sitemap
+New SEARCH_CONSOLE_SITE_URL environment variable support for the API handler
v1.0.2Mar 12, 2026+1·1
+ ✨ Added
+disabled configuration option to control plugin visibility based on environment (e.g., production-only)
· 🔧 Changed
·Moved recharts from peerDependencies to dependencies for automatic installation
v1.0.1Mar 12, 2026·1
· 🔧 Fixed
·Improved code formatting and consistency: standardized quote usage, spacing, and line breaks
v1.0.0Mar 11, 2025+19
+ ✨ Added
+Google Analytics 4 dashboard tool for Sanity Studio
+Seven dashboard tabs: Overview, Traffic, Content, Audience, Geography, Events, and Acquisition
+Real-time active users counter updated every 30 seconds
+Date range picker supporting 7, 14, 30, and 90-day windows
+16 parallel GA4 Data API queries for fast, simultaneous data loading
+Built-in API route handler (googleAnalyticsHandler) for Next.js and other frameworks
+JWT-based Google service account authentication using the jose library
+In-memory token caching with a 1-hour lifetime to reduce auth overhead
+HTTP response caching (5-minute public cache + 60-second stale-while-revalidate)
+Error-resilient data fetching with Promise.allSettled() — partial failures never crash the dashboard
+Recharts-powered responsive visualisations: area charts, bar charts, pie charts, and line charts
+Full dark/light mode support that respects Sanity Studio's colour scheme
+Geography tab with country-level breakdown and flag emoji support
+Content performance tab with page-level pageview, session, and bounce-rate metrics
+Audience tab with new vs returning visitors, session duration, and browser breakdown
+Events tab with top event tracking and conversion rate display
+TypeScript support with exported types for GoogleAnalyticsConfig and GoogleAnalyticsPluginOptions
+Zero-config setup — sensible defaults for all optional fields
+sanity-plugin-ga-dashboard/api sub-path export for server-side handler import