🗺 Streaming/Defer

[ryanflorence]

Adding defer, <Await>, etc. from React Router 6.4 and React 18 streaming support for document requests to Remix.

Depends on #4485

Progress

• RFC n/a
• PR
  • defer - initial attempt at exposing required data to ssr implementations react-router#9760
  • defer - for real this time #4920
• Prerelease
• Move existing docs - @jacob-ebey
• Needs new docs written - @ryanflorence

Issues/PRs

[laurencefass]

Do you have any links to docs detailing how this will work? Will it be using Server Components as a foundation?

Thanks

[sergiodxa]

@laurencefass here's a Gist from the team explaining how Deferred works https://gist.github.com/jacob-ebey/9bde9546c1aafaa6bc8c242054b1be26.

Will it be using Server Components as a foundation?

It's not using RSC, that's a beta technology and the Remix team has mentioned they don't want to depend on unstable things.

You can also read how it will be used on the React Router docs https://reactrouter.com/en/main/guides/deferred, the usage should be the same

1. Return a defer response from a loader with at least one key of the data being a promise
2. Use Suspense to render a fallback, use Await to wait for the promise to be ready

[ryanflorence]

@brophdawg11 to get with @jacob-ebey to work out the React Router release we need for this work, and moving over deferred branch test suite and open issues.

[jacob-ebey]

This work is included in experimental release: 0.0.0-experimental-2f4891673

[jacob-ebey]

@ryanflorence we need to bring the docs over. I have a fair amount I can link you to if you want to wrangle them up into the best places across remix and react router.

[jacob-ebey]

This has been released in 1.11.0

[jacob-ebey]

@ryanflorence I'll let you close this after you take a pass through the docs.

[ryanflorence]

made a note in my tasks, so gonna close this out, we have some docs (thanks!) so let's call this done!