feat: structural canvas via route groups (removes usePathname/Suspense)

[ignmandagaran]

Summary

Replaces the usePathname + BLACKLISTED_PATHS runtime check in ContentWrapper (the last page-level <Suspense> after Cache Components adoption) with a structural route-group approach. Now fully wired and verified — ContentWrapper/usePathname are removed.

Stacked on #422.

Mechanism

• CanvasLayer — the single 3D canvas, mounted once in the root layout (persists across nav). Visibility driven by store flags, no usePathname → no <Suspense>.
• Two-flag persistence: isCanvasInPage (sticky — keeps the WebGL Scene mounted across navigations) + canvasVisible (per-route show/hide).
• SetCanvasMode — a client effect-setter each group layout renders to declare canvas on/off (client-only → no prerender hazard).
• PageShell — shared <main>+Footer chrome for the (content) sub-layout in both groups.

Structure

(site)/layout.tsx            -> <CanvasLayer/> + {children}
(site)/(canvas)/layout.tsx   -> <SetCanvasMode enabled/> + mt-[100dvh] container
       (content)/            -> <PageShell/>  [home, services, people, blog, showcase index]
       basketball, doom, lab
(site)/(plain)/layout.tsx    -> <SetCanvasMode enabled={false}/>
       (content)/            -> <PageShell/>  [post/[slug], careers/[slug], showcase/[slug]]
       contact

/showcase (canvas) and /showcase/[slug] (plain) split cleanly across groups — Next accepts it.

Verified

• Build green, 89/89. No usePathname, no ContentWrapper Suspense.
• Runtime QA (browser): canvas shows on home/services, hides on post (content intact), WebGL canvas stays mounted across plain routes (persistence), re-shows on canvas routes; margin offset correct; no console errors.

Notes / follow-ups

• lab stays ƒ (its own instant = false user-agent redirect — unrelated to canvas).
• 404 (not-found.tsx) sets canvas mode directly; the 404-within-a-plain-route path is worth a manual check.
• This is a sizable diff (route folders moved + 21 import updates) — review the move + import rewrites.

Checklist

• Build passes (89/89)
• Tested locally in dev mode (canvas show/hide/persist + nav)
• No usePathname/page-level <Suspense> for the canvas

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
website-2k25	Ready	Preview, Comment	Jun 26, 2026 7:23pm