Persistent issue with __next_navigation_guard_token

[Nefertisu]

Hello!

First of all, thank you for creating this library — as far as I can see, there are currently no proper alternatives to it.

Unfortunately, according to our logs, users constantly encounter the following error:

Cannot read properties of null (reading '__next_navigation_guard_token')
After a long investigation, I wasn’t able to find the root cause of this problem.

Would it be possible to add a fix or at least improve the error message, so that when __next_navigation_guard_token is accessed from an undefined value, the library could provide a more descriptive message —

something like:

“NavigationGuardProvider is not initialized properly”

or any other meaningful explanation that would help identify configuration issues?

We are using Next.js 15.5.7 (App Router).

Thanks in advance! 🙏

[marko-hologram]

For me this issue happens if I have Link tags on page that link to IDs on page.

<Link href="#page-section">Page section link</a>

...

<div id="page-section">Page section element</div>

Clicking this link shows this error in browser dev tools console.

[paul-vd]

Same issue here when navigating to # id's in the page