Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Dynalon/reactive-state
Redux-clone build with strict typing and RxJS down to its core. Wrist-friendly, no boilerplate or endless switch statements
https://github.com/Dynalon/reactive-state
functional-reactive-programming react-redux redux rxjs state-management typescript
Last synced: about 1 month ago
JSON representation
Redux-clone build with strict typing and RxJS down to its core. Wrist-friendly, no boilerplate or endless switch statements
- Host: GitHub
- URL: https://github.com/Dynalon/reactive-state
- Owner: Dynalon
- License: mit
- Created: 2017-05-20T10:34:40.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-02-27T16:30:48.000Z (almost 2 years ago)
- Last Synced: 2024-04-15T07:39:44.606Z (8 months ago)
- Topics: functional-reactive-programming, react-redux, redux, rxjs, state-management, typescript
- Language: TypeScript
- Homepage:
- Size: 1.33 MB
- Stars: 137
- Watchers: 11
- Forks: 7
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://travis-ci.org/Dynalon/reactive-state)
[](https://badge.fury.io/js/reactive-state)
Reactive State
====
A typed, wrist-friendly state container aimed as an alternative to Redux when using RxJS. Written with RxJS in TypeScript but perfectly usable from plain JavaScript. Originally inspired by the blog posting from [Michael Zalecki](http://michalzalecki.com/use-rxjs-with-react/) but heavily modified and extended since.
Features
----
* type-safe actions: no boilerplate code, no mandatory string constants, and not a single switch statement
* Actions are just Observables, so are Subjects. Just call `.next()` to dispatch an action.
* dynamically add and remove reducers during runtime
* no need for async middlewares such as redux-thunk/redux-saga; actions are Observables and can be composed and transformed async using RxJS operators
* no need for selector libraries like MobX or Reselect, RxJS already ships it
* single, application-wide Store concept as in Redux. Possibility to create slices/substates for decoupling (easier reducer composition and state separation by module)
* Strictly typed to find errors during compile time
* Heavily unit tested, 100+ tests for ~250 lines of code
* React bridge (like `react-redux`) included, though using React is not mandatory
* Support for React-Devtool Extension
Installation
----
```
npm install reactive-state
```
Documentation
----
* [Wiki](https://github.com/Dynalon/reactive-state/wiki)
* [Demo App with annotated source](https://github.com/Dynalon/reactive-state-react-example) (includes react bridge examples)
Additionally, there is a small [example.ts file](https://github.com/Dynalon/reactive-state/blob/master/src/example.ts) and see also see the included [unit tests](https://github.com/Dynalon/reactive-state/tree/master/test) as well.
Example Usage
----
```typescript
import { Store } from "reactive-state";
import { Subject } from "rxjs";
import { take } from "rxjs/operators";
// The state for our example app
interface AppState {
counter: number;
}
const initialState: AppState = { counter: 0 }
const store = Store.create(initialState);
// The .watch() function returns an Observable that emits the selected state change, so we can subscribe to it
store.watch().subscribe(newState => console.log("STATE:", JSON.stringify(newState)));
// the watch() observable always caches the last emitted state, so we will immediately print our inital state:
// [CONSOLE.LOG]: STATE: {"counter":0}
// use a RxJS Subjects as an action
const incrementAction = new Subject();
// A reducer is a function that takes a state and an optional payload, and returns a new state
function incrementReducer(state, payload) {
return { ...state, counter: state.counter + payload };
};
store.addReducer(incrementAction, incrementReducer);
// lets dispatch some actions
incrementAction.next(1);
// [CONSOLE.LOG]: STATE: {"counter":1}
incrementAction.next(1);
// [CONSOLE.LOG]: STATE: {"counter":2}
// async actions? No problem, no need for a "middleware", just use RxJS
interval(1000).pipe(take(3)).subscribe(() => incrementAction.next(1));
//
// [CONSOLE.LOG]: STATE: {"counter":3}
//
// [CONSOLE.LOG]: STATE: {"counter":4}
//
// [CONSOLE.LOG]: STATE: {"counter":5}
```
License
----
MIT.