{content}
diff --git a/components/dashboard/NavLink.tsx b/components/dashboard/NavLink.tsx
new file mode 100644
index 00000000..f08c1460
--- /dev/null
+++ b/components/dashboard/NavLink.tsx
@@ -0,0 +1,57 @@
+'use client'
+
+import Link, { type LinkProps } from 'next/link'
+import { usePathname, useRouter } from 'next/navigation'
+import { useCallback, type ComponentProps } from 'react'
+import { shouldWarmNavRoute } from './nav-prefetch'
+
+type Props = Omit, 'prefetch'> & { href: LinkProps['href'] }
+
+/**
+ * Sidebar / rail / mobile nav link with hover-intent prefetching.
+ *
+ * Why not the default viewport prefetch: the dashboard nav renders ~45
+ * links, every one of which is a dynamic route with a loading boundary, so
+ * Next prefetched all of them the moment the nav mounted. Each prefetch is
+ * a full request through the auth proxy (Supabase Auth round trip, the
+ * active-company RPC, the MFA check) whose only payload is the shared
+ * loading skeleton. Prod logs showed 1,000 to 1,300 such hits per nav route
+ * per day. Warming on hover/focus/touch keeps the perceived-instant click
+ * for the one or two links a user is about to use and drops the other ~43.
+ *
+ * `prefetch={false}` also disables Link's own hover prefetch (next/link only
+ * hover-prefetches when viewport prefetch is enabled), so the warm-up is an
+ * explicit router.prefetch. onFocus covers keyboard users; onTouchStart
+ * gives the mobile bottom nav a ~100 ms head start before the tap lands.
+ */
+export function NavLink({ href, onMouseEnter, onFocus, onTouchStart, children, ...rest }: Props) {
+ const router = useRouter()
+ const pathname = usePathname()
+ const hrefString = typeof href === 'string' ? href : (href.pathname ?? '')
+
+ const warm = useCallback(() => {
+ if (shouldWarmNavRoute(hrefString, pathname)) router.prefetch(hrefString)
+ }, [hrefString, pathname, router])
+
+ return (
+ {
+ warm()
+ onMouseEnter?.(e)
+ }}
+ onFocus={(e) => {
+ warm()
+ onFocus?.(e)
+ }}
+ onTouchStart={(e) => {
+ warm()
+ onTouchStart?.(e)
+ }}
+ {...rest}
+ >
+ {children}
+
+ )
+}
diff --git a/components/dashboard/__tests__/nav-prefetch.test.ts b/components/dashboard/__tests__/nav-prefetch.test.ts
new file mode 100644
index 00000000..0c86badb
--- /dev/null
+++ b/components/dashboard/__tests__/nav-prefetch.test.ts
@@ -0,0 +1,33 @@
+import { describe, it, expect } from 'vitest'
+import fs from 'node:fs'
+import path from 'node:path'
+import { shouldWarmNavRoute } from '../nav-prefetch'
+
+describe('shouldWarmNavRoute', () => {
+ it('warms other internal routes, ignoring query and hash', () => {
+ expect(shouldWarmNavRoute('/invoices', '/transactions')).toBe(true)
+ expect(shouldWarmNavRoute('/invoices?status=draft', '/transactions')).toBe(true)
+ expect(shouldWarmNavRoute('/reports#top', '/transactions')).toBe(true)
+ })
+
+ it('does not warm the current route or non-routes', () => {
+ expect(shouldWarmNavRoute('/invoices', '/invoices')).toBe(false)
+ expect(shouldWarmNavRoute('/invoices?x=1', '/invoices')).toBe(false)
+ expect(shouldWarmNavRoute('https://example.com', '/')).toBe(false)
+ expect(shouldWarmNavRoute('//evil.example', '/')).toBe(false)
+ expect(shouldWarmNavRoute('#section', '/')).toBe(false)
+ })
+
+ it('warms when the pathname is unknown (first render)', () => {
+ expect(shouldWarmNavRoute('/invoices', null)).toBe(true)
+ })
+})
+
+describe('DashboardNav uses NavLink for every link', () => {
+ it('has no bare next/link usage left, so no nav link prefetches on viewport', () => {
+ const source = fs.readFileSync(path.resolve(__dirname, '..', 'DashboardNav.tsx'), 'utf8')
+ expect(source).not.toMatch(/from 'next\/link'/)
+ expect(source).not.toMatch(/]/)
+ expect(source).toMatch(/]/)
+ })
+})
diff --git a/components/dashboard/nav-prefetch.ts b/components/dashboard/nav-prefetch.ts
new file mode 100644
index 00000000..2968f23f
--- /dev/null
+++ b/components/dashboard/nav-prefetch.ts
@@ -0,0 +1,12 @@
+/**
+ * Whether hovering/focusing a nav link should warm its route.
+ *
+ * The link to the page you are already on has nothing to warm, and a
+ * hash-only or external href is not a route. Pure so it can be unit tested.
+ */
+export function shouldWarmNavRoute(href: string, currentPathname: string | null): boolean {
+ if (!href.startsWith('/')) return false
+ if (href.startsWith('//')) return false
+ const path = href.split(/[?#]/)[0]
+ return path !== currentPathname
+}
diff --git a/next.config.ts b/next.config.ts
index 554d1b08..26599431 100644
--- a/next.config.ts
+++ b/next.config.ts
@@ -94,6 +94,14 @@ const nextConfig: NextConfig = {
skipTrailingSlashRedirect: true,
experimental: {
optimizePackageImports: ['recharts', 'date-fns', 'framer-motion'],
+ // Client router cache for dynamic routes: a page visited in the last
+ // 30 s (back/forward, re-clicking a nav item) re-renders from the cached
+ // RSC payload instead of a new server request through the auth proxy.
+ // Mutation flows already call router.refresh() where a stale server
+ // render would mislead (16 sites); the client-side reference-data cache
+ // (lib/reference-data) is independent of this and refreshes on its own.
+ // Default was 0 (always refetch). Static routes keep the 5 min default.
+ staleTimes: { dynamic: 30, static: 300 },
},
// PostHog reverse proxy. Keeping analytics same-origin buys three things:
// the strict CSP below needs NO posthog hosts (`connect-src 'self'` already