REASYNC
Library for connecting React components to async actions like fetching
Warning
The package is currently in beta version. Use with own risk. It's used in production on own closed-source app.
Docs
Why I need this?
Let's say we have universal application. We want to fetch some data on server, before server render. We also want to do some work only on server, before render and we want to track server action to let's say google analytics after render.
On the client, we hydrate app with data from server, but if server fail we want to fetch data from client. After data are fetched we want to start rendering, then fetch some data after render, you want do some action only on client and when everything is done we want to track some actions to analytics too. We want to track actions even if something before failed. We want to show user some loader before transition is done.
You can configure lifecycle of this events with reasync.
Why I have created this package?
Long time ago, few people started using react-redux project for managing routing state in redux. In those times, idea of prefetching and deferred fetching was used making router transition from one route to another more sophisticated. React-redux package was awesome, but it stared to get bloated and handling to much and it was also complicated to setup.
People started to migrate to react-router-redux, which was much more simplified, but it was not possible to easily create react-redux transition functionality. I found it awesome to be able to delay transition and to fetch data or do any other async work when i want to.
This package is not about how to fetch data, query some storage or another async actions. It's about way to tell, when i need to execute that async action. Do I need some data before server start to render? Do I need to track something only on server? Or load some storage only on client? Do I need them before page is shown to client? And what should be done before transition, what after?
Used in
Package was extracted from non-oss project, but it is used in my boilerplate:
- svrcekmichal/universal-react
- svrcekmichal/react-production-starter fork of awesome @jaredpalmer boilerplate React Production Starter
Related projects
- React Resolver by @ericclemmons
- React Transmit by @rygu
- AsyncProps for React Router by @ryanflorence
- React Async by @andreypopp
- Redial by @markdalgleish
Future
There's so much to do, like write tests, simplify usage, cleanup the mess