@spicy-hooks/observables
v3.0.0
Published
**React Hooks for easy plugging of RxJS observables into React.**
Downloads
419
Readme
@spicy-hooks/observables
React Hooks for easy plugging of RxJS observables into React.
WORK IN PROGRESS - We're still gathering reasonable arguments to lure you into using our package.
Have you ever tried "replacing Redux with Context API and React Hooks"? (By the way, this must be one of the most Googled phrases in the last two years)
If you had, you must have faced at least the following questions:
- How to optimally work with complex shapes without triggering thousands of unnecessary renders?
- How to share transformations of the state between multiple components?
- How to keep logic at least a bit separated from components?
Our answer to those questions come in the form of @spicy-hooks/observables
package.
This package is a part of the @spicy-hooks
family.
Be sure to checkout the other interesting packages we offer.
Concept
TODO Describe the overall concept of RxJS powered React
Until the above TODO is resolved, feel free to get a general idea by:
Installation
The package uses RxJS under the hood, but we leave it up to you to choose the version you want to use. Make sure you have one installed though.
npm install @spicy-hooks/observables rxjs --save
or
yarn add @spicy-hooks/observables rxjs
Versioning
The whole @spicy-hooks
project complies with Semantic Versioning.
The @spicy-hooks/observables
package is however just one package from the whole project.
Seeing the major version incremented therefore doesn't necessarily mean that there
is a breaking change in this particular package. Check the
CHANGELOG.md
for accurate information.
It is guaranteed though, that when the major version doesn't change, there has been no breaking change in this package.
Warning: The internal
folder is excluded from any semantic versioning conventions.
Importing from this folder directly is strongly discouraged.
Issues
Please submit any issue or feature request on the main project. (issue templates coming soon)
Documentation
- API reference - detailed description of every included hook, operator and utility function
- contribution guide - when you want to get involved