📈 Open source, privacy-first web analytics — a cookie-less Google Analytics alternative with built-in error tracking and performance monitoring. Self-host it or use our cloud. Get started for free!
TypeScript chartsclickhousedockergdprgoogle-analyticsmetricsmonitoringmysqlnestjsprivacyredisself-hostedselfhostedstatisticstailwindcssweb-analyticswebanalyticswebsite
feat: Internet connection status banner
Blue Mouse4711fa553da4
diff --git a/web/app/components/OfflineBanner.tsx b/web/app/components/OfflineBanner.tsxnew file mode 100644index 000000000..41f65f463--- /dev/null+++ b/web/app/components/OfflineBanner.tsx@@ -0,0 +1,67 @@+import { WifiSlashIcon, ArrowClockwiseIcon } from '@phosphor-icons/react'+import { AnimatePresence, motion } from 'framer-motion'+import { memo } from 'react'+import { useTranslation } from 'react-i18next'++import { useNetworkStatus } from '~/hooks/useNetworkStatus'+import { cn } from '~/utils/generic'++interface OfflineBannerProps {+ onRetry?: () => void+ className?: string+}++const OfflineBanner = ({ onRetry, className }: OfflineBannerProps) => {+ const { t } = useTranslation('common')+ const { isOnline, lastSyncedAt } = useNetworkStatus()++ const formattedTime = lastSyncedAt+ ? lastSyncedAt.toLocaleTimeString(undefined, {+ hour: '2-digit',+ minute: '2-digit',+ })+ : null++ return (+ <AnimatePresence>+ {!isOnline ? (+ <motion.div+ initial={{ height: 0, opacity: 0 }}+ animate={{ height: 'auto', opacity: 1 }}+ exit={{ height: 0, opacity: 0 }}+ transition={{ duration: 0.2, ease: 'easeOut' }}+ className={cn('overflow-hidden', className)}+ >+ <div className='flex items-center justify-between gap-3 rounded-lg border border-amber-200 bg-amber-50 px-4 py-2.5 dark:border-amber-900/50 dark:bg-amber-950/40'>+ <div className='flex items-center gap-2.5'>+ <WifiSlashIcon+ weight='duotone'+ className='size-4 shrink-0 text-amber-600 dark:text-amber-400'+ />+ <p className='text-sm font-medium text-amber-800 dark:text-amber-200'>+ {t('project.offline')}+ {formattedTime ? (+ <span className='ml-1 font-normal text-amber-600 dark:text-amber-400'>+ {t('project.lastSynced', { time: formattedTime })}+ </span>+ ) : null}+ </p>+ </div>+ {onRetry ? (+ <button+ type='button'+ onClick={onRetry}+ className='inline-flex shrink-0 items-center gap-1.5 rounded-md px-2.5 py-1 text-xs font-medium text-amber-700 transition-colors hover:bg-amber-100 dark:text-amber-300 dark:hover:bg-amber-900/40'+ >+ <ArrowClockwiseIcon className='size-3.5' />+ {t('project.retry')}+ </button>+ ) : null}+ </div>+ </motion.div>+ ) : null}+ </AnimatePresence>+ )+}++export default memo(OfflineBanner)diff --git a/web/app/entry.client.tsx b/web/app/entry.client.tsxindex bd0a87b4c..b88b724a9 100644--- a/web/app/entry.client.tsx+++ b/web/app/entry.client.tsx@@ -45,15 +45,33 @@ const handleChunkError = (error: unknown): boolean => {return false}+const isNetworkError = (error: unknown): boolean => {+ if (!error) return false+ const message = error instanceof Error ? error.message : String(error)+ return (+ !navigator.onLine ||+ /NetworkError/i.test(message) ||+ /Failed to fetch/i.test(message) ||+ /Load failed/i.test(message) ||+ (/fetch/i.test(message) && error instanceof TypeError)+ )+}+// Global error handler for uncaught chunk loading errorswindow.addEventListener('error', (event) => {handleChunkError(event.error)})-// Handle unhandled promise rejections (dynamic imports)+// Handle unhandled promise rejections (dynamic imports + network errors)window.addEventListener('unhandledrejection', (event) => {if (handleChunkError(event.reason)) {event.preventDefault()+ return+ }++ if (isNetworkError(event.reason)) {+ event.preventDefault()+ console.warn('[Swetrix] Network request failed (offline?)', event.reason)}})diff --git a/web/app/hooks/useAnalyticsProxy.ts b/web/app/hooks/useAnalyticsProxy.tsindex a1f0a85be..65a3bbba0 100644--- a/web/app/hooks/useAnalyticsProxy.ts+++ b/web/app/hooks/useAnalyticsProxy.ts@@ -47,6 +47,10 @@ interface ProxyResponse<T> {}async function postAnalytics<T>(payload: unknown): Promise<ProxyResponse<T>> {+ if (typeof navigator !== 'undefined' && !navigator.onLine) {+ throw new Error('No internet connection')+ }+const response = await fetch('/api/analytics', {method: 'POST',headers: { 'Content-Type': 'application/json' },diff --git a/web/app/hooks/useNetworkStatus.ts b/web/app/hooks/useNetworkStatus.tsnew file mode 100644index 000000000..d10e48908--- /dev/null+++ b/web/app/hooks/useNetworkStatus.ts@@ -0,0 +1,71 @@+import { useCallback, useEffect, useRef, useSyncExternalStore } from 'react'++function subscribe(callback: () => void) {+ window.addEventListener('online', callback)+ window.addEventListener('offline', callback)+ return () => {+ window.removeEventListener('online', callback)+ window.removeEventListener('offline', callback)+ }+}++function getSnapshot() {+ return navigator.onLine+}++function getServerSnapshot() {+ return true+}++let lastSyncedAt: Date | null = null+const listeners = new Set<() => void>()++function notifySyncListeners() {+ for (const listener of listeners) {+ listener()+ }+}++export function markSynced() {+ lastSyncedAt = new Date()+ notifySyncListeners()+}++function subscribeSynced(callback: () => void) {+ listeners.add(callback)+ return () => {+ listeners.delete(callback)+ }+}++function getSyncedSnapshot() {+ return lastSyncedAt+}++export function useNetworkStatus() {+ const isOnline = useSyncExternalStore(+ subscribe,+ getSnapshot,+ getServerSnapshot,+ )+ const syncedAt = useSyncExternalStore(+ subscribeSynced,+ getSyncedSnapshot,+ () => null,+ )+ const wasOfflineRef = useRef(false)++ useEffect(() => {+ if (!isOnline) {+ wasOfflineRef.current = true+ }+ }, [isOnline])++ const justReconnected = isOnline && wasOfflineRef.current++ const clearReconnected = useCallback(() => {+ wasOfflineRef.current = false+ }, [])++ return { isOnline, lastSyncedAt: syncedAt, justReconnected, clearReconnected }+}diff --git a/web/app/pages/Project/View/ViewProject.tsx b/web/app/pages/Project/View/ViewProject.tsxindex f07b92747..780b74af7 100644--- a/web/app/pages/Project/View/ViewProject.tsx+++ b/web/app/pages/Project/View/ViewProject.tsx@@ -47,6 +47,8 @@ import { toast } from 'sonner'import EventsRunningOutBanner from '~/components/EventsRunningOutBanner'import Footer from '~/components/Footer'import Header from '~/components/Header'+import OfflineBanner from '~/components/OfflineBanner'+import { useNetworkStatus, markSynced } from '~/hooks/useNetworkStatus'import useSize from '~/hooks/useSize'import { changeLanguage } from '~/i18n'import {@@ -692,6 +694,14 @@ const ViewProjectContent = () => {setItem(LS_IS_ACTIVE_COMPARE_KEY, isActiveCompare ? 'true' : 'false')}, [isActiveCompare])+ const { isOnline, justReconnected, clearReconnected } = useNetworkStatus()++ useEffect(() => {+ if (project && !authLoading) {+ markSynced()+ }+ }, [project, authLoading])+const [showFiltersSearch, setShowFiltersSearch] = useState(false)const [isMobileSidebarOpen, setIsMobileSidebarOpen] = useState(false)@@ -911,6 +921,15 @@ const ViewProjectContent = () => {[authLoading, dataLoading, activeTab],)+ useEffect(() => {+ if (justReconnected && isOnline) {+ refreshStats(false).finally(() => {+ clearReconnected()+ markSynced()+ })+ }+ }, [justReconnected, isOnline, refreshStats, clearReconnected])+useEffect(() => {setPeriodPairsCompare(tbPeriodPairsCompare(t, undefined, language))}, [t, language])@@ -1484,6 +1503,10 @@ const ViewProjectContent = () => {ref={dashboardRef}><EventsRunningOutBanner />+ <OfflineBanner+ onRetry={() => refreshStats(true)}+ className='mb-2'+ />{!isMapFullscreen ? (<div className='pointer-events-auto'><MobileSidebarTriggerdiff --git a/web/app/root.tsx b/web/app/root.tsxindex 5237de628..18ca528a1 100644--- a/web/app/root.tsx+++ b/web/app/root.tsx@@ -2,6 +2,7 @@ import {WarningOctagonIcon,CaretDownIcon,CaretUpIcon,+ WifiSlashIcon,} from '@phosphor-icons/react'import BillboardCss from 'billboard.js/dist/billboard.min.css?url'import cx from 'clsx'@@ -101,11 +102,29 @@ export async function action() {})}+function isNetworkError(error: unknown): boolean {+ if (!(error instanceof Error)) return false+ const msg = error.message.toLowerCase()+ return (+ msg.includes('networkerror') ||+ msg.includes('failed to fetch') ||+ msg.includes('load failed') ||+ msg.includes('network request failed') ||+ (error instanceof TypeError && msg.includes('fetch'))+ )+}+export function ErrorBoundary() {const error = useRouteError()const [crashStackShown, setCrashStackShown] = useState(false)+ const networkError =+ !isRouteErrorResponse(error) &&+ error instanceof Error &&+ isNetworkError(error)useEffect(() => {+ if (networkError) return+if (isRouteErrorResponse(error)) {trackError({name: `ErrorBoundary: ${error.status} ${error.statusText}`,@@ -122,7 +141,55 @@ export function ErrorBoundary() {stackTrace: error.stack || '',})}- }, [error])+ }, [error, networkError])++ if (networkError) {+ return (+ <html lang='en' className={getCookie(LS_THEME_SETTING) || 'light'}>+ <head>+ <meta charSet='utf-8' />+ <title>Connection lost</title>+ <Links />+ </head>+ <body>+ <div+ style={{ minHeight: '100vh' }}+ className='flex flex-col bg-gray-50 pt-16 pb-12 dark:bg-slate-950'+ >+ <div className='mx-auto flex w-full max-w-7xl grow flex-col justify-center px-4 sm:px-6 lg:px-8'>+ <div className='flex shrink-0 justify-center'>+ <WifiSlashIcon+ weight='duotone'+ className='h-20 w-auto text-amber-500 dark:text-amber-400'+ />+ </div>+ <div className='py-8'>+ <div className='text-center'>+ <h1 className='text-3xl font-bold text-gray-900 sm:text-4xl dark:text-gray-50'>+ Connection lost+ </h1>+ <p className='mt-3 text-base text-gray-600 dark:text-gray-400'>+ It looks like you lost your internet connection.+ <br />+ Check your network and try again.+ </p>+ <button+ type='button'+ onClick={() => window.location.reload()}+ className='mt-6 inline-flex cursor-pointer items-center rounded-lg bg-slate-900 px-5 py-2.5 text-sm font-medium text-white transition-colors hover:bg-slate-800 dark:bg-slate-100 dark:text-slate-900 dark:hover:bg-slate-200'+ >+ Reload page+ </button>+ </div>+ </div>+ </div>+ </div>+ <ScrollRestoration />+ <Scripts />+ </body>+ </html>+ )+ }return (<html lang='en' className={getCookie(LS_THEME_SETTING) || 'light'}>diff --git a/web/app/routes/projects.$id.tsx b/web/app/routes/projects.$id.tsxindex 2a156f2a1..6d347da50 100644--- a/web/app/routes/projects.$id.tsx+++ b/web/app/routes/projects.$id.tsx@@ -8,6 +8,7 @@ import {type LinksFunction,type LoaderFunctionArgs,type MetaFunction,+ type ShouldRevalidateFunctionArgs,} from 'react-router'import { data, redirect } from 'react-router'@@ -99,6 +100,16 @@ export const links: LinksFunction = () => [{ rel: 'stylesheet', href: ProjectViewStyle },]+export function shouldRevalidate({+ defaultShouldRevalidate,+}: ShouldRevalidateFunctionArgs) {+ if (typeof navigator !== 'undefined' && !navigator.onLine) {+ return false+ }++ return defaultShouldRevalidate+}+export const meta: MetaFunction<typeof loader> = ({ data, location }) => {// eslint-disable-next-line react-hooks/rules-of-hooksconst { t } = useTranslation('common')diff --git a/web/public/locales/en.json b/web/public/locales/en.jsonindex 7a31b3687..f0124b174 100644--- a/web/public/locales/en.json+++ b/web/public/locales/en.json@@ -1411,6 +1411,9 @@"lookingForMore": "Looking for more?","overrideCurrentlyFilters": "Override currently applied filters","noExist": "The selected project does not exist",+ "offline": "No internet connection",+ "lastSynced": "· Last synced at {{time}}",+ "retry": "Retry","geo": "Geolocation","browserInfo": "Browser information","urlInfo": "URL information",