Reasons

Tools to support the collection of and analysis of user reasons, as per http://nxhx.org/maximizing/

Usage

There's a database API, and several React widgets that work with that database.

The database is built on Firebase, and in order to use it you’ll need to have users authenticate into the db, using code like this:

1let FIREBASE = new Firebase('https://lifestyles.firebaseio.com/')
2FIREBASE.authWithOAuthPopup('google').then(YOUR CODE HERE)

The database lets you add reasons, list them, and find completions for a partially typed reason string.

1import Reasons from ‘reasons’
2console.log(Reasons.types())
3let newReasonId = Reasons.add(‘response’, ‘bored’)
4Reasons.commonForActivity(facebookUseActivity).then(console.log)

There are widgets for picking reasons, and collecting reasons and outcomes from users about a chain of activities.

And activity looks like the following:

1let exampleActivity = {
2  blame: 'http://facebook.com',
3  elapsed: 30*60*1000,
4  over: [Date.now()-24*60*60*1000, Date.now()],
5  recognizer: 'indirect',
6
7  favIconUrl: 'https://static.xx.fbcdn.net/rsrc.php/yl/r/H3nktOa7ZMg.ico',
8
9  verbPhrase: ‘browsing links’,
10  examples: ‘A, B, and C’,
11}

An assessment consist of the reported reasons and outcomes for an activity:

1let assessment = {
2      author: userID,
3      assessment: feeling,
4      reasons: [reason.id],
5      time: Date.now(),
6
7      blame: activity.blame,
8      elapsed: activity.elapsed,
9      over: activity.over,
10      recognizer: activity.recognizer,
11      verbPhrase: activity.verbPhrase
12    }

Getting started

npm install

Contributing

• https://groups.google.com/forum/#!forum/reasons-dev