Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ioof-holdings/redux-subspace

Build decoupled, componentized Redux apps with a single global store
https://github.com/ioof-holdings/redux-subspace

micro-frontends react redux redux-loop redux-observable redux-promise redux-saga redux-subspace redux-thunk

Last synced: about 2 months ago
JSON representation

Build decoupled, componentized Redux apps with a single global store

Awesome Lists containing this project

README

        

# redux-subspace

## Deprecated

**This library is no longer being actively maintained.**

IOOF has been slowly moving away from the ubiquitous use of Redux as a core piece of our micro-frontend architecture and have been actively replacing
the usage of this library with more standard React and JavaScript patterns. Due to some technical constraints, we've also been unable to upgrade to
the latest version of the library ourselves for quite some time now, further fuelling our desire to move away from this solution.

At this time, we will be ceasing all maintenance tasks and we recommend that you consider using an alternative library:

* [`redux-doghouse`](https://www.npmjs.com/package/redux-doghouse)
* [`redux-fractal`](https://www.npmjs.com/package/redux-fractal)
* [`lean-redux`](https://www.npmjs.com/package/lean-redux)
* [`redux-react-local`](https://www.npmjs.com/package/redux-react-local)
* [`multireducer`](https://www.npmjs.com/package/multireducer)

If you want to continue using this library, we encourage you to fork this repo and take over maintenance yourself.

---

[![npm version](https://img.shields.io/npm/v/redux-subspace.svg?style=flat-square)](https://www.npmjs.com/package/redux-subspace)
[![npm downloads](https://img.shields.io/npm/dm/redux-subspace.svg?style=flat-square)](https://www.npmjs.com/package/redux-subspace)
[![License: BSD-3-Clause](https://img.shields.io/npm/l/redux-subspace.svg?style=flat-square)](/LICENSE.md)

[![All Contributors](https://img.shields.io/badge/all_contributors-21-orange.svg?style=flat-square)](#contributors-)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)

[![Watch on GitHub](https://img.shields.io/github/watchers/ioof-holdings/redux-subspace.svg?style=social)](https://github.com/ioof-holdings/redux-subspace/watchers)
[![Star on GitHub](https://img.shields.io/github/stars/ioof-holdings/redux-subspace.svg?style=social)](https://github.com/ioof-holdings/redux-subspace/stargazers)

This is a library to help build decoupled, componentized [Redux](http://redux.js.org/) apps that share a single global store.

## Installation

```sh
npm install --save redux-subspace react-redux-subspace
```

## Quick Start

```javascript
import React from 'react'
import { createStore, combineReducers } from 'redux'
import { Provider } from 'react-redux'
import { namespaced } from 'redux-subspace'
import { SubspaceProvider } from 'react-redux-subspace'
import { TodoApp, todoReducer } from './todoApp'
import { CounterApp, counterReducer } from './counterApp'

const rootReducer = combineReducers({
todo: todoReducer
counter1: namespaced('counter1')(counterReducer),
counter2: namespaced('counter2')(counterReducer)
})

const store = createStore(rootReducer)

const App = () => (

state.todo}>


state.counter1} namespace="counter1">


state.counter2} namespace="counter2">



)
```

## [Documentation](https://ioof-holdings.github.io/redux-subspace/)

* [Introduction](https://ioof-holdings.github.io/redux-subspace/docs/Introduction.html)
* [Basics](https://ioof-holdings.github.io/redux-subspace/docs/basics/)
* [Advanced](https://ioof-holdings.github.io/redux-subspace/docs/advanced/)
* [Examples](https://ioof-holdings.github.io/redux-subspace/docs/Examples.html)

## Packages

* [`redux-subspace`](https://github.com/ioof-holdings/redux-subspace/tree/master/packages/redux-subspace): The core package for Redux Subspace
* [`react-redux-subspace`](https://github.com/ioof-holdings/redux-subspace/tree/master/packages/react-redux-subspace): React bindings compatible with `react-redux`
* [`redux-subspace-loop`](https://github.com/ioof-holdings/redux-subspace/tree/master/packages/redux-subspace-loop): Utilities for integrating with `redux-loop`
* [`redux-subspace-observable`](https://github.com/ioof-holdings/redux-subspace/tree/master/packages/redux-subspace-observable): Utilities for integrating with `redux-observable`
* [`redux-subspace-saga`](https://github.com/ioof-holdings/redux-subspace/tree/master/packages/redux-subspace-saga): Utilities for integrating with `redux-saga`
* [`redux-subspace-wormhole`](https://github.com/ioof-holdings/redux-subspace/tree/master/packages/redux-subspace-wormhole): Middleware for exposing additional state to subspaces

## Upgrading From Version 1 to Version 2

When upgrading to version 2 of Redux Subspace, refer to the [migration guide](/docs/Migrating.md) to work through all the breaking changes.

## Media

* [Scaling React and Redux at IOOF](http://www.slideshare.net/VivianFarrell/scaling-react-and-redux-at-ioof) - [MelbJS](http://melbjs.com/) (Vivian Farrell, Emily Rosengren)
* [You might Need Redux (And Its Ecosystem)](http://blog.isquaredsoftware.com/2017/09/presentation-might-need-redux-ecosystem/) - [React Boston](http://www.reactboston.com/) (Mark Erikson)
* [From Monolith to Micro-Frontends](https://mpeyper.github.io/from-monolith-to-micro-frontends-wd42/) - [Web Developer 42หš](http://web.dev42.co/) (Michael Peyper)

## Contributors

Thanks goes to these wonderful people ([emojis](https://github.com/kentcdodds/all-contributors#emoji-key)):


Michael Peyper
Michael Peyper

๐Ÿ’ฌ ๐Ÿ› ๐Ÿ’ป ๐Ÿ“– ๐Ÿ’ก ๐Ÿค” ๐Ÿš‡ ๐Ÿ‘€ ๐Ÿ“ฆ ๐Ÿ“ข โš ๏ธ ๐Ÿ”ง
Jonathan Peyper
Jonathan Peyper

๐Ÿ’ฌ ๐Ÿ’ป ๐Ÿค” ๐Ÿ‘€ โš ๏ธ
Vivian Farrell
Vivian Farrell

๐Ÿค” ๐Ÿ“ฆ ๐Ÿ‘€ ๐Ÿ“ข
Emily Rosengren
Emily Rosengren

๐Ÿ“ข
Morgan Larosa
Morgan Larosa

๐Ÿš‡
Amit Kothari
Amit Kothari

๐Ÿ’ป ๐Ÿ’ก
Riku Rouvila
Riku Rouvila

๐Ÿ’ป ๐Ÿ“– โš ๏ธ


Michael
Michael

๐Ÿ’ป
James Adams
James Adams

๐Ÿ“–
Lee Kyles
Lee Kyles

๐Ÿ’ป โš ๏ธ
Evert Bouw
Evert Bouw

๐Ÿ’ป โš ๏ธ ๐Ÿ“– ๐Ÿ’ก
Paweล‚ Brรณd
Paweล‚ Brรณd

๐Ÿ›
majo44
majo44

๐Ÿ› ๐Ÿ’ป โš ๏ธ
Garth Newton
Garth Newton

๐Ÿ› ๐Ÿ“–


Mateusz Burzyล„ski
Mateusz Burzyล„ski

๐Ÿ”ง
psamusev
psamusev

๐Ÿ›
Jay Phelps
Jay Phelps

๐Ÿ‘€
Mark Erikson
Mark Erikson

๐Ÿ“ข
Nikita
Nikita

๐Ÿ› ๐Ÿ’ป โš ๏ธ
Conrad Buck
Conrad Buck

๐Ÿ’ป โš ๏ธ ๐Ÿ“–
travikk
travikk

๐Ÿ‘€

This project follows the [all-contributors](https://github.com/kentcdodds/all-contributors) specification.
Contributions of any kind are welcome!