`js
import { createStore, applyMiddleware, compose } from 'redux';
import { reactAbTest, reactAbTestInitialState, reduxAbTestMiddleware } from 'redux-ab-test';
import { createAction, handleActions } from 'redux-actions';
import { PLAY, WIN } = 'redux-ab-test';

// Create a middleware that listens for plays & wins
const pushToAnalytics = store => next => action => {
const output = next(action);
switch(action.type) {
case PLAY: {
const experiment = action.payload.get('experiment');
const variation = action.payload.get('variation');
window.trackEvent('Experiment Played', { ... })
break;
}
case WIN: {
const experiment = action.payload.get('experiment');
const variation = action.payload.get('variation');
const actionType = action.payload.get('actionType');
const actionPayload = action.payload.get('actionPayload');
window.trackEvent('Experiment Won', { ... })
break;
}
}
return output;
};

const middlewares = [ reduxAbTestMiddleware, pushToAnalytics /, thunk, promise, .../ ];
const finalCreateStore = compose(applyMiddleware.apply(this, middleware))(createStore);
const reducers = { reactAbTest };
export default finalCreateStore(reducers, {});

`

Please ★ on GitHub!

Table of Contents

- Installation
- Alternative Libraries
- Resources for A/B Testing with React
- API Reference
-
-
- Tests
- Running Tests

Installation

redux-ab-test is compatible with React 0.15.x.

`bash
npm install redux-ab-test
`

Alternative Libraries

Experiment container component. Children must be of type Variant.

* Properties:
* name - Name of the experiment.
* Required
* Type: string
* Example: "My Example"
* userIdentifier - Distinct user identifier. When defined, this value is hashed to choose a variant if defaultVariantName or a stored value is not present. Useful for server side rendering.
* Optional
* Type: string
* Example: "7cf61a4521f24507936a8977e1eee2d4"
* defaultVariantName - Name of the default variant. When defined, this value is used to choose a variant if a stored value is not present. This property may be useful for server side rendering but is otherwise not recommended.
* Optional
* Type: string
* Example: "A"

$3

Variant container component.

* Properties:
* name - Name of the variant.
* Required
* Type: string
* Example: "A"

Resources for A/B Testing with React

* Product Experimentation with React and PlanOut on the HubSpot Product Blog
* Roll Your Own A/B Tests With Optimizely and React on the Tilt Engineering Blog
* Simple Sequential A/B Testing
* A/B Testing Rigorously (without losing your job)

Please let us know about React A/B testing resources not included here.

Tests

Mocha tests are performed on the latest version of Node.

Please let me know if a different configuration should be included here.

$3

Locally:

`bash
npm install
npm test
``