Skip to content
Raine Revere edited this page Dec 22, 2019 · 23 revisions

em is a new project so documentation is limited.

  • Glossary - List of terms and definitions.
  • Utility - Guide to common data types and utility functions.

Understanding the Data Model

Although em is rendered as a hierarchy, the basic data structure is a graph rather than a tree. Edges connect thoughts and contexts. The main difference from a tree is that nodes may have multiple parents, or in em terminology, thoughts may appear in many contexts (just as contexts can contain many thoughts).

e.g. The thought with value 'x' appears in contexts ['A', 'B'] and ['C']:

  • A
    • B
      • x
  • C
    • x

Paths are primarily used in relation to the cursor. There are infinitely many paths to a thought, since the context view allows jumping across the hierarchy and circular paths are allowed. Generally paths are converted into contexts to do anything useful.

Given the string value of a thought, you can get a Thought object that contains a list of its contexts using getThought.

Given a context, you can get its thoughts using getThoughts.

See Glossary and Utility for more details.

Schema Versions

The version of the data schema is stored in schemaVersion, allowing for systematic migrations. See SCHEMA_* constants for specific version information.

Mobile Testing

Localhost can be tunneled to a public url for mobile testing purposes using ngrok.

To allow logins, the ngrok domain must be added to Firebase Authorized Domains.

ngrok http 3333
Clone this wiki locally