redux-subspace

This is a library to help build decoupled, componentized Redux apps that share a single global store.

Installation

npm install --save redux-subspace react-redux-subspace

Quick Start

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 = () => (
  <Provider store={store}>
    <SubspaceProvider mapState={(state) => state.todo}>
      <TodoApp />
    </SubspaceProvider>
    <SubspaceProvider mapState={(state) => state.counter1} namespace="counter1">
      <CounterApp />
    </SubspaceProvider>
    <SubspaceProvider mapState={(state) => state.counter2} namespace="counter2">
      <CounterApp />
    </SubspaceProvider>
  </Provider>
)

Documentation

Packages

redux-subspace: The core package for Redux Subspace
react-redux-subspace: React bindings compatible with react-redux
redux-subspace-loop: Utilities for integrating with redux-loop
redux-subspace-observable: Utilities for integrating with redux-observable
redux-subspace-saga: Utilities for integrating with redux-saga
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 to work through all the breaking changes.

Media

Scaling React and Redux at IOOF - MelbJS (Vivian Farrell, Emily Rosengren)
You might Need Redux (And Its Ecosystem) - React Boston (Mark Erikson)
From Monolith to Micro-Frontends - Web Developer 42˚ (Michael Peyper)

Contributors

Thanks goes to these wonderful people (emojis):

_{Michael Peyper} 💬 🐛 💻 📖 💡 🤔 🚇 👀 📦 📢 ⚠️ 🔧	_{Jonathan Peyper} 💬 💻 🤔 👀 ⚠️	_{Vivian Farrell} 🤔 📦 👀 📢	_{Emily Rosengren} 📢	_{Morgan Larosa} 🚇	_{Amit Kothari} 💻 💡	_{Riku Rouvila} 💻 📖 ⚠️
_Michael 💻	_{James Adams} 📖	_{Lee Kyles} 💻 ⚠️	_{Evert Bouw} 💻 ⚠️ 📖 💡	_{Paweł Bród} 🐛	_majo44 🐛 💻 ⚠️	_{Garth Newton} 🐛 📖
_{Mateusz Burzyński} 🔧	_psamusev 🐛	_{Jay Phelps} 👀	_{Mark Erikson} 📢	_Nikita 🐛 💻 ⚠️	_{Conrad Buck} 💻 ⚠️ 📖	_travikk 👀