Forming reliable memories.
Switch branches/tags
Nothing to show
Clone or download


Deploy (see below)

Chronicle allows you to form reliable memories. It keeps track of a tree of memories that are, ultimately, linked to the factual records recorded at the very moment they happened.

STATUS OF PROJECT: The project has been put on hold since June 2015 however it could be revived. You could add entries, but there is no 'fold' feature yet. If you are interested in the project, file a Github issue!

Why do this?

Humans are adept at denialism. The author therefore presumes that only a data-centric approach can be effective at improving human well-being and productivity.

Over a period of data collection, one can't help but gain insights into what actually causes — as opposed to what one remembers or is taught to be causing — one's happiness and unhappiness.

Chronicle explained in detail

The basic idea is to keep track of a tree of memories. Accumulation of data occurs at the level of leaf nodes (individual moments), from which we "fold" the memories up to summarize at the ancestries. Specifically, we fold all moments of the day to summarize for that day, and then fold all days to summarize for that week, then month, year and so on.

All level of summarizations are ultimately linked to the specific moments (thus forming a tree) that can be consulted at any time. We thus create reliable "memories" that are recorded at individual moments (the very moment they happened) without the bias of faulty recall.

There is also the notion of "story" (yet to be implemented) which some moments can belong to. A story is thus linked to the individual moments, and can be consulted when "telling" (to oneself or others) the story later on, and with little bias.

How is the data represented?

Chronicle stores all of its data in PostgreSQL. There are 4 concepts (tables):


This is what the user records (nothing else); it represents how things were going at that very moment (only) involving no recall or reverie.


This, as the word indicates, is a string of moments forming a "story" to be recalled (or re-told) later. Examples:

  • Work
  • Work at $company
  • India trip 2015
  • Chronicle development

Each moment can belong to at most one story. Some stories, like "India trip 2015", are smart stories in that they are specified using time ranges (thus moments can't explicitly belong to them).


These are analogous to the colored shapes in my blackboard (cf. Seinfeld productivity hack). The idea is to have basic (SVG?) shapes defined somewhere – in Elm, or database — and let the user specify a list of them to be rendered ultimately in the calendar view. Fields:

  • Shapes: list of shapes
  • Value: numeric value of this mark (used for aggregating in outter folds)


Each day, week, month, year are summarized as folds. Stories may have their own folds (eg: work fold). Fields:

  • Summary
  • Time range
  • Marks (list of marks, as described above).

The calendar view of folds will be showing these marks (usually just the default one), thus emulating what we have in the blackboard. The user can define custom marks in the Marks table and refer to them in the folds.

Fold can also enable habit tracking (eg: contemplate XYZ every day; with value=0 or 1, accumulating over week/month/etc).


  • spas (via PostgREST) - automatic REST API for PostgreSQL
  • Elm - client-side language using FRP
  • Bootstrap - HTML/CSS framework

Future use


Please note that chronicle is not yet ready for public use.

As the first step, prepare a local postgresql database:

echo "CREATE database chronicle;" | psql
psql -d chronicle < schema.sql
# Optionally load production dump from Heroku (see below) as:
pg_restore -d chronicle -a -t moments latest.dump


make run  # requires spas cloned and compiled in parent repo
make compile # rebuild Elm sources whenever they change

Database notes

Full schema available in schema.sql. Use \d+ 1.moments to inspect the view.

Use ALTER ROLE <username> SET timezone = 'America/Vancouver'; to set database timezone. This however doesn't automatically change the day end marker from 12am to something custom (like 3am).

To retrieve schema from Heroku Postgres:

heroku pg:backups capture
curl -o latest.dump `heroku pg:backups public-url -a <appname>`

pg_restore --verbose --clean --no-acl --no-owner -h localhost -U srid -d chronicle latest.dump
rm latest.dump
pg_dump -s chronicle > schema.sql
vim schema.sql  # remove odd looking definitions

Elm package ideas

Some new packages I can create by extracing code from this repo:

  • Date formatter
  • Time ago (eg.: 23 secs ago)
  • Search query parser (see src/Search.elm)
  • Bootstrap.elm (maybe use this?)

Deploying to Heroku

  1. Deploy the app using the Heroku button at the top of this README.
  2. Create the database schema using heroku pg:psql --app $APPNAME < schema.sql
  3. Note down the basic auth credentials by inspecting the app environment (eg: heroku config | grep SPAS)
  4. Access the app at the URL: https://${APPNAME} (note the "index.html" suffix that is required).