Support redux

[7aos]

This is to bring in redux/react-redux support: https://github.com/paypal/react-engine/issues/168

• Initial state: the data passed via res.render is set to be the initial state
• Store creation: user provide a function through serverconfig or client option to create a store. This function accepts init state and produces store (basically it is a curry function).
• Store binding: react-redux Provider is used to bind the store to the root element, which can be react-router component if react-router is used or a vanilla react component otherwise.

Store initialization at client side Redux store create function initStore is passed to react-engine.client via boot options, which is invoked when wrap root component with react-redux Provider. The root component can be either react-router component or a vanilla react component.

Example

var reducer;
...
client.boot({
  ...
  redux: {
    initStore: function(state) {
      return Redux.createStore(reducer, state);
    }
  }
});

Store initialization at server side Similarly, a create function is needed to initialize the redux store. This function is provided through an optional config. Sample Kraken config

{
  ...
  "view engines": {
    "jsx": {
      "module": "react-engine/lib/server",
      "renderer": {
        "method": "create",
        "arguments": [
          {
            "routes": "require:./.build/routes/index.js",
            "redux": {
              "initStore": "path:./.build/store/init.js"
            }
          }
        ]
      }
    }
  }
 ...
}

[SOSANA]

@samsel @taosbeta any change we could provide a redux example in this repo?

[7aos]

Sure, that is a great idea! I will add an example shortly. Thanks.

[IRT-fbachmann]

Can the function initStore be called asynchronously? Especially interesting for server side rendering and prefetching initial state...