xpmint

What?

xpmint is a small isomorphic Javascript library for assigning users to A/B tests using a small amount of configuration and zero network requests.

Why?

I didn't want to install a large cumbersome library or have to interact with a third-party remote server just to assign users to experiment groups.

How?

yarn add xpmint
# or
npm install xpmint

and then ...

import Xpmint from 'xpmint'

const xpmint = new Xpmint({
    experiments: {
        test: { // experiment name
            groups: { // experiment groups
                control: 50, // group name
                variant: 50 // followed by proportion
            }
        }
        // ... however many more experiments you want
    }
})

// userId is part of the calculation for which group
// a user will be assigned to
xpmint.setUserId('example-user-id')

// get the group for our current user
const group = xpmint.getExperimentGroup('test')
console.log('user is in group: ' +  group)

// you can also manually assign a user to a group
xpmint.assignExperimentGroup('test', 'variant')
console.assert(xpmint.getExperimentGroup('test') == 'variant')

Who?

theodore brockman