Implement predictive Next.js route prefetching based on user cursor velocity and trajectory vectors

[Damola-Sodiq]

Description

Create a mathematically driven prefetching engine that analyzes the user's mouse trajectory to predict which asset page they will click, initiating tRPC queries preemptively.

Architecture & Context

Standard Next.js <Link> hover-prefetching is often too late for fast interactions. By calculating the intersection of the cursor's path with bounding boxes of asset cards, the network request can begin 100-200ms before the actual click event, providing a zero-latency feel.

Technical Requirements

• Implement a requestAnimationFrame loop to track mouse velocity vectors globally.
• Utilize standard 2D vector math to calculate collisions with pre-registered DOM rectangles.
• Trigger queryClient.prefetchQuery when the collision probability exceeds a strict threshold.

Acceptance Criteria

• Data fetching reliably begins milliseconds prior to the physical mouse click.
• The mathematical loop consumes less than 1% of the rendering frame budget.
• Mobile devices gracefully fallback to standard IntersectionObserver prefetching.

[Stanley-Owoh]

Good day maintainer,
please I would like to work on this issue. I will implement a predictive prefetching engine that tracks cursor velocity and trajectory using a requestAnimationFrame loop, calculate collision probabilities against registered asset card boundaries, and trigger queryClient.prefetchQuery before user clicks when the threshold is met. I will also ensure the solution stays within the required performance budget, provide a graceful IntersectionObserver fallback for mobile devices, and add the necessary tests to validate the behavior. I can work on this immediately, please assign this issue to me. Thank you.

[grantfox-oss]

🦊 GrantFox — @Stanley-Owoh has been assigned to this issue as part of the Official Campaign | FWC26 campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #471)
2. Your PR will be reviewed by the Sahara-Pay maintainers

Good luck! Track your progress on GrantFox.