◇ Values Commons

The starter builderTwo files, and nothing to install.

Build an app around one decision

Name a decision, pick two to four values that change it, and add options with a source for every score. The ranking on the right runs on the same engine as the three live apps. When it looks right, download two files and put them in a folder. That is the app.

No source, no score. Each score box stays locked until you write where the number came from.

1

The decision

start here

A coffee example is loaded so you can see the ranking move.

2

The values

two to four that change the answer

For each one, pick which of the ten shared values it stands for. That is how a values file someone made elsewhere carries into your app. If none fits, leave it on "choose". That value then stays home, and the app does not make up a score for it.

3

The options

each score needs its source

Try this: delete one of the co-op's sources. Its score box locks and empties, and the co-op's score falls. Typing the source back does not bring the number back. You have to enter it again.

What the builder does, and what it cannot

What's happening. The form on the left writes a facts file, lens.js, as you type. The panel on the right loads that file into the shared engine and ranks your options by the weights on its sliders. A score only counts once its source box has at least three characters in it.

Why it matters. Most of the work in a values app is finding the facts. This lets a teacher, a co-op buyer or a tenants' group find out whether their decision works as a ranking before anyone writes software.

Devil's advocate. The lock only checks that a source box has something in it. It cannot tell a certification register from "my uncle said", which is also more than three characters. The scores are yours, and nothing here checks them. The downloaded page also fetches the engine from valuescommons.org, so it needs the internet the first time, or a copy of engine.js beside it.

Rabbit hole. Read Where to Message's lens.js to see a finished one, then the build guide for everything past a first draft.