docs: Waku router under the hood and add guides to website

[tylersayshi]

This is an idea for a router post. I am happy to reword, restructure or whatever.

It was helpful for me to organize my thoughts to look a bit closer at what is loaded when on each route, so I think a post to talk through some of this has some value.

Excited to hear what y'all think :)

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

1 Skipped Deployment

Name	Status	Preview	Updated (UTC)
waku	⬜️ Ignored (Inspect)	Visit Preview	Mar 20, 2025 7:07am

[dai-shi]

Merging this for now. I think there should be room for improvement for website, like ordering guides, and styling.

[rmarscher]

Maybe we should mention that Suspense and promises passed from the server can be used in layouts or pages to be able to display content while the rest is still being streamed down from the server. We could link out to the React docs about Suspense for people to learn more about it - https://react.dev/reference/react/Suspense

By default, a useTransition hook is used when navigating with the component. That causes the stale content inside Suspense to continue to display until the new content has loaded. There's an experimental unstable_startTransition to supply a different function to call. This can be the startTransition from your own useTransition hook call which can give you access to the isPending state. Or it's possible to pass a no-op function to skip useTransition entirely.

[dai-shi]

By default, a useTransition hook is used when navigating with the component.

That's no longer the case. #1257